NOTE TO WRITERS: The following note is based on the FAQ http://docs.wso2.org/wiki/display/FAQ/Mediators#Mediators-Iterate. If you make changes to the note, be sure to make changes in the original FAQ as well.
Note that the responses are not necessarily aggregated in the same order that the requests were sent, even if you set the
sequential attribute to
true on the Iterate mediator.
The Aggregate mediator is a content-aware mediator.
|Table of Contents|
The parameters available for configuring the Aggregate mediator are as follows.
|Aggregate ID||This optional attribute can be used to aggregate only responses for split messages that are created by a specific clone/iterate mediator. Aggregate ID should be the same as the ID of the corresponding clone/iterate mediator that creates split messages. This is particularly useful when aggregating responses for messages that are created using nested clone/iterate mediators.|
|Aggregation Expression||An XPath expression specifying which elements should be aggregated. A set of messages that are selected for aggregation is determined by the value specified in the Correlation Expression field.|
|Completion Timeout||The number of seconds taken by the Aggregate mediator to wait for messages. When this time duration elapses, the aggregation will be completed. If the number of response messages reaches the number specified in the Completion Max-messages field, the aggregation will be completed even if the time duration specified for the Completion Timeout field has not elapsed.|
|Completion Max-messages||Maximum number of messages that can exist in an aggregation. When the number of response messages received reaches this number, the aggregation will be completed.|
|Completion Min-messages||Minimum number of messages required for the aggregation to complete. When the time duration entered in the Completion Timeout field is elapsed, the aggregation will be completed even if the number of minimum response messages specified has not been received. If no value is entered in the Completion Timeoutfield, the aggregation will not be completed until the number of response messages entered in the Completion Min-messages field is received.|
This is an XPath expression which provides the basis on which response messages should be selected for aggregation. This is done by specifying a set of elements for which the messages selected should have matching values. A specific aggregation condition is set via the Aggregation Expression field.
|Enclosing Element Property||This parameter is used to accumulate the aggregated messages inside a single property. The name of the relevant property is entered in this field.|
The sequence to run when the aggregation is complete. You can select one of the following options:
You can configure the mediator using XML. Click switch to source view in the Mediator window.
The above configuration includes the following:
<property name="info" scope="default"> <ns:Information xmlns:ns="www.asankatechtalks.com" /> </property>
|This creates the property named |
|The ID of the corresponding Clone mediator that splits the messages to be aggregated by the Aggregate mediator.|
|This expression is used to add the |
|This is the Send mediator added as a child mediator to the Aggregate mediator in order to send the aggregated and annotated messages back to the client once the aggregation is complete.|
For more examples, see: