Wzorce z książki kucharskiej serwera proxy API

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

W tym temacie omawiamy niektóre wzorce programowania serwera proxy interfejsu API, które są prezentowane w przykładach w książce kucharskiej Apigee Edge. W miarę dodawania kolejnych przykładowych książek kucharskich planujemy dodawać do tego tematu więcej wzorów.

Wzór klienta HTTP w JavaScript

Wzór klienta HTTP JavaScript jest jednym z kilku wzorów, których możesz używać do tworzenia mashupów po stronie serwera za pomocą Apigee Edge. Model obiektu JavaScriptu Apigee umożliwia bezpośrednie podłączenie kodu JavaScriptu do przepływu proxy interfejsu API. Obiekt httpClient obiektu modelu umożliwia wywoływanie usług backendowych i pobieranie wyników za pomocą JavaScriptu.

Wzór kompozycji zasad

Składanie zasad to wzór serwera proxy interfejsu API Apigee, który umożliwia łączenie wyników z wielu celów w tytule backendu w jedną odpowiedź za pomocą zasad. Dzięki temu możesz tworzyć mash-up za pomocą zasad.

Podstawą wzoru składania zasad jest zasada ServiceCallout. Zasada ServiceCallout działa jako klient HTTP dla interfejsu API lub usługi backendu. Aby jednak działać w pełni, ServiceCallout musi korzystać z innych zasad, które umożliwiają skuteczną interakcję z usługą lub interfejsem API zdalnym. Inne zasady służą do generowania komunikatu żądania wysyłanego przez ServiceCallout oraz do analizowania treści komunikatu odpowiedzi z zewnętrznego interfejsu API lub usługi.

Przykład zasad kompozycji w formie książki kucharskiej wykorzystuje 3 zasady: AssignMessage, ServiceCalloutExtractVariables. Te zasady zawierają żądania, które chcesz wysłać do backendu, klienta, który kieruje je do backendu, oraz parsowanie wiadomości, które analizuje odpowiedzi z każdego interfejsu API i przypisuje zmienne do danych odpowiedzi. Po wykonaniu wszystkich wywołań zebrane zmienne są łączone i zwracane w jednym obiekcie JSON.

Oto krótkie podsumowanie tych 3 zasad:

  • AssignMessage: tworzy wiadomość żądania, wypełnia nagłówki HTTP i parametry zapytania, ustawia czasownik HTTP.
  • ServiceCallout: odwołuje się do wiadomości utworzonej przez zasadę AssignMessage, definiuje docelowy adres URL wywołania zewnętrznego i definiuje nazwę obiektu odpowiedzi zwracanego przez usługę docelową.
  • ExtractVariables: zazwyczaj definiuje wyrażenie JSONPath lub XPath, które analizuje wiadomość wygenerowaną przez poprzednią zasadę ServiceCallout. Następnie zasada ustawia zmienne zawierające wartości zanalizowane z odpowiedzi wywołania usługi.

Pełny przykład ilustrujący wzór składania zasad znajdziesz w artykule Używanie składania zasad.