Recipient List – routing a message to a list of endpoints

When you want to dynamically (at runtime) decide a list of endpoints that an individual message should be sent to, use the Recipient List EIP. This EIP is made up of two phases: deciding where to route the message, and subsequently invoking those route steps. It can be thought of as a dynamic Multicast, and behaves in much the same way.

This recipe will show you how to route a message to a number of dynamically specified endpoints.

Getting ready

The Java code for this recipe is located in the org.camelcookbook.routing.recipientlist package. The Spring XML files are located under src/main/resources/META-INF/spring and prefixed with recipientList.

How to do it...

Use the recipientList DSL statement, which includes an Expression that tells it where to get, the list of endpoints for routing the message at runtime.

In the XML DSL, this routing logic is written as:

<route>
  <from uri="direct:start"/>
  <setHeader headerName="endpointsToBeTriggered...