Generic Properties
Here is the list of the generic properties.
Property: synapse.isresponse
Name | synapse.isresponse |
---|---|
Possible Values | "true", "false" |
Default Behavior | none |
Scope | axis2 |
Description | Once this property is set to 'true" on a message, the ESB will start treating it as a response message. It is generally used to route a request message back to its source as the response. |
Example | <property name="synapse.isresponse" value="true" scope="axis2"/> |
Property: PRESERVE_WS_ADDRESSING
Name | PRESERVE_WS_ADDRESSING |
---|---|
Possible Values | "true", "false" |
Default Behavior | none |
Scope | synapse |
Description | By default, the ESB adds a new set of WS-Addressing headers to the messages forwarded from the ESB. If this property is set to " |
Example | <property name="PRESERVE_WS_ADDRESSING" value="true"/> |
Property: RESPONSE
Name | RESPONSE |
---|---|
Possible Values | "true", "false" |
Default Behavior | none |
Scope | synapse |
Description | The same as |
Example | <property name="RESPONSE" value="true"/> |
Property: OUT_ONLY
Name | OUT_ONLY |
---|---|
Possible Values | "true", "false" |
Default Behavior | none |
Scope | synapse |
Description | Set this property to "true" on a message to indicate that no response message is expected for it once it is forwarded from the ESB. In other words, the ESB will do an out-only invocation with such messages. It is very important to set this property on messages that are involved in out-only invocations to prevent the ESB from registering unnecessary callbacks for response handling and eventually running out of memory. |
Example | <property name="OUT_ONLY" value="true"/> |
Property: ERROR_CODE
Name | ERROR_CODE |
---|---|
Possible Values | string |
Default Behavior | none |
Scope | synapse |
Description | Use this property to set a custom error code on a message which can be later processed by a Synapse fault handler. If the Synapse encounters an error during mediation or routing, this property will be automatically populated. |
Example | <property name="ERROR_CODE" value="100100"/> |
Property: ERROR_MESSAGE
Name | ERROR_MESSAGE |
---|---|
Possible Values | string |
Default Behavior | none |
Scope | synapse |
Description | Use this property to set a custom error message on a message which can be later processed by a Synapse fault handler. If the Synapse encounters an error during mediation or routing, this property will be automatically populated. |
Example | <log level="custom"> <property name="Cause" expression="get-property('ERROR_MESSAGE')"/> </log> |
Property: ERROR_DETAIL
Name | ERROR_DETAIL |
---|---|
Possible Values | string |
Default Behavior | none |
Scope | synapse |
Description | Use this property to set the exception stacktrace in case of an error. If the ESB encounters an error during mediation or routing, this property will be automatically populated. |
Example | <log level="custom"> <property name="Trace" expression="get-property('ERROR_DETAIL')"/> </log> |
Property: ERROR_EXCEPTION
Name | ERROR_EXCEPTION |
---|---|
Possible Values | java.lang.Exception |
Default Behavior | none |
Scope | synapse |
Description | Contains the actual exception thrown in case of a runtime error. |
Property: TRANSPORT_HEADERS
Name | TRANSPORT_HEADERS |
---|---|
Possible Values | java.util.Map |
Default Behavior | Populated with the transport headers of the incoming request. |
Scope | axis2 |
Description | Contains the map of transport headers. Automatically populated. Individual values of this map can be accessed using the property mediator in the transport scope. |
Example | <property name="TRANSPORT_HEADERS" action="remove" scope="axis2"/> |
Property: messageType
Name | messageType |
---|---|
Possible Values | string |
Default Behavior | Content type of incoming request. |
Scope | axis2 |
Description | Message formatter is selected based on this property. This property should have the content type, for example, text/xml, application/xml. |
Example | <property name="messageType" value="text/xml" scope="axis2"/> |
Property: ContentType
Name | ContentType |
---|---|
Possible Values | string |
Default Behavior | Value of the Content-type header of the incoming request. |
Scope | axis2 |
Description | Message builder is selected based on this property. This property should specify the content type. |
Example | <property name="ContentType" value="text/xml" scope="axis2"/> |
Property: disableAddressingForOutMessages
Name | disableAddressingForOutMessages |
---|---|
Possible Values | "true", "false" |
Default Behavior | false |
Scope | axis2 |
Description | Set this property to "true" if you do not want the ESB to add WS-Addressing headers to outgoing messages. This property can affect messages sent to backend services as well as the responses routed back to clients. |
Example | <property name="disableAddressingForOutMessages" value="true" scope="axis2"/> |
Property: ClientApiNonBlocking
Name | ClientApiNonBlocking |
---|---|
Possible Values | "true", "false" |
Default Behavior | true |
Scope | axis2 |
Description | By default, Axis2 spawns a new thread to handle each outgoing message. This property holds the primary thread until a VFS proxy writes to a VFS endpoint. You need to remove this property from the message to change this behavior when queuing transports like JMS are involved. |
Example | <property name="ClientApiNonBlocking" action="remove" scope="axis2"/> |
Property: endpoint.operation
Name | endpoint.operation |
---|---|
Possible Values | string |
Default Behavior | none |
Scope | synapse |
Description | If this property is set, endpoint statistics will be calculated for the specified operation. |
Example | <property name="endpoint.operation" scope="axis2" value="OperationName"/> |