Tại sao chúng ta cần GET blocks và chúng hoạt động như thế nào?
Khi bạn phát triển giao diện người dùng, chắc chắn bạn sẽ cần chạy các BP khác nhau trên phần phụ trợ. Để chạy một BP, bạn cần gọi điểm cuối của nó. Để thực hiện việc này, AppMaster tạo khối Yêu cầu máy chủ cho mỗi điểm cuối . Các khối này có các trường đầu vào và đầu ra giống như điểm cuối được liên kết và phục vụ như một cách để bắt đầu nó.
Các khối GET , theo nguyên tắc của API REST , phải truy xuất một số dữ liệu. Thông thường, các khối GET lấy dữ liệu từ mô hình trong cơ sở dữ liệu (tất cả hoặc theo tiêu chí nhất định).
Giống như tất cả các khối Yêu cầu máy chủ , mỗi khối GET được liên kết với điểm cuối của chính nó. Url của điểm cuối được hiển thị trong tên của các khối.
Hãy nhớ rằng AppMaster tự động tạo các điểm cuối cơ bản. Nhưng bạn cũng có thể tạo các BP và điểm cuối cho chúng và do đó, các khối Yêu cầu máy chủ của bạn.
Các trường đầu vào và đầu ra của GET block
Đầu vào
- Endpoint ID điểm cuối – xác định điểm cuối nào mà khối sẽ truy cập. Trường này được đặt tự động;
- _offset – cho phép chỉ định khối sẽ nhận thông tin từ bản ghi nào; định dạng số nguyên;
- _limit – số lượng bản ghi mà khối tải. Mặc định là 25, tối đa tại một thời điểm là 500; định dạng số nguyên;
- _sort_order – hai giá trị phù hợp với trường này: asc – thứ tự sắp xếp trực tiếp và desc – thứ tự đảo ngược; định dạng chuỗi;
- _sort_by – xác định danh sách sẽ được sắp xếp theo trường nào của mô hình dữ liệu; định dạng chuỗi;
- Ids – danh sách id bản ghi. Cho phép lấy bản ghi theo id cụ thể; định dạng mảng số nguyên;
- _search – tìm kiếm một giá trị nhất định trong mô hình dữ liệu; định dạng chuỗi;
- _search_exact – bật/tắt tìm kiếm đối sánh chính xác; định dạng boolean;
- _ search_in – tìm kiếm theo các trường cụ thể; định dạng chuỗi mảng.
Chúng ta hãy xem xét kỹ hơn các trường liên quan đến tìm kiếm.
_search – tìm kiếm các kết quả trùng khớp trong toàn bộ mô hình dữ liệu và sẽ tìm thấy chúng bất kể trường chứa giá trị.
Ví dụ: hãy đặt trường _search thành John. Nếu trong mô hình dữ liệu, đối với một bản ghi, giá trị của trường tên là John và đối với bản ghi kia, giá trị của trường email là [email protected], thì tìm kiếm sẽ tìm thấy cả hai bản ghi này.
_search_exact – bật trường này có nghĩa là kết quả sẽ bao gồm các bản ghi hoàn toàn khớp với truy vấn.
Lời yêu cầu | _search_exact | Kết quả |
John | False | John, Johny, [email protected] |
John | True | John |
_search_in – tại đây, bạn có thể đặt các trường để thực hiện tìm kiếm. Ví dụ: nếu chúng tôi chỉ muốn tìm kiếm theo tên và không xem xét các trường hợp khi tên là một phần của email, chúng tôi có thể sử dụng _search_in và chỉ tìm kiếm theo trường tên.
Tìm kiếm các trường mô hình dữ liệu
Các trường này được sử dụng để tìm kiếm theo mô hình dữ liệu. Sự khác biệt chính giữa chúng và các trường tìm kiếm là chúng có thể nhận các giá trị khác nhau, không giống như tìm kiếm, chỉ chấp nhận định dạng chuỗi.
đầu ra
- _success – kết quả tìm kiếm; định dạng boolean;
- _httpcode – mã phản hồi yêu cầu; định dạng số nguyên;
- _error – văn bản lỗi; định dạng chuỗi;
- Data – hồ sơ nhận được; định dạng mô hình mảng;
- Count – số lượng mục nhận được; định dạng số nguyên.
Trường _with
Nó xuất hiện trong các khối mà yêu cầu chuyển đến các mô hình dữ liệu liên quan. Nó cho phép bạn lấy dữ liệu từ mô hình dữ liệu mà yêu cầu được đưa ra và từ các mô hình dữ liệu được liên kết với nó.
Hãy xem trường _with bằng một ứng dụng ví dụ lưu trữ danh sách sách và danh mục của chúng.
Tạo hai mô hình dữ liệu: book và category . Trong book , chúng tôi thêm trường tên sách và trong category , chúng tôi thêm trường book_name category_name .
Tạo kết nối giữa chúng. Hãy vẽ nó từ danh mục này sang sách khác và đặt loại quan hệ thành has_many vì một danh mục có thể tham chiếu đến các cuốn sách khác nhau.
Trong tab ứng dụng web, hãy thiết lập tải dữ liệu vào bảng sách và danh mục, đồng thời thêm bản ghi vào các bảng này. Dữ liệu được liên kết hiện không được hiển thị trong bảng. Để khắc phục điều này, cần có trường _with .
Thiết lập trường này trong Get block cho mỗi bảng.
Bây giờ, hãy mở ứng dụng của chúng ta và đảm bảo rằng truy vấn đang chạy và dữ liệu phù hợp xuất hiện trong bảng.
