XML メッセージの分割

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>

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>

バージョン 4.2 以降、XPathMessageSplitter は、リクエスト payload が型 org.w3c.dom.Node でない場合、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>

version 4.2 から、XPathMessageSplitter は iterator オプションを boolean フラグとして公開します（デフォルトは true）。これにより、ダウンストリームフローのスプリットノードの「ストリーミング」が可能になります。iterator モードを true に設定すると、各ノードは反復中に変換されます。false の場合、スプリットノードが出力チャネルに送信される前に、すべてのエントリが最初に変換されます。（違いは、「変換、送信、変換、送信」対「変換、変換、送信、送信」と考えることができます）詳細については、スプリッターを参照してください。