/
Configuring Message Relay
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links' is unknown.

Configuring Message Relay

Owned by Former user (Deleted)
Dec 12, 2019

In the axis2.xml file, there are two configuration sections: 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 profile of WSO2 Enterprise Integrator (WSO2 EI) without building them.

Content cannot be altered once the binary relay is enabled. Therefore, if you are enabling the binary relay, content-aware mediators should not be used.
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 profile of WSO2 EI to receive messages of the image/png content type, add the following configurations to the <EI_HOME>/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"/>

Related content

com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.