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.reactivestreams.Subscriber<org.springframework.messaging.Message<?>>, 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, reactor.core.CoreSubscriber<org.springframework.messaging.Message<?>>

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

Nested classes/interfaces inherited from interface org.springframework.integration.support.management.IntegrationManagement

IntegrationManagement.ManagementOverrides

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.integration.support.management.IntegrationManagement

METER_PREFIX, RECEIVE_COUNTER_NAME, SEND_TIMER_NAME

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.
protected int	obtainSizeIfPossible(java.util.Iterator<?> iterator) Obtain a size of the provided Iterator.
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, obtainSizeIfPossible, 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, updateNotPropagatedHeaders

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

configureMetrics, getActiveCount, getActiveCountLong, getDuration, getErrorCount, getErrorCountLong, getHandleCount, getHandleCountLong, getManagedName, getManagedType, getMaxDuration, getMeanDuration, getMinDuration, getOrder, getOverrides, getStandardDeviationDuration, handleMessage, isCountsEnabled, isLoggingEnabled, isStatsEnabled, onComplete, onError, onNext, onSubscribe, registerMetricsCaptor, 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, isInitialized, 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

Methods inherited from interface reactor.core.CoreSubscriber

currentContext

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.

obtainSizeIfPossible

protected int obtainSizeIfPossible(java.util.Iterator<?> iterator)

Description copied from class: AbstractMessageSplitter

Obtain a size of the provided Iterator. Default implementation returns 0.

Overrides:

obtainSizeIfPossible in class AbstractMessageSplitter

Parameters:

iterator - the Iterator to obtain the size

Returns:

the size of the Iterator