org.mule.runtime.core.processor.chain

Class DefaultMessageProcessorChainBuilder

java.lang.Object

org.mule.runtime.core.processor.chain.DefaultMessageProcessorChainBuilder

All Implemented Interfaces:

MessageProcessorBuilder, MessageProcessorChainBuilder

Direct Known Subclasses:

ExplicitMessageProcessorChainBuilder

public class DefaultMessageProcessorChainBuilder
extends Object

Constructs a chain of Processors and wraps the invocation of the chain in a composite MessageProcessor. Both MessageProcessors and InterceptingMessageProcessor's can be chained together arbitrarily in a single chain. InterceptingMessageProcessors simply intercept the next MessageProcessor in the chain. When other non-intercepting MessageProcessors are used an adapter is used internally to chain the MessageProcessor with the next in the chain.

The MessageProcessor instance that this builder builds can be nested in other chains as required.

Field Summary

Fields

Modifier and Type	Field and Description
protected FlowConstruct	flowConstruct
protected MuleContext	muleContext
protected String	name
protected List	processors

Constructor Summary

Constructors

Constructor and Description
DefaultMessageProcessorChainBuilder()

Method Summary

Modifier and Type	Method and Description
MessageProcessorChain	build() This builder supports the chaining together of message processors that intercept and also those that don't.
DefaultMessageProcessorChainBuilder	chain(List<Processor> processors)
DefaultMessageProcessorChainBuilder	chain(MessageProcessorBuilder... builders) Chain a MessageProcessorBuilder by adding it the the list of processors builders that the builder implementation will use to construct a MessageProcessorChain.
DefaultMessageProcessorChainBuilder	chain(Processor... processors) Chain a Processor by adding it the the list of processors that the builder implementation will use to construct a MessageProcessorChain
DefaultMessageProcessorChainBuilder	chainBefore(MessageProcessorBuilder builder)
DefaultMessageProcessorChainBuilder	chainBefore(Processor processor)
protected MessageProcessorChain	createInterceptingChain(Processor head, List<Processor> processors, List<Processor> processorsForLifecycle)
protected MessageProcessorChain	createSimpleChain(List<Processor> tempList)
protected Processor	initializeMessageProcessor(Object processor)
void	setName(String name)

Methods inherited from class java.lang.Object

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

Field Detail

processors

protected List processors

name

protected String name

flowConstruct

protected FlowConstruct flowConstruct

muleContext

protected MuleContext muleContext

Constructor Detail

DefaultMessageProcessorChainBuilder

public DefaultMessageProcessorChainBuilder()

Method Detail

build

public MessageProcessorChain build()

This builder supports the chaining together of message processors that intercept and also those that don't. While one can iterate over message processor intercepting message processors need to be chained together. One solution is make all message processors intercepting (via adaption) and chain them all together, this results in huge stack traces and recursive calls with adaptor. The alternative is to build the chain in such a way that we iterate when we can and chain where we need to.
We iterate over the list of message processor to be chained together in reverse order collecting up those that can be iterated over in a temporary list, as soon as we have an intercepting message processor we create a DefaultMessageProcessorChain using the temporary list and set it as a listener of the intercepting message processor and then we continue with the algorithm

Returns:

a new MessageProcessorBuilder instance.

createSimpleChain

protected MessageProcessorChain createSimpleChain(List<Processor> tempList)

createInterceptingChain

protected MessageProcessorChain createInterceptingChain(Processor head,
                                                        List<Processor> processors,
                                                        List<Processor> processorsForLifecycle)

chain

public DefaultMessageProcessorChainBuilder chain(Processor... processors)

Description copied from interface: MessageProcessorChainBuilder

Chain a Processor by adding it the the list of processors that the builder implementation will use to construct a MessageProcessorChain

Parameters:

processors - Processor instance(s) to be used in the construction of a MessageProcessorChain

Returns:

the current MessageProcessorBuilder instance.

chain

public DefaultMessageProcessorChainBuilder chain(List<Processor> processors)

chain

public DefaultMessageProcessorChainBuilder chain(MessageProcessorBuilder... builders)

Description copied from interface: MessageProcessorChainBuilder

Chain a MessageProcessorBuilder by adding it the the list of processors builders that the builder implementation will use to construct a MessageProcessorChain. The MessageProcessorBuilder.build() method is invoked when the chain is constructed.

Parameters:

builders - MessageProcessorBuilder instance(s) to be used in the construction of a MessageProcessorChain

Returns:

the current MessageProcessorBuilder instance.

chainBefore

public DefaultMessageProcessorChainBuilder chainBefore(Processor processor)

chainBefore

public DefaultMessageProcessorChainBuilder chainBefore(MessageProcessorBuilder builder)

initializeMessageProcessor

protected Processor initializeMessageProcessor(Object processor)

setName

public void setName(String name)