GET-Anfragen

Warum brauchen wir GET blocks, und wie funktionieren sie?

Wenn Sie ein Frontend entwickeln, müssen Sie zwangsläufig verschiedene BPs auf dem Backend ausführen. Um einen BP auszuführen, müssen Sie seinen Endpunkt aufrufen. Zu diesem Zweck erstellt AppMaster für jeden Endpunkt einen Server-Anforderungsblock. Diese Blöcke haben die gleichen Eingabe- und Ausgabefelder wie der zugehörige Endpunkt und dienen als Möglichkeit, ihn zu starten.

GET-Blöcke müssen nach den Prinzipien der REST-API Daten abrufen. Am häufigsten rufen GET-Blöcke Daten aus dem Modell in der Datenbank ab (alle oder nach bestimmten Kriterien).

Wie alle Server-Anforderungsblöcke ist jeder GET-Block an seinen eigenen Endpunkt gebunden. Die Url des Endpunkts wird im Namen des Blocks angezeigt.

Beachten Sie, dass AppMaster grundlegende Endpunkte automatisch generiert. Sie können aber auch eigene BPs und Endpunkte für diese und damit Ihre Server Request-Blöcke erstellen.

Eingabe- und Ausgabefelder des GET block

Eingabe

• Endpoint ID - bestimmt, auf welchen Endpunkt der Block zugreifen soll. Dieses Feld wird automatisch gesetzt;
• _offset - ermöglicht die Angabe, aus welchem Datensatz der Block Informationen erhalten soll; Ganzzahlformat;
• _limit - die Anzahl der Datensätze, die der Block lädt. Der Standardwert ist 25, der Höchstwert ist 500; Integer-Format;
• _sort_order - Zwei Werte sind für dieses Feld geeignet: asc - direkte Sortierung und desc - umgekehrte Sortierung; String-Format;
• _sort_by - legt fest, nach welchem Feld des Datenmodells die Liste sortiert werden soll; String-Format;
• Ids - Liste der Datensatz-IDs. Ermöglicht das Abrufen von Datensätzen nach einer bestimmten ID; Array-Integer-Format;
• _search - Suche nach einem bestimmten Wert im Datenmodell; String-Format;
• _search_exact - aktiviert/deaktiviert die Suche nach exakten Übereinstimmungen; boolesches Format;
• _ search_in - Suche nach bestimmten Feldern; Array String-Format.

Schauen wir uns die mit der Suche verbundenen Felder genauer an.

_search - sucht nach Übereinstimmungen im gesamten Datenmodell und findet sie unabhängig von dem Feld, in dem sich der Wert befindet.

Setzen wir zum Beispiel das Feld _search auf John. Wenn im Datenmodell für einen Datensatz der Wert des Namensfeldes John lautet und für den anderen der Wert des E-Mail-Feldes [email protected], dann wird die Suche beide Datensätze finden.

_search_exact - Die Aktivierung dieses Feldes bedeutet, dass die Ergebnisse Datensätze enthalten, die vollständig mit der Abfrage übereinstimmen.

_search_in - Hier können Sie die Felder festlegen, in denen die Suche durchgeführt werden soll. Wenn wir zum Beispiel nur nach Namen suchen wollen und Fälle, in denen der Name ein Teil der E-Mail ist, nicht berücksichtigen wollen, können wir _search_in verwenden und nur nach dem Namensfeld suchen.

Felder des Suchdatenmodells

Diese Felder werden für die Suche über das Datenmodell verwendet. Der Hauptunterschied zwischen ihnen und den Suchfeldern besteht darin, dass sie verschiedene Werte annehmen können, im Gegensatz zur Suche, die nur das String-Format akzeptiert.

Ausgabe

• _success - Suchergebnisse; boolesches Format;
• _httpcode - Anfrage-Antwort-Code; Ganzzahlformat;
• _error - Fehlertext; String-Format;
• Data - empfangene Datensätze; Array Modellformat;
• Count - die Anzahl der erhaltenen Einträge; Integer-Format.

Das Feld _with Feld

Sie erscheint in den Blöcken, in denen die Anfrage an verwandte Datenmodelle geht. Sie ermöglicht es Ihnen, Daten aus dem Datenmodell, an das die Anfrage gerichtet ist, und aus den mit ihm verbundenen Datenmodellen zu erhalten.

Schauen wir uns das _with anhand einer Beispielanwendung, die eine Liste von Büchern und deren Kategorien speichert.

Erstellen Sie zwei Datenmodelle: book und category. In der book fügen wir das Feld book_name Feld hinzu, und in der category fügen wir das Feld category_name Feld hinzu.

Erstellen Sie eine Verbindung zwischen ihnen. Ziehen wir sie von Kategorie zu Buch und setzen wir den Beziehungstyp auf has_many da sich eine Kategorie auf verschiedene Bücher beziehen kann.

Richten Sie auf der Registerkarte Webanwendung das Laden von Daten in die Buch- und Kategorietabellen ein und fügen Sie Datensätze zu diesen Tabellen hinzu. Verknüpfte Daten werden derzeit nicht in Tabellen angezeigt. Um dies zu beheben, wird das _with Feld benötigt.

Richten Sie dieses Feld in der Registerkarte Get block für jede Tabelle.

Öffnen wir nun unsere Anwendung und vergewissern wir uns, dass die Abfrage ausgeführt wird und die richtigen Daten in der Tabelle erscheinen.