Configuring Message Relay

In the axis2.xml file, there are two configuration sections called messageBuilders and messageFormatters. The user can replace the expected content types with the Message Relay builder and formatter to pass these messages through the ESB without building them.

Message Relay Builder and Formatter Class Names

Builder	`org.wso2.carbon.relay.BinaryRelayBuilder`
Formatter	`org.wso2.carbon.relay.ExpandingMessageFormatter`

Sample Configuration for Message Builder

<messageBuilders>
        <messageBuilder contentType="application/xml"
                        class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
        <messageBuilder contentType="application/x-www-form-urlencoded"
                        class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
        <messageBuilder contentType="multipart/form-data"
                        class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
        <messageBuilder contentType="text/plain"
                         class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
        <messageBuilder contentType="text/xml"
                         class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
    </messageBuilders>

Sample Configuration for Message Formatter

<messageFormatters>
        <messageFormatter contentType="application/x-www-form-urlencoded"
                          class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
        <messageFormatter contentType="multipart/form-data"
                          class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
        <messageFormatter contentType="application/xml"
                          class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
        <messageFormatter contentType="text/xml"
                         class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
        <!--<messageFormatter contentType="text/plain"
                         class="org.apache.axis2.format.PlainTextBuilder"/>-->
        <messageFormatter contentType="application/soap+xml"
                         class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
    </messageFormatters>

Example

If you want the ESB to receive messages of the image/png content type, add the following configurations to the <ESB_HOME>/repository/conf/axis2/axis2.xml file.

In the Message Builders section:

<messageBuilder contentType="image/png" 
                        class="org.wso2.carbon.relay.BinaryRelayBuilder"/>

In the Message Formatters section:

<messageFormatter contentType="image/png" 
                        class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>