@Retention(value=RUNTIME) @Documented @Target(value={FIELD,METHOD,CONSTRUCTOR}) public @interface RecipientList
Exchange
is received from an Endpoint
then the
Bean Integration
mechanism is used to map the incoming Message
to the method parameters.
The return value of the method is then converted to either a Collection
or array of objects where each
element is converted to an Endpoint
or a String
, or if it is not a collection/array then it is converted
to an Endpoint
or String
.
Then for each endpoint or URI the message is forwarded a separate copy.Modifier and Type | Optional Element and Description |
---|---|
String |
delimiter
Delimiter used if the Expression returned multiple endpoints.
|
String |
executorServiceRef
Refers to a custom Thread Pool to be used for parallel processing.
|
boolean |
ignoreInvalidEndpoints
Whether to ignore the invalidate endpoint exception when try to create a producer with that endpoint
|
String |
onPrepareRef
|
boolean |
parallelAggregate
If enabled then the aggregate method on AggregationStrategy can be called concurrently.
|
boolean |
parallelProcessing
If enabled then sending messages to the recipients occurs concurrently.
|
boolean |
shareUnitOfWork
Deprecated.
|
boolean |
stopOnAggregateException
If enabled, unwind exceptions occurring at aggregation time to the error handler when parallelProcessing is used.
|
boolean |
stopOnException
Will now stop further processing if an exception or failure occurred during processing of an
Exchange and the caused exception will be thrown. |
String |
strategyRef
Sets a reference to the AggregationStrategy to be used to assemble the replies from the recipients, into a single outgoing message from the RecipientList.
|
boolean |
streaming
If enabled then Camel will process replies out-of-order, eg in the order they come back.
|
long |
timeout
Sets a total timeout specified in millis, when using parallel processing.
|
public abstract boolean parallelProcessing
public abstract boolean parallelAggregate
public abstract boolean stopOnException
Exchange
and the caused exception will be thrown.
Will also stop if processing the exchange failed (has a fault message) or an exception
was thrown and handled by the error handler (such as using onException). In all situations
the recipient list will stop further processing. This is the same behavior as in pipeline, which
is used by the routing engine.
The default behavior is to not stop but continue processing till the endpublic abstract boolean stopOnAggregateException
false
for the sake of backward compatibility.public abstract boolean streaming
public abstract boolean ignoreInvalidEndpoints
public abstract String strategyRef
public abstract String executorServiceRef
public abstract long timeout
public abstract String onPrepareRef
Processor
when preparing the Exchange
to be send.
This can be used to deep-clone messages that should be send, or any custom logic needed before
the exchange is send.@Deprecated public abstract boolean shareUnitOfWork
UnitOfWork
with the parent and each of the sub messages.
Recipient List will by default not share unit of work between the parent exchange and each recipient exchange.
This means each sub exchange has its own individual unit of work.Apache Camel