Package org.apache.camel.impl.engine

Class CamelInternalProcessor

java.lang.Object

org.apache.camel.support.service.BaseService

org.apache.camel.support.service.ServiceSupport

org.apache.camel.support.AsyncProcessorSupport

org.apache.camel.support.processor.DelegateAsyncProcessor

org.apache.camel.impl.engine.CamelInternalProcessor

All Implemented Interfaces:

AutoCloseable, org.apache.camel.AsyncProcessor, org.apache.camel.DelegateProcessor, org.apache.camel.Navigate<org.apache.camel.Processor>, org.apache.camel.Processor, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.spi.InternalProcessor, org.apache.camel.StatefulService, org.apache.camel.SuspendableService

Direct Known Subclasses:

DefaultChannel

public class CamelInternalProcessor
extends org.apache.camel.support.processor.DelegateAsyncProcessor
implements org.apache.camel.spi.InternalProcessor

Internal Processor that Camel routing engine used during routing for cross cutting functionality such as:

• Execute UnitOfWork
• Keeping track which route currently is being routed
• Execute RoutePolicy
• Gather JMX performance statics
• Tracing
• Debugging
• Message History
• Stream Caching
• Transformer

... and more.

This implementation executes this cross cutting functionality as a CamelInternalProcessorAdvice advice (before and after advice) by executing the CamelInternalProcessorAdvice.before(org.apache.camel.Exchange) and CamelInternalProcessorAdvice.after(org.apache.camel.Exchange, Object) callbacks in correct order during routing. This reduces number of stack frames needed during routing, and reduce the number of lines in stacktraces, as well makes debugging the routing engine easier for end users.

Debugging tips: Camel end users whom want to debug their Camel applications with the Camel source code, then make sure to read the source code of this class about the debugging tips, which you can find in the process(org.apache.camel.Exchange, org.apache.camel.AsyncCallback) method.

The added advices can implement Ordered to control in which order the advices are executed.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CamelInternalProcessor.BacklogDebuggerAdvice	Advice to execute the BacklogDebugger if enabled.
static class	CamelInternalProcessor.BacklogTracerAdvice	Advice to execute the BacklogTracer if enabled.
static class	CamelInternalProcessor.ChildUnitOfWorkProcessorAdvice	Advice when an EIP uses the shareUnitOfWork functionality.
static class	CamelInternalProcessor.DebuggerAdvice	Advice to execute when using custom debugger.
static class	CamelInternalProcessor.DelayerAdvice	Advice for delaying
static class	CamelInternalProcessor.MessageHistoryAdvice	Advice when Message History has been enabled.
static class	CamelInternalProcessor.NodeHistoryAdvice	Advice that stores the node id and label of the processor that is processing the exchange.
static class	CamelInternalProcessor.RouteInflightRepositoryAdvice	Advice to keep the InflightRepository up to date.
static class	CamelInternalProcessor.RouteLifecycleAdvice	Advice to invoke callbacks for before and after routing.
static class	CamelInternalProcessor.RoutePolicyAdvice	Advice to execute any RoutePolicy a route may have been configured with.
static class	CamelInternalProcessor.StreamCachingAdvice	Advice for StreamCachingStrategy
static class	CamelInternalProcessor.TracingAdvice	Advice for tracing
static class	CamelInternalProcessor.UnitOfWorkProcessorAdvice	Advice to inject new UnitOfWork to the Exchange if needed, and as well to ensure the UnitOfWork is done and stopped.

Field Summary

Fields inherited from class org.apache.camel.support.processor.DelegateAsyncProcessor

processor

Fields inherited from class org.apache.camel.support.service.BaseService

BUILT, FAILED, INITIALIZED, INITIALIZING, lock, NEW, SHUTDOWN, SHUTTING_DOWN, STARTED, STARTING, status, STOPPED, STOPPING, SUSPENDED, SUSPENDING

Constructor Summary

Constructors

Constructor	Description
CamelInternalProcessor(org.apache.camel.CamelContext camelContext)
CamelInternalProcessor(org.apache.camel.CamelContext camelContext, org.apache.camel.Processor processor)

Method Summary

