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 final class 
    CamelInternalProcessor.BacklogDebuggerAdvice
    Advice to execute the BacklogDebugger if enabled.
    static final class 
    CamelInternalProcessor.BacklogTracerAdvice
    Advice to execute the BacklogTracer if enabled.
    static class 
    CamelInternalProcessor.ChildUnitOfWorkProcessorAdvice
    Advice when an EIP uses the shareUnitOfWork functionality.
    static final 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)
     
    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 Details

    • CamelInternalProcessor

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

    • CamelInternalProcessor

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

  • Method Details

    • 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)