通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 XML 转换为 JSON

  • 项目

适用于：所有 API 管理层级

xml-to-json 策略将请求或响应正文从 XML 转换为 JSON。 此策略可以用来根据仅用 XML 的后端 Web 服务来提升 API。

注意

按照策略声明中提供的顺序设置策略的元素和子元素。 详细了解如何设置或编辑 API 管理策略。

策略语句

<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>

属性

属性 说明 需要 默认
kind 属性必须设置为以下值之一。

- javascript-friendly - 转换后的 JSON 具有 JavaScript 开发人员熟知的形式。
- direct - 转换后的 JSON 反映了原始 XML 文档的结构。

允许使用策略表达式。		 是 空值
apply 属性必须设置为以下值之一。

- always - 始终转换。
- content-type-xml - 仅在响应的 Content-Type 标头指示存在 XML 的情况下进行转换。

允许使用策略表达式。		 是 空值
consider-accept-header 属性必须设置为以下值之一。

- true - 如果在请求的 Accept 标头中请求了 JSON，则应用转换。
- false - 始终应用转换。

允许使用策略表达式。		 否 true
always-array-child-elements 属性必须设置为以下值之一。

- true - 始终将子元素转换为 JSON 数组。
- false - 仅将多个子元素转换为 JSON 数组。 将单个子元素转换为 JSON 对象。

允许使用策略表达式。		 否 false

使用情况

  • 策略节：入站、出站、错误时
  • 策略范围：全局、工作区、产品、API、操作
  • 网关：经典、v2、消耗、自承载、工作区

示例

<policies>
    <inbound>
        <base />
    </inbound>
    <outbound>
        <base />
        <xml-to-json kind="direct" apply="always" consider-accept-header="false" />
    </outbound>
</policies>

相关内容

有关使用策略的详细信息，请参阅：