设置消息格式、访问消息和转换消息

本页面适用于 ApigeeApigee Hybrid

查看 Apigee Edge 文档。

您可以使用 Apigee 附带的政策来操纵经过 API 代理的消息。通过政策,您可以执行以下操作:

  • 在各个格式之间转换消息,例如从 XML 到 JSON。
  • 根据消息内容设置变量值,并根据变量值创建消息。
  • 使用 JavaScript、Java 和 Python 等程序化代码以更复杂的方式处理消息和数据。

通常情况下,在使用这些政策时,您需要将输入和输出指定为流变量。在运行时,Apigee 会从源变量检索输入值,并将输出值写入输出变量。

本主题介绍这些功能。如需更详细的技术信息,请参阅每个政策的政策参考。

简单处理 XML 和 JSON

Apigee 附带一些政策,可让您在 XML 和 JSON 之间更轻松地进行转换,以及使用 XSL 转换 XML。

将 JSON 转换为 XML

JSONtoXML 政策接受 JSON 输入并将其转换为 XML。

在以下政策示例中,该政策接受来自 request 变量的 JSON 格式消息,然后用 XML 格式消息替换变量值。输入在 <Source> 元素中指定,而输出则是在 <OutputVariable> 元素中指定。

<JSONToXML name="jsontoxml">
     <Source>request</Source>                     ---> INPUT
     <OutputVariable>request</OutputVariable>          OUTPUT --->
</JSONToXML>

将 XML 转换为 JSON

XMLtoJSON 政策将 XML 输入消息转换为 JSON。

在以下政策示例中,该政策接受来自 response 变量的 XML 格式消息,然后用 JSON 格式消息替换变量值。输入在 <Source> 元素中指定,而输出则是在 <OutputVariable> 元素中指定。

<XMLToJSON name="ConvertToJSON">
   <Source>response</Source>                     ---> INPUT
   <OutputVariable>response</OutputVariable>          OUTPUT --->
</XMLToJSON>

使用 XSL 转换 XML

您可以通过 XSLTransform 政策使用 XSL 转换消息。例如,将 JSON 载荷转换为 XML 后,您可以在样式表中使用 XSL 转换政策来执行所需的转换。

在以下政策示例中,该政策接受来自 response 变量的 XML 格式消息,然后用 my_transform.xsl 格式化的消息替换变量值。输入在 <Source> 元素中指定,而输出则是在 <OutputVariable> 元素中指定。

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

处理变量数据

代理内的数据处理通常仅涉及作为流变量值处理状态数据。通常,您可以使用用于获取或设置变量值的政策来实现此目的。例如,您可能需要将变量值塑造成消息,或提取消息的内容以设置变量值。

务必查看以下两个政策的引用:

创建更复杂的转换

对于复杂性超出所包含政策的功能的数据处理,您可以使用程序化语言,例如 JavaScript、Java 或 Python。

通常,这涉及采用其中一种语言编写代码,然后从该特定语言的政策中调用代码。如需了解详情,请参阅合并程序化代码