org.apache.camel.processor
Class RoutingSlip

java.lang.Object
  org.apache.camel.impl.ServiceSupport
      org.apache.camel.processor.RoutingSlip

All Implemented Interfaces:

AsyncProcessor, Processor, Traceable, Service, ShutdownableService

public class RoutingSlip
extends ServiceSupport
implements AsyncProcessor, Traceable

Implements a Routing Slip pattern where the list of actual endpoints to send a message exchange to are dependent on the value of a message header.

This implementation mirrors the logic from the Pipeline in the async variation as the failover load balancer is a specialized pipeline. So the trick is to keep doing the same as the pipeline to ensure it works the same and the async routing engine is flawless.

Constructor Summary

RoutingSlip(CamelContext camelContext)

RoutingSlip(CamelContext camelContext, Expression expression, String uriDelimiter)

RoutingSlip(CamelContext camelContext, String header)
Deprecated.

RoutingSlip(CamelContext camelContext, String header, String uriDelimiter)
Deprecated.

Method Summary

boolean	doRoutingSlip(Exchange exchange, Object routingSlip, AsyncCallback callback)
protected void	doStart()
protected void	doStop()
String	getTraceLabel() Gets the trace label used for logging when tracing is enabled.
boolean	isIgnoreInvalidEndpoints()
protected Exchange	prepareExchangeForRoutingSlip(Exchange current)
void	process(Exchange exchange) Processes the message exchange
boolean	process(Exchange exchange, AsyncCallback callback) Processes the message exchange.
protected boolean	processExchange(Endpoint endpoint, Exchange exchange, Exchange original, AsyncCallback callback, Iterator<Object> iter)
protected Endpoint	resolveEndpoint(Iterator<Object> iter, Exchange exchange)
void	setDelimiter(String delimiter)
void	setIgnoreInvalidEndpoints(boolean ignoreInvalidEndpoints)
String	toString()

Methods inherited from class org.apache.camel.impl.ServiceSupport

addChildService, doShutdown, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, removeChildService, shutdown, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

RoutingSlip

public RoutingSlip(CamelContext camelContext)

RoutingSlip

@Deprecated
public RoutingSlip(CamelContext camelContext,
                              String header)

Deprecated.

Will be removed in Camel 2.5

RoutingSlip

@Deprecated
public RoutingSlip(CamelContext camelContext,
                              String header,
                              String uriDelimiter)

Deprecated.

Will be removed in Camel 2.5

RoutingSlip

public RoutingSlip(CamelContext camelContext,
                   Expression expression,
                   String uriDelimiter)

Method Detail

setDelimiter

public void setDelimiter(String delimiter)

isIgnoreInvalidEndpoints

public boolean isIgnoreInvalidEndpoints()

setIgnoreInvalidEndpoints

public void setIgnoreInvalidEndpoints(boolean ignoreInvalidEndpoints)

toString

public String toString()

Overrides:

toString in class Object

getTraceLabel

public String getTraceLabel()

Description copied from interface: Traceable

Gets the trace label used for logging when tracing is enabled.

The label should be short and precise.

Specified by:

getTraceLabel in interface Traceable

Returns:

the label

process

public void process(Exchange exchange)
             throws Exception

Description copied from interface: Processor

Processes the message exchange

Specified by:

process in interface Processor

Parameters:

exchange - the message exchange

Throws:

Exception - if an internal processing error has occurred.

process

public boolean process(Exchange exchange,
                       AsyncCallback callback)

Description copied from interface: AsyncProcessor

Processes the message exchange. Similar to Processor.process(org.apache.camel.Exchange), but the caller supports having the exchange asynchronously processed.

If there was a failure processing then the caused Exception would be set on the Exchange.

Specified by:

process in interface AsyncProcessor

Parameters:

exchange - the message exchange

callback - the AsyncCallback will be invoked when the processing of the exchange is completed. If the exchange is completed synchronously, then the callback is also invoked synchronously. The callback should therefore be careful of starting recursive loop.

Returns:

(doneSync) true to continue execute synchronously, false to continue being executed asynchronously

See Also:

org.apache.camel.util.AsyncProcessorHelper#process(AsyncProcessor, Exchange, AsyncCallback)}

doRoutingSlip

public boolean doRoutingSlip(Exchange exchange,
                             Object routingSlip,
                             AsyncCallback callback)

resolveEndpoint

protected Endpoint resolveEndpoint(Iterator<Object> iter,
                                   Exchange exchange)
                            throws Exception

Throws:

Exception

prepareExchangeForRoutingSlip

protected Exchange prepareExchangeForRoutingSlip(Exchange current)

processExchange

protected boolean processExchange(Endpoint endpoint,
                                  Exchange exchange,
                                  Exchange original,
                                  AsyncCallback callback,
                                  Iterator<Object> iter)

doStart

protected void doStart()
                throws Exception

Specified by:

doStart in class ServiceSupport

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Specified by:

doStop in class ServiceSupport

Throws:

Exception