Tworzenie i przekształcanie wiadomości oraz uzyskiwanie do nich dostępu

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Za pomocą zasad dołączonej do Apigee Edge możesz manipulować wiadomościami przechodzącymi przez Twoje Serwery proxy interfejsów API. Dzięki zasadom możesz:

  • Konwertuj wiadomości w różnych formatach, na przykład z XML na JSON.
  • Możesz ustawiać wartości zmiennych na podstawie treści wiadomości i tworzyć komunikaty na podstawie wartości zmiennych.
  • Używaj kodu procedurowego, takiego jak JavaScript, Java i Python, do obsługi wiadomości i danych w bardziej złożone.

Ogólnie podczas korzystania z tych zasad dane wejściowe i wyjściowe określa się jako zmienne przepływu. Na w czasie wykonywania, Apigee Edge pobiera wartość wejściową ze zmiennej źródłowej i zapisuje dane wyjściowe na zmienną wyjściową.

W tym temacie omawiamy te funkcje. Pełne i techniczne informacje znajdziesz w odniesień do zasad.

Prosta obsługa plików XML i JSON

Apigee Edge zawiera zasady ułatwiające konwersję między formatami XML i JSON oraz należy przekształcać kod XML za pomocą formatu XSL.

Konwertuję plik JSON na XML

Zasada JSON na XML pobiera dane wejściowe JSON i konwertuje je na format XML.

W poniższym przykładzie zasady pobiera ona wiadomość w formacie JSON z request, a następnie zastępuje wartość zmiennej komunikatem w formacie XML. Dane wejściowe są określone w elemencie <Source>, a dane wyjściowe – w elemencie <OutputVariable>.

<JSONToXML name="jsontoxml">
     <Source>request</Source>
     <OutputVariable>request</OutputVariable>
</JSONToXML>

Konwertuję plik XML na format JSON

zasadę XML na JSON, konwertuje komunikat wejściowy XML na format JSON.

W poniższym przykładzie zasady pobiera ona komunikat w formacie XML z response, a następnie zastępuje wartość zmiennej komunikatem w formacie JSON. Dane wejściowe są określone w elemencie <Source>, a dane wyjściowe – w elemencie <OutputVariable>.

<XMLToJSON name="ConvertToJSON">
   <OutputVariable>response</OutputVariable>
   <Source>response</Source>
</XMLToJSON>

Przekształcanie pliku XML za pomocą formatu XSL

Za pomocą pliku XSL Przekształć zasadę, aby przekształcić wiadomości przy użyciu formatu XSL. Na przykład po przekonwertowaniu pliku JSON do pliku XML, możesz użyć zasady przekształcenia XSL z arkuszem stylów, aby wykonać do niezbędnej transformacji.

W poniższym przykładzie zasady pobiera ona komunikat w formacie XML z response, a następnie zastępuje wartość zmiennej wiadomością sformatowanej według my_transform.xsl Dane wejściowe są określone w elemencie <Source>, a dane wyjściowe są określone w elemencie <OutputVariable>.

<XSL name="TransformXML">
    <ResourceURL>xsl://my_transform.xsl</ResourceURL>
    <Source>response</Source>
    <OutputVariable>response</OutputVariable>
</XSL>

    <Source>request</Source>
    <ResourceURL>xsl://XSL-Transform-1.xsl</ResourceURL>
    <OutputVariable/>

Obsługa danych zmiennych

Obsługa danych w obrębie serwera proxy często polega na pracy z danymi stanu jako zmienną przepływu . Często można to zrobić, stosując zasadę, która pobiera lub ustawia wartości zmiennych. Przykład: możesz kształtować wartości zmiennych w wiadomości lub wyodrębniać treść wiadomości w celu ustawiać wartości zmiennych.

Zapoznaj się z odniesieniami do tych dwóch zasad:

Tworzenie bardziej złożonych przekształceń

W przypadku obsługi danych, której złożoność wykracza poza możliwości uwzględnione w zasadach, możesz użyć funkcji takich jak JavaScript, Java czy Python.

Zwykle polega to na napisaniu kodu w jednym z tych języków, a następnie wywołaniu go zasady dotyczące danego języka. Więcej informacji na ten temat znajdziesz w sekcji Wprowadzanie procedur w kodzie.