The Enrich Mediator can process a message based on a given source configuration and then perform the specified action on the message by using the target configuration. It is often used to do slight modifications to the payload.
This post explains some scenarios where Enrich mediator can be used.
Original payload
<orders>
<order>
<price>50.00</price>
<quantity>500</quantity>
<symbol>IBM</symbol>
<comment>REF 10053</comment>
</order>
<order>
<price>18.00</price>
<quantity>500</quantity>
<symbol>MSFT</symbol>
<comment>ref 20088398289</comment>
</order>
</orders>
Required payload-1
<orders>
<order>
<price>50.00</price>
<quantity>500</quantity>
<symbol>IBM</symbol>
<comment>REF 10053</comment>
</order>
<order>
<price>18.00</price>
<quantity>500</quantity>
<symbol>MSFT</symbol>
<comment>ref 20088398289</comment>
</order>
</orders>
<orderID>2</OrderID>
mediator
<property name="orderID" scope="default" description="orderID">
<orderID xmlns="">2</orderID>
</property>
<enrich>
<source clone="true" xpath="$ctx:orderID"/>
<target action="sibling" xpath="//orders"/>
</enrich>
Define a property <orderID>2</orderID>
Then add the property as a sibling of <orders>
Required payload-2
<orders>
<order>
<price>50.00</price>
<quantity>500</quantity>
<symbol>IBM</symbol>
<comment>REF 10053</comment>
</order>
<order>
<price>18.00</price>
<quantity>500</quantity>
<symbol>MSFT</symbol>
<comment>ref 20088398289</comment>
</order>
<orderID>2</OrderID>
</orders>
mediator
<property name="orderID" scope="default" description="orderID">
<orderID xmlns="">2</orderID>
</property>
<enrich>
<source clone="true" xpath="$ctx:orderID"/>
<target action="child" xpath="//orders"/>
</enrich>
Define a property <orderID>2</orderID>
Then add the property as a child of <orders>
Required payload-3
<orders>
<order>
<price>50.00</price>
<quantity>500</quantity>
<symbol>IBM</symbol>
<comment>REF 10053</comment>
<volume>100<volume>
</order>
<order>
<price>18.00</price>
<quantity>500</quantity>
<symbol>MSFT</symbol>
<comment>ref 20088398289</comment>
</order>
<orderID>2</OrderID>
</orders>
mediator
<property name="VOLUME" value="100"/>
<enrich>
<source type="inline" clone="true">
<volume xmlns=""/>
</source>
<target action="child" xpath="//orders/order"/>
</enrich>
<enrich>
<source type="property" clone="true" property="VOLUME"/>
<target xpath="//orders/order/volume"/>
</enrich>
Using first enrich mediator we add the element <volume> as a child of <order>
Second enrich mediator adds the value of “VOLUME” property to the newly created element
Required payload-4
<orders>
<order>
<price>50.00</price>
<quantity>500</quantity>
<symbol>IBM</symbol>
<comment>REF 10053</comment>
<volume>100<volume>
</order>
<order>
<price>18.00</price>
<quantity>500</quantity>
<symbol>MSFT</symbol>
<volume>100</volume>
<comment>ref 20088398289</comment>
</order>
<orderID>2</OrderID>
</orders>
mediator
<property name="VOLUME" value="100"/>
<enrich>
<source type="inline" clone="true">
<volume xmlns=""/>
</source>
<target action="child" xpath="//orders/order[symbol/text() = 'MSFT']"/>
</enrich>
<enrich>
<source type="property" clone="true" property="VOLUME"/>
<target xpath="//orders/order[symbol/text() = 'MSFT']/volume"/>
</enrich>
Instead of comparing 'MSFT' twice, we can use a property to store the value 'MSFT' and then use it for comparisons as below.
<property name="VOLUME" value="100"/>
<property name="SYMBOL" value="MSFT"/>
<enrich>
<source type="inline" clone="true">
<volume xmlns=""/>
</source>
<target action="child"
xpath="//orders/order[symbol/text() = get-property('SYMBOL')]"/>
</enrich>
<enrich>
<source type="property" clone="true" property="VOLUME"/>
<target xpath="//orders/order[symbol/text() = get-property('SYMBOL')]/volume"/>
</enrich>
