org.springframework.integration.xml.splitter

Class XPathMessageSplitter

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.handler.AbstractMessageHandler

org.springframework.integration.handler.AbstractMessageProducingHandler

org.springframework.integration.handler.AbstractReplyProducingMessageHandler

org.springframework.integration.splitter.AbstractMessageSplitter

org.springframework.integration.xml.splitter.XPathMessageSplitter

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.BeanFactoryAware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, org.springframework.context.ApplicationContextAware, org.springframework.core.Ordered, ExpressionCapable, Orderable, MessageProducer, HeaderPropagationAware, NamedComponent, ConfigurableMetricsAware<AbstractMessageHandlerMetrics>, IntegrationManagement, IntegrationStatsManagement, MessageHandlerMetrics, TrackableComponent, org.springframework.messaging.MessageHandler

public class XPathMessageSplitter
extends AbstractMessageSplitter

Message Splitter that uses an XPathExpression to split a Document, File or String payload into a NodeList. The return value will be either Strings or Nodes depending on the received payload type. Additionally, node types will be converted to Documents if the 'createDocuments' property is set to true.

Author:

Jonas Partner, Mark Fisher, Artem Bilan, Gary Russell

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.integration.handler.AbstractReplyProducingMessageHandler

AbstractReplyProducingMessageHandler.RequestHandler

Field Summary

Fields inherited from class org.springframework.integration.handler.AbstractMessageProducingHandler

messagingTemplate

Fields inherited from class org.springframework.integration.context.IntegrationObjectSupport

EXPRESSION_PARSER, logger

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
XPathMessageSplitter(java.lang.String expression)
XPathMessageSplitter(java.lang.String expression, java.util.Map<java.lang.String,java.lang.String> namespaces)
XPathMessageSplitter(org.springframework.xml.xpath.XPathExpression xpathExpression)

Method Summary

Modifier and Type	Method and Description
protected void	doInit()
java.lang.String	getComponentType() Subclasses may implement this method to provide component type information.
void	setCreateDocuments(boolean createDocuments)
void	setDocumentBuilder(javax.xml.parsers.DocumentBuilderFactory documentBuilderFactory)
void	setIterator(boolean iterator) The iterator mode: true (default) to return an Iterator for splitting payload, false to return a List.
void	setOutputProperties(java.util.Properties outputProperties) A set of output properties that will be used to override any of the same properties in affect for the transformation.
void	setXmlPayloadConverter(XmlPayloadConverter xmlPayloadConverter)
protected java.lang.Object	splitMessage(org.springframework.messaging.Message<?> message) Subclasses must override this method to split the received Message.

Methods inherited from class org.springframework.integration.splitter.AbstractMessageSplitter

addHeaders, handleRequestMessage, produceOutput, setApplySequence, shouldCopyRequestHeaders, willAddHeaders

Methods inherited from class org.springframework.integration.handler.AbstractReplyProducingMessageHandler

doInvokeAdvisedRequestHandler, getRequiresReply, handleMessageInternal, hasAdviceChain, onInit, setAdviceChain, setBeanClassLoader, setRequiresReply

Methods inherited from class org.springframework.integration.handler.AbstractMessageProducingHandler

addNotPropagatedHeaders, createOutputMessage, getNotPropagatedHeaders, getOutputChannel, isAsync, resolveErrorChannel, sendErrorMessage, sendOutput, sendOutputs, setAsync, setNotPropagatedHeaders, setOutputChannel, setOutputChannelName, setSendTimeout, shouldSplitOutput

Methods inherited from class org.springframework.integration.handler.AbstractMessageHandler

configureMetrics, getActiveCount, getActiveCountLong, getDuration, getErrorCount, getErrorCountLong, getHandleCount, getHandleCountLong, getManagedName, getManagedType, getMaxDuration, getMeanDuration, getMinDuration, getOrder, getStandardDeviationDuration, handleMessage, isCountsEnabled, isLoggingEnabled, isStatsEnabled, reset, setCountsEnabled, setLoggingEnabled, setManagedName, setManagedType, setOrder, setShouldTrack, setStatsEnabled

Methods inherited from class org.springframework.integration.context.IntegrationObjectSupport

afterPropertiesSet, extractTypeIfPossible, getApplicationContext, getApplicationContextId, getBeanFactory, getChannelResolver, getComponentName, getConversionService, getExpression, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, setPrimaryExpression, setTaskScheduler, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.integration.support.context.NamedComponent

getComponentName

Constructor Detail

XPathMessageSplitter

public XPathMessageSplitter(java.lang.String expression)

XPathMessageSplitter

public XPathMessageSplitter(java.lang.String expression,
                            java.util.Map<java.lang.String,java.lang.String> namespaces)

XPathMessageSplitter

public XPathMessageSplitter(org.springframework.xml.xpath.XPathExpression xpathExpression)

Method Detail

setCreateDocuments

public void setCreateDocuments(boolean createDocuments)

getComponentType

public java.lang.String getComponentType()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this method to provide component type information.

Specified by:

getComponentType in interface NamedComponent

Overrides:

getComponentType in class AbstractMessageSplitter

setDocumentBuilder

public void setDocumentBuilder(javax.xml.parsers.DocumentBuilderFactory documentBuilderFactory)

setXmlPayloadConverter

public void setXmlPayloadConverter(XmlPayloadConverter xmlPayloadConverter)

setIterator

public void setIterator(boolean iterator)

The iterator mode: true (default) to return an Iterator for splitting payload, false to return a List.

Parameters:

iterator - boolean flag for iterator mode. Default to true.

Since:

4.2

setOutputProperties

public void setOutputProperties(java.util.Properties outputProperties)

A set of output properties that will be used to override any of the same properties in affect for the transformation.

Parameters:

outputProperties - the Transformer output properties.

Since:

4.2

See Also:

Transformer.setOutputProperties(Properties)

doInit

protected void doInit()

Overrides:

doInit in class AbstractReplyProducingMessageHandler

splitMessage

protected java.lang.Object splitMessage(org.springframework.messaging.Message<?> message)

Description copied from class: AbstractMessageSplitter

Subclasses must override this method to split the received Message. The return value may be a Collection or Array. The individual elements may be Messages, but it is not necessary. If the elements are not Messages, each will be provided as the payload of a Message. It is also acceptable to return a single Object or Message. In that case, a single reply Message will be produced.

Specified by:

splitMessage in class AbstractMessageSplitter

Parameters:

message - The message.

Returns:

The result of splitting the message.