NonStop SOAP 4.1 User's Manual

7 Customizing NonStop SOAP 4 Message Processing
NonStop SOAP 4 processes a request based on the default message process. This chapter provides
information on customizing the default NonStop SOAP 4 message process using Phases, Modules,
Handlers, and Message Receiver User Functions.
This chapter describes the following topics:
• “Overview” (page 124)
• “Customizing the NonStop SOAP 4 Message Process Using Handlers” (page 126)
• “Customizing the NonStop SOAP 4 Message Process Using Message Receiver User Functions”
(page 137)
Overview
You can customize NonStop SOAP 4 using:
• “Modules and Handlers” (page 124)
• “Message Receiver User Functions” (page 125)
Figure 11 Customizing NonStop SOAP 4
iTP Webserver
Web Service
Message Receiver User Functions
Modules and Handlers
XML
Buffer
CGI Interface and
NonStop SOAP 4
Engine
Pathway Message
Receiver
Modules and Handlers
Modules and handlers are the user-written plug-ins that attach to the NonStop SOAP 4 engine
during different stages in the SOAP message process and modify the SOAP message headers.
Modules and handlers interrupt the default process of the SOAP message inside NonStop SOAP
4 and change the SOAP message. Modules and handlers can be attached at the global level,
which means that the handlers are called for every service invocation in a NonStop SOAP 4
deployment, or at the service level, which means that the handlers are called only when a particular
service in invoked.
For more information on modules and handlers, see “Request Processing in NonStop SOAP 4”
(page 127).
124 Customizing NonStop SOAP 4 Message Processing