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 and 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 and Description
CamelInternalProcessor(org.apache.camel.CamelContext camelContext)
CamelInternalProcessor(org.apache.camel.CamelContext camelContext, org.apache.camel.Processor processor)

Method Summary

Modifier and Type	Method and 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)
<T> T	getAdvice(Class<T> type)
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

doShutdown, 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, doBuild, doFail, doInit, 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.StatefulService

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

Methods inherited from interface org.apache.camel.SuspendableService

isSuspended, resume, suspend

Methods inherited from interface org.apache.camel.ShutdownableService

shutdown

Methods inherited from interface org.apache.camel.Service

build, close, init, start, stop

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

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)