ProcessorFactory

Available as of Camel 2.4

There is a org.apache.camel.spi.ProcessorFactory which allows you to use a custom factory for creating Processor based on the Camel routes.
The factory can also be used for manipulating the definitions before the Processors is created. For example you can use it to alter options, or even add new outputs to the routes, before the routes is actually created.

Example

Here is a custom factory which will alter the processor definitions.

The unit test and route is as follows:

Now the idea is that the setBody processors has been changed by the factory to set a different body.
Also the Splitter has one additional output where we send the splitted message to mock:extra endpoint.

Notice we just return null which instructs Camel to use its default implementation to create the Processor. After all we just wanted to manipulate the definition. However if you do return a Processor then Camel use the returned processor.

Java DSL

In Java DSL all you need to do is to configure the custom factory on the CamelContext using the setProcessorFactory method:

  CamelContext context ...
  context.setProcessorFactory(new MyFactory());

Spring XML

In Spring XML all you have to do is just to declare a <bean> tag with the custom factory, and Camel will automatic lookup it up and use it.

<!-- use a custom processor factory as a hook which can manipulate the model before the processors
     is created, which allows us to do stuff to the route before its created -->
<bean id="customFactory" class="org.apache.camel.processor.CustomProcessorFactoryTest$MyFactory"/>

<camelContext xmlns="http://camel.apache.org/schema/spring">
    <!-- a simple route -->
    <route>
        <from uri="direct:start"/>
        <setBody>
            <constant>body not altered</constant>
        </setBody>
        <to uri="mock:foo"/>
    </route>

    <!-- a route which has a sub route (the split) -->
    <route>
        <from uri="direct:foo"/>
        <split>
            <simple>${body}</simple>
            <setBody>
                <constant>body not altered</constant>
            </setBody>
            <to uri="mock:split"/>
        </split>
        <to uri="mock:result"/>
    </route>

</camelContext>