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

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Za pomocą zasad uwzględnionych w Apigee Edge możesz manipulować wiadomościami przechodzącymi przez serwery proxy interfejsów API. Zasady umożliwiają:

  • Konwertuj wiadomości między formatami, np. z XML na JSON.
  • Ustawiaj wartości zmiennych w treści wiadomości i twórz wiadomości na podstawie wartości zmiennych.
  • Do obsługi wiadomości i danych w bardziej złożony sposób używaj kodu procedurowego, np. JavaScriptu, Javy i Pythona.

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

W tym temacie omawiamy te możliwości. Pełne i techniczne informacje znajdziesz w opisach zasad każdej z tych kategorii.

Prosta obsługa formatów XML i JSON

Apigee Edge zawiera zasady, które ułatwiają konwersję między formatami XML i JSON oraz przekształcanie XML za pomocą XSL.

Konwersja JSON na XML

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

W podanym niżej przykładzie zasad zasada pobiera wiadomość w formacie JSON ze zmiennej 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>

Konwertowanie XML na JSON

Zasada XML na JSON konwertuje wejściową wiadomość XML na JSON.

W poniższym przykładzie zasad zasada pobiera wiadomość w formacie XML ze zmiennej 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 XML za pomocą XSL

Do przekształcania wiadomości za pomocą języka XSL możesz użyć zasady przekształcania XSL. Na przykład po przekonwertowaniu ładunku JSON na XML możesz użyć zasady przekształcenia XSL z arkuszem stylów, aby wykonać potrzebne przekształcenie.

W podanym niżej przykładzie zasad zasada pobiera wiadomość w formacie XML ze zmiennej response, a następnie zastępuje wartość zmiennej komunikatem sformatowanym przez my_transform.xsl. Dane wejściowe są określone w elemencie <Source>, a dane wyjściowe – 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 na serwerze proxy często wiąże się z pracą z danymi stanu jako wartościami zmiennych przepływu. Często jest to możliwe, używając zasady, która pobiera lub ustawia wartości zmiennych. Możesz na przykład kształtować wartości zmiennych w wiadomości lub wyodrębnić jej zawartość, aby ustawić wartości zmiennych.

Zapoznaj się z odniesieniami do tych 2 zasad:

Tworzenie bardziej złożonych przekształceń

W przypadku obsługi danych, których złożoność wykracza poza możliwości uwzględnionych zasad, możesz używać języków procedur takich jak JavaScript, Java czy Python.

Zasadniczo polega to na pisaniu kodu w jednym z tych języków, a następnie wywoływaniu go z zasady określonej dla danego języka. Więcej informacji na ten temat znajdziesz w artykule o uwzględnianiu kodu procedurowego.