NonStop SOAP User's Manual

NonStop SOAP User-Exits
NonStop SOAP User’s Manual—520501-012
C-3
Nonstop Soap Server Normal Processing Flow
modified if necessary to match the format expected by the service provider. The
Service() function then sends the Service Request buffer to the service provider.
The service provider processes the request and returns a response (the Service
Response buffer). The Service() function receives the Service Response buffer
and modifies it if necessary to create the SOAP Response structure according to
the DDL response definition for the service. The SOAP Response structure is then
passed to the Marshal() function.
Marshal()
The SOAP Response structure is then marshaled into the SOAP Response XML
document and returned to the Process() function.
Process()
On the return, the Process() function receives the SOAP Response XML document
from the Marshal() function, verifies that the SOAP response is well formed, and
returns it to the service consumer.
The following details will help to clarify the various message structures used by the
NonStop SOAP server:
•
The SOAP Request and Response XML documents are passed between the
service consumer and the NonStop SOAP server, and are defined by the WSDL
for the service provider.
•
The SOAP Request and Response structures are only used internally by the
NonStop SOAP server and are defined by the DDL for the service provider.
•
The Service Request and Response buffers are passed between the NonStop
SOAP server and the service provider, and are defined by the service provider. In
many cases, the SOAP Request and Response structures, and the Service
Request and Response buffers will be the same.
A key requirement of the NonStop SOAP server-processing mechanism is addressed
at design time. In order to be able to map the external SOAP Request and Response
XML documents to and from the internal Service Request and Response buffers
expected by the service provider, the Service Request and Response buffers must be
defined in DDL format. These DDL definitions are provided when the service is
configured to NonStop SOAP.
Using the DDL definitions, the NonStop SOAP server is able to generate a WSDL
description for the service, as well as map the SOAP Request and Response XML
documents to and from the corresponding fields in the Service Request and Response
buffers. In this way, the NonStop SOAP server is able to perform the SOA service
adapter role of exposing (“wrapping”) the service provider as a standard SOA service,
regardless of and without any need to change the service provider implementation.