NonStop SOAP 4.1 User's Manual

The adb_<messagename>_get_<complextype>() Function................................................118
Developing NonStop SOAP 4 Clients Using Client APIs.............................................................119
Generating NonStop SOAP 4 Client Stubs using the WSDL2C tool.........................................119
Implementing Business Logic in Client Stubs.........................................................................121
Compiling the Client Code and Deploying the Client............................................................121
Compiling the Client Code using the Makefile.................................................................121
Compiling the Client Code manually.............................................................................122
Testing the Client.............................................................................................................123
7 Customizing NonStop SOAP 4 Message Processing....................................124
Overview............................................................................................................................124
Modules and Handlers.....................................................................................................124
Message Receiver User Functions.......................................................................................125
NonStop SOAP 4 Message Processing Customization...........................................................125
Customizing the NonStop SOAP 4 Message Process Using Handlers...........................................126
Request Processing in NonStop SOAP 4..............................................................................127
Flows.........................................................................................................................127
Phases.......................................................................................................................128
Pre-defined phases in inflow....................................................................................128
User-defined phases in inflow...................................................................................129
Pre-defined phases in outflow...................................................................................129
User-defined phases in outflow.................................................................................130
Handlers....................................................................................................................130
Modules....................................................................................................................130
Creating a User-Defined Phase..........................................................................................131
Deploying and Attaching a Module...................................................................................132
Developing a Sample Module for NonStop SOAP 4.............................................................132
Running the SoapAdminCL Tool to Generate the Module Handler Stub Files.......................133
Implementing the Business Logic in the Module Handler Stub Files.....................................134
Implementing the invoke() Method for loggingInHandler..............................................134
Implementing the invoke() Method for loggingOutHandler...........................................134
Engaging the Module Handler at the Service Level..........................................................136
Verifying the Module Handler Output............................................................................137
Customizing the NonStop SOAP 4 Message Process Using Message Receiver User Functions.........137
Configuring NonStop SOAP 4 Message Receiver User Functions............................................138
Configuring NonStop SOAP 4 Message Receiver User Functions at the service level.............138
Configuring NonStop SOAP 4 Message Receiver User Functions at the global level.............138
Modifying the Data Buffer Passed to the Service using NonStop SOAP 4 Message Receiver User
Functions........................................................................................................................139
Setting the pre_service and pre_marshal Message Receiver User Functions.........................139
Creating an instance of the Message Receiver User Function structure............................139
Setting pre_service and pre_marshal function names...................................................140
Implementing the pre_service and pre_marshal Message Receiver User Functions................141
Modifying the Pathway or Process Attributes using NonStop SOAP 4 Message Receiver User
Functions........................................................................................................................143
The axis2_msg_recv_get_pathmonName()Function..........................................................143
The axis2_msg_recv_get_serverclassName()Function........................................................143
The axis2_msg_recv_get_serviceName()Function.............................................................144
The axis2_msg_recv_get_operationName()Function.........................................................144
The axis2_msg_recv_get_processName()Function............................................................145
The axis2_msg_recv_set_pathmonName()Function...........................................................145
The axis2_msg_recv_set_serverclassName()Function........................................................145
The axis2_msg_recv_set_serviceName()Function..............................................................146
The axis2_msg_recv_set_operationName()Function..........................................................146
The axis2_msg_recv_set_processName()Function.............................................................147
6 Contents