Message Translator

Camel supports the Message Translator from the EIP patterns.

image

The Message Translator can be done in different ways in Camel:

  • Using Transform or Set Body in the DSL

  • Calling a Processor or bean to perform the transformation

  • Using template-based Components, with the template being the source for how the message is translated

  • Messages can also be transformed using Data Format to marshal and unmarshal messages in different encodings.

Example

Each of above approaches is documented in the following examples:

Message Translator with Transform EIP

You can use a Transform which uses an Expression to do the transformation:

In the example below we prepend Hello to the message body using the Simple language:

from("direct:cheese")
    .setBody(simple("Hello ${body}"))
    .to("log:hello");

And in XML DSL:

<route>
    <from uri="activemq:cheese"/>
    <transform>
        <simple>Hello ${body}</simple>
    </transform>
    <to uri="activemq:wine"/>
</route>

Message Translator with Bean

You can transform a message using Camels Bean Integration to call any method on a bean that performs the message translation:

from("activemq:cheese")
  .bean("myTransformerBean", "doTransform")
  .to("activemq:wine");

And in XML:

<route>
    <from uri="activemq:cheese"/>
    <bean ref="myTransformerBean" method="doTransform"/>
    <to uri="activemq:wine"/>
</route>

Message Translator with Processor

You can also use a Processor to do the transformation:

from("activemq:cheese")
  .process(new MyTransformerProcessor())
  .to("activemq:wine");

And in XML:

<route>
    <from uri="activemq:cheese"/>
    <process ref="myTransformerProcessor"/>
    <to uri="activemq:wine"/>
</route>

Message Translator using Templating Components

You can also consume a message from one destination, transform it with something like Velocity or XQuery and then send it on to another destination.

from("activemq:cheese")
    .to("velocity:com/acme/MyResponse.vm")
    .to("activemq:wine");

And in XML:

<route>
    <from uri="activemq:cheese"/>
    <to uri="velocity:com/acme/MyResponse.vm"/>
    <to uri="activemq:wine"/>
</route>

Message Translator using Data Format

See Marshal EIP for more details and examples.