NonStop SOAP 4.1 User's Manual

MessageOut
This phase executes the transport handlers from the associated transport configuration. The last
handler is always a transport sender that sends the SOAP message to the target endpoint.
The handlers attached to the MessageOut phase can access the response message. Handlers
attached to this phase perform the following tasks:
• Modify the response buffer
• Modify the response XML
Transport
This phase is part of the inflow and outflow. In the outflow, it adds HTTP-specific header
elements to the SOAP response message received from the MessageOut and forwards it to the
iTP WebServer.
User-defined phases in outflow
You can define phases in the outflow either before or after the MessageOut phase.
The handlers attached to the User-Defined phase can access the response message. Handlers
attached to this phase perform the following tasks:
• Modify the response buffer
• Modify the response XML
For example:
<phaseOrder type="outflow">
<phase name="myPhase1"/>
<phase name="MessageOut"/>
<phase name="myPhase2"/>
</phaseOrder>
where,
myPhase1 and myPhase2
are user-defined phases.
Handlers
A handler is the smallest unit of invocation within a phase. Handlers are an independent unit of
execution that perform specific activities, such as logging a message, consuming addressing
headers, and so on.
Phases define the handlers that need to be invoked in each phase and the sequence of invocation
based on the sequence defined in the module.xml configuration file.
Modules
A module is a collection of one or more handlers along with their configuration information, such
as handler names, the phase in which they must be invoked, and so on. You can use modules to
customize end the behavior of the NonStop SOAP 4 server by adding new handlers to the phases.
NOTE: Handlers and modules cannot be used to modify or extend the default behavior of a
message receiver.
A module includes the module.xml configuration file that determines the sequence of the handlers
in a phase. Each NonStop SOAP 4 module is configured using its module.xml file located in
the <NonStop SOAP 4 Deployment Directory>/modules/<module_name> directory.
When configuring a module, you must place the handlers in the pre-defined phase or user-defined
phase of the NonStop SOAP 4 server.
The following is a sample module.xml file for a module that includes four handlers:
130 Customizing NonStop SOAP 4 Message Processing