NonStop SOAP 4.1 User's Manual

NonStop SOAP Administration Utility
The NonStop SOAP Administration Utility (T0904) is a Java-based GUI tool that provides functionality
to create and deploy the service definition language (SDL) file from a remote system such as
Microsoft Windows. For more information about the NonStop SOAP 4 Administration Utility, see
“NonStop SOAP Tools” (page 194).
SOAP Clients
The WSDL2C tool can also be used to generate SOAP clients in the C programming language. The
SOAP clients developed using the WSDL2C tool can communicate with any SOAP service on any
platform. For more information on building SOAP clients using the WSDL2C tool, see “NonStop
SOAP 4 Client APIs” (page 105).
Figure 2 shows generation of SOAP clients and their capabilities.
Figure 2 SOAP Clients and their Capabilities
WSDL File
WSDL 2C Tool
Code generation files
SOAP service on
other platforms
SOAP service on
NonStop platforms
Business Logic
SOAP Client on
NonStop platform
The WSDL2C tool generates most of the code to create the SOAP client from the WSDL file. You
must add business logic to the generated code and build the SOAP client.
The SOAP clients generated using the WSDL2C tool can communicate with SOAP services running
on NonStop platforms and other platforms.
Request Processing in NonStop SOAP
NonStop SOAP 4 communicates with the client using the SOAP protocol.
A SOAP message is a well formed XML message that includes:
• An XML declaration (optional)
• A SOAP envelope (the root element) made up of the following:
SOAP Header (optional)◦
◦ SOAP Body
The SOAP envelope must use the SOAP 1.1 or SOAP 1.2 envelope namespace. A SOAP header
is used to transmit data that is not part of the SOAP protocol, but includes transaction-related
information or security-related information. The SOAP body element encapsulates the operation
name and data in the format specified by the WSDL file for the service.
Figure 3 shows a typical SOAP message sent through HTTP.
NOTE: In Figure 3 and Figure 4, all shades of green represent the XML part of the message and
the grey shade represents non-XML part of the message.
32 Introduction to NonStop SOAP