建立、存取及轉換訊息

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。info

您可以使用 Apigee Edge 隨附的政策，操控透過 API Proxy 傳送的訊息。您可以透過政策執行以下操作：

  • 在不同格式之間轉換訊息，例如從 XML 轉換為 JSON。
  • 根據訊息內容設定變數值，並使用變數值建立訊息。
  • 使用 JavaScript、Java 和 Python 等程序程式碼，以更複雜的方式處理訊息和資料。

一般來說，使用這些政策時，您會將輸入和輸出內容指定為流程變數。在執行階段，Apigee Edge 會從來源變數擷取輸入值，並將輸出值寫入輸出變數。

本主題將介紹這些功能。如需更完整的技術資訊，請參閱各項政策的參考資料。

XML 和 JSON 的簡易處理功能

Apigee Edge 包含容易在 XML 與 JSON 之間轉換的政策，以及使用 XSL 轉換 XML 的政策。

將 JSON 轉換為 XML

「JSON 轉換為 XML」政策會將 JSON 輸入內容轉換為 XML。

在下列政策範例中，政策會從 request 變數取得 JSON 格式的訊息，然後將變數值替換為 XML 格式的訊息。輸入內容是在 <Source> 元素中指定，而輸出內容則是在 <OutputVariable> 元素中指定。

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

將 XML 轉換為 JSON

「XML 轉 JSON」政策會將 XML 輸入訊息轉換為 JSON。

在下列政策範例中，政策會從 response 變數取得 XML 格式訊息，然後將變數值替換為 JSON 格式訊息。輸入內容會在 <Source> 元素中指定，而輸出內容則會在 <OutputVariable> 元素中指定。

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

使用 XSL 轉換 XML

您可以使用 XSL 轉換政策，透過 XSL 轉換訊息。舉例來說，將 JSON 酬載轉換為 XML 後，您可以使用 XSL 轉換政策搭配樣式表，執行所需的轉換作業。

在以下政策範例中，政策會從 response 變數擷取 XML 格式的訊息，然後將變數值替換成 my_transform.xsl 格式的訊息。輸入內容會在 <Source> 元素中指定，而輸出內容則會在 <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/>

處理變數資料

在 Proxy 中處理資料時，通常只需將狀態資料視為流程變數值即可。您通常可以使用可取得或設定變數值的政策來執行這項操作。舉例來說，您可能會想將變數值轉換為訊息，或擷取訊息內容來設定變數值。

請務必參閱下列兩項政策的參考資料：

建立更複雜的轉換

如果資料處理的複雜度超出內含政策的功能範圍，您可以使用 JavaScript、Java 或 Python 等程序語言。

一般來說，這項作業包括使用其中一種語言編寫程式碼，然後從該語言專屬的政策中叫用程式碼。詳情請參閱加入程序程式碼。