Création et exécution de requêtes

Le module cds.ql fournit une API de type SQL pour construire de telles requêtes de base de données. Les requêtes requises pour notre scénario sont présentées dans la figure suivante.

L'API est mise à disposition via les objets globaux SELECT, INSERT, UPSERT, UPDATE et DELETE.

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

L'API disponible via les objets CLAS répertoriés est conçue comme une API fluide. Cela signifie que les méthodes disponibles sur ces objets renvoient des objets du même type. Les propriétés disponibles - telles que la propriété .one de l'objet SELECT utilisé dans l'exemple présenté - ont également des objets du même type que leur valeur. Cela permet le chaînage, ce qui rend le codage intuitif et lisible.

Pour identifier la table de base de données à laquelle accéder, nous utilisons la définition CSN de l'entité Pages dans l'exemple présenté. Il s'agit de l'approche recommandée.

Comme alternative aux appels de méthode classiques indiqués ci-dessus, l'API courante peut également être utilisée avec des modèles balisés. La figure suivante montre comment les requêtes créées ci-dessus à l'aide d'appels de méthode classiques peuvent être créées à l'aide de modèles marqués. Le résultat est le même dans les deux cas.

Dans la section précédente, nous avons expliqué comment les objets de requête sont créés. Cependant, les requêtes créées ne sont pas exécutées automatiquement. Ils doivent encore être explicitement envoyés à la base de données pour exécution. Nous allons maintenant examiner comment cela est réalisé.

Dans ce qui suit, nous allons examiner comment les requêtes peuvent être exécutées dans la base de données. Dans ce contexte, peu importe que les objets de requête aient été créés via des appels de méthode classiques ou via des modèles marqués. Dans les exemples suivants, nous allons utiliser des appels de méthode classiques pour la construction de requêtes.

Les requêtes sont exécutées dans la base de données en les transmettant à la méthode cds.db.run() (voir figure suivante). Cela s'applique non seulement aux requêtes SELECT, comme illustré dans l'exemple, mais également à l'écriture de requêtes de base de données telles qu'une mise à jour.

Dans l'exemple, l'opérateur await est utilisé pour attendre le résultat de la requête SELECT.one. Ce résultat est affecté à la constante b. Au moment de l'exécution, la constante est donc un objet avec une propriété appelée stock. La valeur de cette propriété est le stock sélectionné dans la base de données pour le livre qui a été spécifié à l'aide de la méthode where() . Si un dossier avec l'ID indiqué est introuvable dans la table de base de données, la constante b reçoit la valeur undefined.

Comme alternative à l'approche ci-dessus, vous pouvez également simplement await une requête créée. La requête est alors transmise par défaut à la méthode cds.db.run() . Cela signifie que l'exemple suivant et l'exemple précédent sont équivalents en ce qui concerne la requête SELECT :

L'exemple montre également comment la mise à jour est exécutée dans la base de données.

Suite à la mise à jour, un objet est retourné à l'appelant conformément au type de réponse de l'action submitOrder. Cet objet a un stock de propriété dont la valeur est le stock mis à jour pour le livre commandé.

Dans la partie d'exercice de ce sujet, vous trouverez l'implémentation complète de la méthode Réduction du stock(). Dans cette implémentation, un message d'erreur est émis si l'ID de dossier transféré n'existe pas dans la base de données (c'est-à-dire si la constante b a la valeur undefined). Un message d'erreur est également édité si le stock du livre est inférieur à la quantité commandée.

Regardez la vidéo pour voir comment utiliser des requêtes dans l'implémentation des services CAP.