Address Endpoint

The Address endpoint is an endpoint defined by specifying the EPR (Endpoint Reference) and other attributes of the configuration.

XML configuration

Note

You can configure the Address Endpoint using XML. Click on the Switch to source view link in the Address Endpoint page.

<address uri="endpoint address" [format="soap11|soap12|pox|get"] [optimize="mtom|swa"]
    [encoding="charset encoding"]
    [statistics="enable|disable"] [trace="enable|disable"]>

    <enableSec [policy="key"]/>?
    <enableAddressing [version="final|submission"] [separateListener="true|false"]/>?

    <timeout>
        <duration>timeout duration in milliseconds</duration>
        <responseAction>discard|fault</responseAction>
    </timeout>?

    <markForSuspension>
        [<errorCodes>xxx,yyy</errorCodes>]
        <retriesBeforeSuspension>m</retriesBeforeSuspension>
        <retryDelay>d</retryDelay>
    </markForSuspension>

    <suspendOnFailure>
        [<errorCodes>xxx,yyy</errorCodes>]
        <initialDuration>n</initialDuration>
        <progressionFactor>r</progressionFactor>
        <maximumDuration>l</maximumDuration>
    </suspendOnFailure>
</address>

Address endpoint attributes

Attribute	Description
uri	EPR of the target endpoint.
format	Message format for the endpoint.
optimize	Method to optimize the attachments.
encoding	The charset encoding to use for the endpoint.
statistics	This enables statistics for the endpoint.
trace	This enables trace for the endpoint.

Other elements

QoS for the endpoint

QoS (Quality of Service) aspects such as WS-Security and WS-Addressing may be enabled on messages sent to an endpoint using enableSec and enableAddressing elements. Optionally, the WS-Security policies could be specified using the policy attribute.

QoS configuration

enableSec [policy="key"]	This enables WS-Security for the message which is sent to the endpoint. The optional `policy` attribute specifies the WS-Security policy.
enableAddressing [version="final \| submission"] [seperateListener=" true \| false"]	This enables WS-Addressing for the message which is sent to the endpoint. User can specify to have separate listener with version final or submission.

Endpoint timeout

The parameters available to configure an endpoint time out are as follows.

duration

Timeout duration that should elapse before the end point is timed out.

action

This parameter is used to specify the action to perform once an endpoint has timed out. The available options are as follows.

discard: If this is selected, the responses which arrive after the endpoint has timed out will be discarded.
fault: If this is selected, a fault is triggered when the endpoint is timed out.

You can specify a value that is 1 millisecond less than the time duration you specify for the endpoint time out for the synapse.timeout_handler_interval property in the <ESB_Home>/repository/conf/synapse.properties file. This would minimise the number of late responses from the backend.

Marking an endpoint for suspension

UI configuration

The following page is opened by clicking Address Endpoint in the Add Endpoint tab of the Manage Endpoints page.

The parameters available to configure the endpoint are as follows.

Parameter Name	Description
Name	The unique name of the endpoint.
Address	The URL of the endpoint. You can test the availability of the given URL by clicking Test.
Show Advanced Options	This section is used to enter advanced settings for the endpoint. The advanced options specific for the Address endpoint are as follows. Format- The message format for the endpoint. The available values are as follows. Leave As-Is: If this is selected, no transformation is done to the outgoing message. SOAP 1.1: If this is selected the message is transformed to SOAP 1.1. SOAP 1.2: If this is selected the message is transformed to SOAP 1.2. Plain Old XML (POX): If this is selected the message is transformed to plain old XML format. Representational State Transfer (REST) - If this is selected, the message is transformed to REST. GET: If this is selected, the message is transformed to a HTTP Get Request. Optimize- Optimization for the message, which transfers binary data. The available values are as follows. Leave As-Is - If this is selected, there will be no special optimization. The original message will be kept. SwA - If this is selected, the message is optimized as a SwA (SOAP with Attachment) message. MTOM - If this is selected, the message is optimized using a MTOM (message transmission optimization mechanism). Note The rest of the advanced options are common for Address, WSDL, Default endpoints. See the description of common options in Managing Endpoints.
Add Property	This section is used to add properties to an endpoint.