Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
W tym temacie omawiamy niektóre wzorce programowania serwerów proxy interfejsu API pokazane w przykładach książek kucharskich Apigee Edge. W miarę dodawania kolejnych próbek książek kucharskich będziemy dodawać kolejne wzorce w tym temacie.
Wzorzec klienta HTTP JavaScript
Wzorzec klienta HTTP JavaScript jest jednym z kilku wzorców, których możesz używać do tworzenia mashupów po stronie serwera w Apigee Edge. Obiektowy model JavaScript Apigee pozwala podłączyć kod JavaScript bezpośrednio do przepływu serwera proxy interfejsu API. Obiekt httpClient modelu obiektu umożliwia wykonywanie wywołań usług backendu i pobieranie wyników za pomocą JavaScriptu.
Wzorzec struktury zasad
Kompozycja zasad to wzorzec serwera proxy Apigee API, który umożliwia łączenie wyników z wielu celów backendu w jedną odpowiedź przy użyciu zasad. W rezultacie kompozycja zasad umożliwia tworzenie mashupów za pomocą zasad.
Podstawą wzorca struktury zasad jest zasada ServiceCallout. Zasada ServiceCallout działa jako klient HTTP dla interfejsu API lub usługi backendu. Aby jednak w pełni działać, wywołanie Service objaśnienie opiera się na innych zasadach umożliwiających istotne interakcje ze zdalnym interfejsem API lub usługą. Inne zasady służą do generowania komunikatu żądania wysyłanego przez wywołanie ServiceCallout oraz do analizowania treści wiadomości z odpowiedzią ze zdalnego interfejsu API lub usługi.
Przykład książki kucharskiej służącej do tworzenia zasad korzysta z 3 zasad: AssignMessage, ServiceCallout i ExtractVariables. Obejmują one komunikaty żądania, które chcesz wysłać do backendu, klienta przekierowującego wiadomość do backendu oraz paralizator wiadomości, który 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 pojedynczym obiekcie JSON.
Oto krótkie podsumowanie tych trzech zasad:
- AssignMessage: tworzy wiadomość żądania, wypełnia nagłówki HTTP i parametry zapytania oraz ustawia czasownik HTTP.
- ServiceCallout: odwołuje się do wiadomości utworzonej przez zasadę AssignMessage, określa docelowy adres URL wywołania zewnętrznego i określa nazwę obiektu odpowiedzi zwracanego przez usługę docelową.
- ExtractVariables zwykle definiuje wyrażenie JSONPath lub XPath, które analizuje komunikat wygenerowany przez poprzednią zasadę ServiceCallout. Zasada ustawia zmienne zawierające wartości uzyskane z odpowiedzi ServiceCallout.
Pełen przykład przedstawiający wzorzec struktury zasad znajdziesz w sekcji Używanie kompozycji zasad.