Recipient List
The Recipient List![]()
from the EIP patterns allows you to route messages to a number of dynamically specified recipients.
![]()
Static Recipient List
The following example shows how to route a request from an input queue:a endpoint to a static list of destinations
Using the Fluent Builders
RouteBuilder builder = new RouteBuilder() {
public void configure() {
from("seda:a").to("seda:b", "seda:c", "seda:d");
}
};
Using the Spring XML Extensions
<camelContext id="camel" xmlns="http://activemq.apache.org/camel/schema/spring">
<route>
<from uri="seda:a"/>
<to uri="seda:b"/>
<to uri="seda:c"/>
<to uri="seda:d"/>
</route>
</camelContext>
Dynamic Recipient List
Usually one of the main reasons for using the Recipient List![]()
pattern is that the list of recipients is dynamic and calculated at runtime. The following example demonstrates how to create a dynamic recipient list using an _expression_ (which in this case it extracts a named header value dynamically) to calculate the list of endpoints which are either of type Endpoint![]()
or are converted to a String and then resolved using the endpoint URIs.
Using the Fluent Builders
RouteBuilder builder = new RouteBuilder() {
public void configure() {
from("seda:a").recipientList(header("foo"));
}
};
The above assumes that the header contains a list of endpoint URIs. The following takes a single string header and tokenizes it
from("direct:a").recipientList(
header("recipientListHeader").tokenize(","));
Using the Spring XML Extensions
<camelContext id="camel" xmlns="http://activemq.apache.org/camel/schema/spring">
<route>
<from uri="seda:a"/>
<recipientList>
<xpath>$foo</xpath>
</recipientList>
</route>
</camelContext>
For further examples of this pattern in use you could look at one of the junit test case![]()
Using This Pattern
If you would like to use this EIP Pattern then please read the Getting Started, you may also find the Architecture useful particularly the description of Endpoint and URIs. Then you could try out some of the Examples first before trying this pattern out.