Modifier and Type	Method	Description
void	addAdvice(org.apache.camel.spi.CamelInternalProcessorAdvice<?> advice)
void	addManagementInterceptStrategy(org.apache.camel.spi.ManagementInterceptStrategy.InstrumentationProcessor processor)
void	addRouteInflightRepositoryAdvice(org.apache.camel.spi.InflightRepository inflightRepository, String routeId)
void	addRouteLifecycleAdvice()
void	addRoutePolicyAdvice(List<org.apache.camel.spi.RoutePolicy> routePolicyList)
protected void	doBuild()
protected void	doShutdown()
<T> T	getAdvice(Class<T> type)
static void	onClassloaded(org.slf4j.Logger log)
boolean	process(org.apache.camel.Exchange exchange, org.apache.camel.AsyncCallback originalCallback)
void	setRouteOnAdvices(org.apache.camel.Route route)
String	toString()
static Object	unwrap(org.apache.camel.spi.CamelInternalProcessorAdvice<?> advice)
static <T> org.apache.camel.spi.CamelInternalProcessorAdvice<T>	wrap(org.apache.camel.spi.ManagementInterceptStrategy.InstrumentationProcessor<T> instrumentationProcessor)	Wrap an InstrumentationProcessor into a CamelInternalProcessorAdvice

Methods inherited from class org.apache.camel.support.processor.DelegateAsyncProcessor

doInit, doStart, doStop, getProcessor, hasNext, next, setProcessor, setProcessor

Methods inherited from class org.apache.camel.support.AsyncProcessorSupport

process, processAsync

Methods inherited from class org.apache.camel.support.service.BaseService

build, doFail, doLifecycleChange, doResume, doSuspend, fail, getStatus, init, isBuild, isInit, isNew, isRunAllowed, isShutdown, isStarted, isStarting, isStartingOrStarted, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.camel.AsyncProcessor

processAsync

Methods inherited from interface org.apache.camel.Processor

process

Methods inherited from interface org.apache.camel.Service

build, close, init, start, stop

Methods inherited from interface org.apache.camel.ShutdownableService

shutdown

Methods inherited from interface org.apache.camel.StatefulService

getStatus, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isSuspending

Methods inherited from interface org.apache.camel.SuspendableService

isSuspended, resume, suspend

Constructor Detail

CamelInternalProcessor

public CamelInternalProcessor(org.apache.camel.CamelContext camelContext)

CamelInternalProcessor

public CamelInternalProcessor(org.apache.camel.CamelContext camelContext,
                              org.apache.camel.Processor processor)

Method Detail

onClassloaded

public static void onClassloaded(org.slf4j.Logger log)

doBuild

protected void doBuild()
                throws Exception

Overrides:

doBuild in class org.apache.camel.support.processor.DelegateAsyncProcessor

Throws:

Exception

doShutdown

protected void doShutdown()
                   throws Exception

Overrides:

doShutdown in class org.apache.camel.support.processor.DelegateAsyncProcessor

Throws:

Exception

addAdvice

public void addAdvice(org.apache.camel.spi.CamelInternalProcessorAdvice<?> advice)

Specified by:

addAdvice in interface org.apache.camel.spi.InternalProcessor

getAdvice

public <T> T getAdvice(Class<T> type)

Specified by:

getAdvice in interface org.apache.camel.spi.InternalProcessor

addRoutePolicyAdvice

public void addRoutePolicyAdvice(List<org.apache.camel.spi.RoutePolicy> routePolicyList)

Specified by:

addRoutePolicyAdvice in interface org.apache.camel.spi.InternalProcessor

addRouteInflightRepositoryAdvice

public void addRouteInflightRepositoryAdvice(org.apache.camel.spi.InflightRepository inflightRepository,
                                             String routeId)

Specified by:

addRouteInflightRepositoryAdvice in interface org.apache.camel.spi.InternalProcessor

addRouteLifecycleAdvice

public void addRouteLifecycleAdvice()

Specified by:

addRouteLifecycleAdvice in interface org.apache.camel.spi.InternalProcessor

addManagementInterceptStrategy

public void addManagementInterceptStrategy(org.apache.camel.spi.ManagementInterceptStrategy.InstrumentationProcessor processor)

Specified by:

addManagementInterceptStrategy in interface org.apache.camel.spi.InternalProcessor

setRouteOnAdvices

public void setRouteOnAdvices(org.apache.camel.Route route)

Specified by:

setRouteOnAdvices in interface org.apache.camel.spi.InternalProcessor

process

public boolean process(org.apache.camel.Exchange exchange,
                       org.apache.camel.AsyncCallback originalCallback)

Specified by:

process in interface org.apache.camel.AsyncProcessor

Overrides:

process in class org.apache.camel.support.processor.DelegateAsyncProcessor

toString

public String toString()

Overrides:

toString in class org.apache.camel.support.processor.DelegateAsyncProcessor

wrap

public static <T> org.apache.camel.spi.CamelInternalProcessorAdvice<T> wrap(org.apache.camel.spi.ManagementInterceptStrategy.InstrumentationProcessor<T> instrumentationProcessor)

Wrap an InstrumentationProcessor into a CamelInternalProcessorAdvice

unwrap

public static Object unwrap(org.apache.camel.spi.CamelInternalProcessorAdvice<?> advice)