拆分 XML 消息

QWen Plus 中英对照 Splitting XML Messages

XPathMessageSplitter 支持消息的有效载荷为 String 或 Document。拆分器使用提供的 XPath 表达式将有效载荷拆分为多个节点。默认情况下，这会导致每个 Node 实例成为新消息的有效载荷。当每个消息应该是一个 Document 时，您可以设置 createDocuments 标志。当传递 String 类型的有效载荷时，有效载荷会被转换，然后拆分，并在最后被转换回多个 String 消息。XPath 拆分器实现了 MessageHandler，因此应与适当的端点一起配置（请参阅以下示例后的命名空间支持示例以获取更简单的配置替代方案）。以下示例配置了一个使用 XPathMessageSplitter 的 bean：

<bean id="splittingEndpoint"
      class="org.springframework.integration.endpoint.EventDrivenConsumer">
    <constructor-arg ref="orderChannel" />
    <constructor-arg>
        <bean class="org.springframework.integration.xml.splitter.XPathMessageSplitter">
            <constructor-arg value="/order/items" />
            <property name="documentBuilder" ref="customisedDocumentBuilder" />
            <property name="outputChannel" ref="orderItemsChannel" />
        </bean>
    </constructor-arg>
</bean>

xml

XPath 分割器命名空间支持让你创建带有输入通道和输出通道的消息端点，如下例所示：

<!-- Split the order into items and create a new message for each item node -->
<int-xml:xpath-splitter id="orderItemSplitter"
                       input-channel="orderChannel"
                       output-channel="orderItemsChannel">
    <int-xml:xpath-expression expression="/order/items"/>
</int-xml:xpath-splitter>

<!-- Split the order into items, create a new document for each item-->
<int-xml:xpath-splitter id="orderItemDocumentSplitter"
                       input-channel="orderChannel"
                       output-channel="orderItemsChannel"
                       create-documents="true">
    <int-xml:xpath-expression expression="/order/items"/>
    <int:poller fixed-rate="2000"/>
</int-xml:xpath-splitter>

xml

从 4.2 版本开始，当请求 payload 不是 org.w3c.dom.Node 类型时，XPathMessageSplitter 暴露了 javax.xml.transform.Transformer 实例的 outputProperties（例如 OutputKeys.OMIT_XML_DECLARATION）属性。以下示例定义了一个属性并使用它与 output-properties 属性：

<util:properties id="outputProperties">
	<beans:prop key="#{T (javax.xml.transform.OutputKeys).OMIT_XML_DECLARATION}">yes</beans:prop>
</util:properties>

<xpath-splitter input-channel="input"
             output-properties="outputProperties">
    <xpath-expression expression="/orders/order"/>
</xpath-splitter>

xml

从 version 4.2 开始，XPathMessageSplitter 暴露了一个 iterator 选项作为 boolean 标志（默认为 true）。这允许在下游流中“流式传输”拆分节点。当 iterator 模式设置为 true 时，在迭代过程中每个节点都会被转换。当设置为 false 时，所有条目首先会被转换，然后再将拆分的节点开始发送到输出通道。（你可以把这种差异理解为“转换，发送，转换，发送”与“转换，转换，发送，发送”。）更多信息请参见 Splitter。