org.apache.camel.processor
Class RoutingSlip

java.lang.Object
  extended by org.apache.camel.impl.ServiceSupport
      extended by 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


Copyright © 2007-2010 IONA Open Source Community. All Rights Reserved.