A splitter, shown in Figure A.8, is a type of router that splits an incoming message into a series of outgoing messages, where each of the messages contains a piece of the original message. The ServiceMix EIP XPath splitter pattern is restricted to using the InOnly and RobustInOnly exchange patterns. The expression that defines how to split up the original message is defined in the XPath language. The XPath splitter pattern maps to the splitter pattern in Fuse Mediation Router.

Figure A.8. XPath Splitter Pattern

The eip:xpath-splitter element supports a forwardAttachments attribute and a forwardProperties attribute, either of which can be set to true, if you want the splitter to copy the incoming message's attachments or properties to the outgoing messages. The corresponding splitter pattern in Fuse Mediation Router does not support any such attributes. By default, the incoming message's headers are copied to each of the outgoing messages by the Fuse Mediation Router splitter.

Example A.25 shows how to define a splitter using the ServiceMix EIP component. The specified XPath expression, /*/*, causes an incoming message to split at every occurrence of a nested XML element (for example, the /foo/bar and /foo/car elements are split into distinct messages).

<eip:xpath-splitter service="test:xpathSplitter"
                    endpoint="endpoint" 
                    xpath="/*/*"
                    namespaceContext="#nsContext">
  <eip:target>
    <eip:exchange-target uri="service:http://test/router" />
  </eip:target>
</eip:xpath-splitter>

Example A.26 shows how to define an equivalent route using Fuse Mediation Router XML configuration.

<route>
  <from uri="jbi:endpoint:http://progress.com/demos/test/xpathSplitter/endpoint"/>
  <splitter>
    <xpath>/*/*</xpath>
    <to uri="jbi:service:http://test/router"/>
  </splitter>
</route>

Example A.27 shows how to define an equivalent route using the Fuse Mediation Router Java DSL.

from("jbi:endpoint:http://progress.com/demos/test/xpathSplitter/endpoint").
    splitter(xpath("/*/*")).to("jbi:service:http://test/router");