XMLRecordSetWriter

XMLRecordSetWriter Controller Service 把记录对象写出为 XML。必须为该 Controller Service 配置一个描述记录对象结构的 schema。多条记录会被包裹在 一个根节点中，根节点的名称可以通过属性配置。如果未配置根节点，则 Writer 期望每个 FlowFile 只有一条记录（不会被包裹）。由于 Avro 不支持为 记录定义属性（attribute），该 Writer 目前不支持写出 XML 属性。

示例：简单记录

RecordSet (
  Record (
    Field "name1" = "value1",
    Field "name2" = 42
  ),
  Record (
    Field "name1" = "value2",
    Field "name2" = 84
  )
)

该记录可以用以下 schema 描述：

{
  "name": "test",
  "namespace": "lynxus",
  "type": "record",
  "fields": [
    {
      "name": "name1",
      "type": "string"
    },
    {
      "name": "name2",
      "type": "int"
    }
  ]
}

假设把 "root_name" 配置为根节点的名称、"record_name" 配置为记录节点的 名称，Writer 会写出如下 XML：

<root_name>
    <record_name>
        <name1>value1</name1>
        <name2>42</name2>
    </record_name>
    <record_name>
        <name1>value2</name1>
        <name2>84</name2>
    </record_name>
</root_name>

该 Writer 还可以配置如何处理记录中的 null 或缺失值：

RecordSet (
  Record (
    Field "name1" = "value1",
    Field "name2" = null
  ),
  Record (
    Field "name1" = "value2",
  )
)

如果 Writer 配置为总是抑制缺失值或 null 值，XML 中只会出现在名为 "name1" 的字段。如果 Writer 配置为只抑制缺失值，第一条记录中名为 "name2" 的字段 会作为无内容的节点出现在 XML 中。如果 Writer 配置为不抑制任何内容， 两条记录中名为 "name2" 的字段都会作为无内容的节点出现在 XML 中。

示例：数组

该 Writer 还可以配置如何写出数组：

RecordSet (
  Record (
    Field "name1" = "value1",
    Field "array_field" = [ 1, 2, 3 ]
  )
)

该记录可以用以下 schema 描述：

{
  "name": "test",
  "namespace": "lynxus",
  "type": "record",
  "fields": [
    {
      "name": "array_field",
      "type": {
        "type": "array",
        "items": int
      }
    },
    {
      "name": "name1",
      "type": "string"
    }
  ]
}

如果 Writer 配置为不包裹数组，它会把记录转换为如下 XML：

<root_name>
    <record_name>
        <name1>value1</name1>
        <array_field>1</array_field>
        <array_field>2</array_field>
        <array_field>3</array_field>
    </record_name>
</root_name>

如果 Writer 配置为包裹数组、使用字段名作为包裹节点、"elem" 作为元素节点的 标签名，它会把记录转换为如下 XML：

<root_name>
    <record_name>
        <name1>value1</field2>
        <array_field>
            <elem>1</elem>
            <elem>2</elem>
            <elem>3</elem>
        </array_field>
    </record_name>
</root_name>

如果 Writer 配置为包裹数组、使用 "wrap" 作为包裹节点、字段名作为元素节点的 标签名，它会把记录转换为如下 XML：

<root_name>
    <record_name>
        <name1>value1</field2>
        <wrap>
            <array_field>1</array_field>
            <array_field>2</array_field>
            <array_field>3</array_field>
        </wrap>
    </record_name>
</root_name>