Page History

...

{snippet:id=e3|lang=java|url=camel/trunk/camel-core/src/test/java/org/apache/camel/processor/onexception/OnExceptionHandleAndTransformTest.java}

Using useOriginalExchange

Available as of Camel 2.0
The option useOriginalExchange is used for routing the original input Exchange instead of the current Exchange that potential is modified and during routing.

For instance if you have this route:

   from("jms:queue:order:input")
       .to("bean:validateOrder");
       .to("bean:transformOrder")
       .to("bean:handleOrder");

The route listen for JMS messages and validates, transforms and handle it. During this the Exchange payload is transformed/modified. So in case something goes wrong and we want to move the message to another JMS destination, then we can add an onException. But when we move the Exchange to this destination we do not know in which state the message is in. Did the error happen in before the transformOrder or after? So to be sure we want to move the original input message we received from jms:queue:order:input. So we can do this by enabling the useOriginalExchange option as shown below:

    // will use original exchange
    onException(MyOrderException.class)
       .useOriginalExchange().handled(true)
       .to("jms:queue:order:failed");

Then the messages routed to the jms:queue:order:failed is the original input. If we want to manually retry we can move the JMS message from the failed to the input queue, with no problem as the message is the same as the original we received.

Advanced Usage of Exception Clause

...