Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Cette rubrique présente certains des modèles de développement de proxys d'API présentés dans les exemples du livre de recettes Apigee Edge. À mesure que nous ajouterons d'autres exemples de livres de recettes, nous prévoyons d'ajouter d'autres modèles à ce sujet.
Le modèle de client HTTP JavaScript
Le modèle de client HTTP JavaScript fait partie des modèles que vous pouvez utiliser pour créer des applications composites côté serveur avec Apigee Edge. Le modèle d'objet JavaScript d'Apigee vous permet de connecter du code JavaScript directement à un flux de proxy d'API. L'objet httpClient du modèle d'objet vous permet d'appeler les services de backend et de récupérer les résultats à l'aide de JavaScript.
Le schéma de composition des règles
La composition de règles est un modèle de proxy d'API Apigee qui vous permet de combiner les résultats de plusieurs cibles principales en une seule réponse à l'aide de règles. Dans les faits, la composition des règles vous permet de créer des applications composites à l'aide de règles.
La règle ServiceCallout est au cœur de ce modèle de composition. La règle ServiceCallout agit en tant que client HTTP vers l'API ou le service backend. Toutefois, pour être entièrement fonctionnel, un ServiceCallout s'appuie sur d'autres règles afin de permettre une interaction pertinente avec une API ou un service distant. D'autres règles sont utilisées pour générer le message de requête envoyé par ServiceCallout et pour analyser le contenu du message de réponse de l'API ou du service distant.
L'exemple de livre de recettes sur la composition de règles utilise trois règles: AssignMessage, ServiceCallout et ExtractVariables. Ces stratégies encapsulent le ou les messages de requête que vous souhaitez envoyer au backend, le client qui achemine le message vers le backend, ainsi qu'un analyseur de messages qui analyse la réponse de chaque API et attribue des variables aux données de réponse. Une fois tous les appels effectués, les variables collectées sont combinées et renvoyées dans un seul objet JSON.
Voici un bref récapitulatif de ces trois règles:
- AssignMessage: crée un message de requête, renseigne les en-têtes HTTP et les paramètres de requête, et définit le verbe HTTP.
- ServiceCallout: référence un message créé par la règleAssignMessage, définit une URL cible pour l'appel externe et définit un nom pour l'objet de réponse renvoyé par le service cible.
- ExtractVariables: définit généralement une expression JSONPath ou XPath qui analyse le message généré par la règle ServiceCallout précédente. La stratégie définit ensuite des variables contenant les valeurs analysées à partir de la réponse ServiceAppel.
Pour obtenir un exemple complet illustrant le schéma de composition de règles, consultez la section Utiliser la composition de règles.