NonStop SOAP User's Manual

Customizing the SOAP Server

NonStop SOAP User’s Manual—520501-012

8-2

Customization Using User-user-exits

You can customize SOAP servers accessing TS/MP services or NonStop processes

using the code generation feature of the SOAP Admin tool.

The code generated and exposed for customization is in the form of user-exits. User-

exits are specific exit points in the SOAP server's predefined flow of processing a

SOAP message (from a request to its response), where you are allowed to add code

as per the customization required for SOAP server to run.

Using the SOAP Admin tool, you can generate user-exit class header (*.h) and

implementation (*.cpp) files. The user-exit code is generated based on the value of

the GenerateUserExits attribute at each Service element level in the SDL.

The GenerateUserExits attribute is available at the Service Element level. Only

one of the attributes, Generate or GenerateUserExits can have a value of "yes,"

otherwise the SOAP Admin tool generates an error message.

The SOAP Admin tool generates code for these methods, as appropriate, for

generated classes:

•

A pre_process() method allows you to modify the input XML/SOAP document

sent from the client.

•

A pre_service() method allows you to modify the request buffer using methods

in the class ServiceReqResponse.

•

A pre_marshal() method allows you to modify the response buffer using

methods in the class ServiceReqResponse.

•

A pre_marshal_header() method allows you to modify the output XML

document.

•

A post_process() method allows you to modify the XML/SOAP response to

the client.

The source and header files for each service with user-exits.

Figure 8-1 on page 8-3 is a class diagram for user-exit classes.