Queries aufbauen und ausführen

Das Modul cds.ql stellt ein SQL-ähnliches API zum Erstellen solcher Datenbankabfragen bereit. Die für unser Szenario erforderlichen Querys sind in der folgenden Abbildung dargestellt.

Die API wird über die globalen Objekte SELECT, INSERT, UPSERT, UPDATE und DELETE zur Verfügung gestellt.

12
const cds = require('@sap/cds');
const { SELECT, INSERT, UPSERT, UPDATE, DELETE } = cds.ql;

Das über die aufgelisteten CRUD-Objekte verfügbare API ist als fließendes API konzipiert. Das bedeutet, dass die Methoden, die für diese Objekte verfügbar sind, Objekte desselben Typs zurückgeben. Verfügbare Eigenschaften, wie z.B. die Eigenschaft .one des im gezeigten Beispiel verwendeten SELECT-Objekts, haben auch Objekte desselben Typs wie ihr Wert. Dies ermöglicht eine Verkettung, wodurch die Kodierung intuitiv und lesbar wird.

Um die Datenbanktabelle zu identifizieren, auf die zugegriffen werden soll, verwenden wir die CSN-Definition der Entität Bücher im gezeigten Beispiel. Dies ist der empfohlene Ansatz.

Alternativ zu den oben gezeigten klassischen Methodenaufrufen kann das fließende API auch mit getaggten Vorlagen verwendet werden. Die folgende Abbildung zeigt, wie die oben mit klassischen Methodenaufrufen konstruierten Queries mit getaggten Vorlagen angelegt werden können. Das Ergebnis ist in beiden Fällen gleich.

Im vorherigen Abschnitt wurde erläutert, wie Query-Objekte angelegt werden. Die konstruierten Queries werden jedoch nicht automatisch ausgeführt. Sie müssen noch explizit zur Ausführung an die Datenbank gesendet werden. Wir werden nun untersuchen, wie dies erreicht wird.

Im Folgenden wird untersucht, wie Abfragen auf der Datenbank ausgeführt werden können. Dabei spielt es keine Rolle, ob die Query-Objekte über klassische Methodenaufrufe oder über getaggte Templates angelegt wurden. In den folgenden Beispielen verwenden wir klassische Methodenaufrufe für den Query-Aufbau.

Queries werden auf der Datenbank ausgeführt, indem sie an die Methode cds.db.run() übergeben werden (siehe folgende Abbildung). Dies gilt nicht nur für SELECT-Abfragen, wie im Beispiel gezeigt, sondern auch für das Schreiben von Datenbankabfragen wie einem UPDATE.

Im Beispiel wird der Operator await verwendet, um auf das Ergebnis der Abfrage SELECT.one zu warten. Dieses Ergebnis wird der Konstante b zugeordnet. Zur Laufzeit ist die Konstante also ein Objekt mit einer Eigenschaft namens stock. Der Wert dieser Eigenschaft ist der in der Datenbank für das Buch ausgewählte Bestand, der mit der Methode where() angegeben wurde. Wenn eine Dokumentenmappe mit der angegebenen ID nicht in der Datenbanktabelle gefunden werden kann, erhält die Konstante b den Wert undefined.

Alternativ zum obigen Ansatz können Sie auch einfach eine konstruierte Query await . Dadurch wird die Abfrage standardmäßig an die Methode cds.db.run() übergeben. Das bedeutet, dass das folgende und das vorherige Beispiel in Bezug auf die SELECT-Abfrage äquivalent sind:

Das Beispiel zeigt auch, wie die Aktualisierung auf der Datenbank ausgeführt wird.

Nach dem Update wird ein Objekt entsprechend der Antwortart der submitOrder Aktion an den Aufrufer zurückgegeben. Dieses Objekt hat einen Grundstücksbestand, dessen Wert der aktualisierte Bestand für das bestellte Buch ist.

Im Übungsteil dieser Lektion finden Sie die vollständige Implementierung für die Methode redueStock(). In dieser Implementierung wird eine Fehlermeldung ausgegeben, wenn die übergebene Buch-ID nicht in der Datenbank vorhanden ist (d.h. wenn die Konstante b den Wert undefinedhat). Eine Fehlermeldung wird auch ausgegeben, wenn der Bestand des Buchs kleiner als die bestellte Menge ist.

Sehen Sie sich das Video an, um zu erfahren, wie Sie Abfragen in der Implementierung von CAP-Services verwenden.