This documentation is for WSO2 ESB version 4.5.0. View documentation for the latest release.

Message Relay Module Policy

Syntax of Relay Module Policy.

<wsp:Policy wsu:Id="MessageRelayPolicy" xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
                xmlns:wsmr="http://www.wso2.org/ns/2010/01/carbon/message-relay"
                xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <wsmr:RelayAssertion>
            <wsp:Policy>
                <wsp:All>
                    <wsmr:includeHiddenServices>false | false</wsmr:includeHiddenServices>
                    <wsmr:services>
                        <wsmr:service>Name of the service</wsmr:service>*
                    </wsmr:services>
                    <wsmr:builders>
                        <wsmr:messageBuilder contentType="content type of the message" class="message builder implementation class" class="message formatter implementation class"/>
                    </wsmr:builders>
                </wsp:All>
            </wsp:Policy>
        </wsmr:RelayAssertion>
</wsp:Policy>

These are the assertions:

  • includeHiddenServices - If this is true message going to the services with hiddenService parameter will be built.
  • wsmr:services - Messages going to these services will be built.
  • wsmr:service - Name of the service.
  • wsmr:builders - Message builders to be used for building the message.
  • wsmr:builder - A message builder to be used for a content type.

Note

After changing the policy, user has to restart the ESB for changes to take effect.

Note

If the Message Relay is enabled for particular content type, there cannot be services with security enabled for that content type. This applies to services with reliable messaging as well.