NonStop SOAP User's Manual

Customizing the SOAP Server
NonStop SOAP User’s Manual—520501-012
8-4
User-Exit Classes
User-Exit Classes
The user-exit classes described in this section are used at runtime by a SOAP server.
There are two types of classes:
•
Some classes are part of the SOAP library; the header files for these classes are in
the NonStop SOAP /include directory. These classes take part in accessing a
particular service.
•
Other classes are generated by the SOAP Admin tool.
The prebuilt SOAP server includes the classes of the SOAP library.
Some information about user-exits is:
•
User-exits generic functionality (if implemented in the SoapUEHandler_Generic
class) must be run for all the generated code.
•
The implemented methods have to return a failure or success value.
•
A value of zero signifies successful completion of a method and a nonzero value is
a failure.
Some information about NonStop SOAP faults is:
•
Using specified SOAP faults is considered only when a method returns a nonzero
(failure) value.
•
When the fault values are set by the user then those values are in the response
SOAP fault message. Otherwise, an “Internal Server Error,” SOAP fault is returned
by default.
•
Fault code has to be set to Client or Server or it defaults to “Server.”
The class descriptions on these pages are in pseudo-code. For more information about
each class, see the inline comments in the header files, which are in the NonStop
SOAP /include directory.