DAPATKAN permintaan

Mengapa kita membutuhkan GET blocks , dan bagaimana cara kerjanya?

Saat Anda mengembangkan frontend, Anda pasti perlu menjalankan BP yang berbeda di backend. Untuk menjalankan BP, Anda perlu memanggil titik akhirnya. Untuk melakukan ini, AppMaster membuat blok Permintaan Server untuk setiap titik akhir . Blok ini memiliki bidang input dan output yang sama dengan titik akhir terkait dan berfungsi sebagai cara untuk memulainya.

Blok GET , menurut prinsip REST API , harus mengambil beberapa data. Paling sering, blok GET mengambil data dari model dalam database (semua, atau dengan kriteria tertentu).

Seperti semua blok Permintaan Server , setiap blok GET terikat pada titik akhirnya sendiri. Url titik akhir ditampilkan atas nama blok.

Perlu diingat bahwa AppMaster menghasilkan titik akhir dasar secara otomatis. Tetapi Anda juga dapat membuat BP dan titik akhir untuk mereka, dan akibatnya Permintaan Server Anda diblokir.

Bidang input dan output dari GET block

Memasukkan

• Endpoint ID – menentukan titik akhir mana yang harus diakses oleh blok. Bidang ini diatur secara otomatis;
• _offset – memungkinkan untuk menentukan dari catatan mana blok akan menerima informasi; format bilangan bulat;
• _limit – jumlah record yang dimuat blok. Standarnya adalah 25, maksimum pada suatu waktu adalah 500; format bilangan bulat;
• _sort_order – dua nilai cocok untuk bidang ini: asc – urutan sortir langsung dan desc – urutan terbalik; format string;
• _sort_by – menentukan bidang mana dari model data daftar akan diurutkan; format string;
• Ids – daftar id record. Memungkinkan untuk mendapatkan catatan dengan id tertentu; format bilangan bulat array;
• _search – mencari nilai tertentu dalam model data; format string;
• _search_exact – mengaktifkan/menonaktifkan pencarian pencocokan tepat; format boolean;
• _ search_in – mencari berdasarkan bidang tertentu; format string array.

Mari kita lihat lebih dekat bidang yang terkait dengan pencarian.

_search – mencari kecocokan di seluruh model data dan akan menemukannya terlepas dari bidang tempat nilai berada.

Misalnya, mari setel bidang _search ke John. Jika dalam model data, untuk satu record, nilai field nama adalah John, dan untuk yang lainnya, nilai field email adalah [email protected], maka pencarian akan menemukan kedua record tersebut.

_search_exact – mengaktifkan bidang ini berarti hasil akan menyertakan catatan yang benar-benar cocok dengan kueri.

_search_in – di sini, Anda dapat mengatur bidang di mana pencarian harus dilakukan. Misalnya, jika kita ingin mencari hanya berdasarkan nama dan tidak mempertimbangkan kasus ketika nama adalah bagian dari email, kita dapat menggunakan _search_in dan mencari hanya dengan bidang nama.

Cari bidang model data

Bidang-bidang ini digunakan untuk mencari berdasarkan model data. Perbedaan utama antara mereka dan bidang pencarian adalah bahwa mereka dapat mengambil nilai yang berbeda, tidak seperti pencarian, yang hanya menerima format string.

Keluaran

• _success – hasil pencarian; format boolean;
• _httpcode – meminta kode tanggapan; format bilangan bulat;
• _error – teks kesalahan; format string;
• Data – catatan yang diterima; format model larik;
• Count – jumlah entri yang diterima; format bilangan bulat.

Bidang _with

Itu muncul di blok-blok tempat permintaan masuk ke model data terkait. Ini memungkinkan Anda untuk mendapatkan data dari model data tempat permintaan dibuat dan dari model data yang terkait dengannya.

Mari kita lihat bidang _with menggunakan contoh aplikasi yang menyimpan daftar buku dan kategorinya.

Buat dua model data: book dan category . Di book kami menambahkan bidang book_name , dan dalam category kami menambahkan bidang category_name .

Buat koneksi di antara mereka. Mari kita gambarkan dari kategori ke buku dan atur jenis relasinya ke has_many karena satu kategori dapat merujuk ke buku yang berbeda.

Di bawah tab aplikasi web, atur pemuatan data ke dalam tabel buku dan kategori dan tambahkan catatan ke tabel ini. Data tertaut saat ini tidak ditampilkan dalam tabel. Untuk memperbaikinya, bidang _with diperlukan.

Siapkan bidang ini di Get block untuk setiap tabel.

Sekarang mari kita buka aplikasi kita dan pastikan kueri berjalan dan data yang benar muncul di tabel.