NonStop SOAP 4.1 User's Manual

13 Using the Contract-First Approach in NonStop SOAP 4
You can use the following approaches to develop client applications and services in NonStop
SOAP 4:
• Contract-first Approach - In this approach, the contract (WSDL file) is defined first, which states
the type of service interface description that the service expects. The service code is generated
based on this information.
• Service-first Approach -In this approach, the service code is written first and the contract (WSDL
file) is generated from the written code.
This chapter describes the procedure to develop a Web service using the contract-first development
approach and includes the following topics:
• “NonStop SOAP 4 Tools for Developing Web Services Using the Contract-First Approach”
(page 260)
• “WSDL Considerations” (page 260)
• “Developing a NonStop SOAP 4 Pathway Web Service Using the WSDL2PWY Tool” (page 262)
• “Developing a NonStop SOAP 4 Non-Pathway Web Service Using the WSDL2C Tool” (page 270)
NonStop SOAP 4 Tools for Developing Web Services Using the
Contract-First Approach
NonStop SOAP 4 provides the following tools to develop Web services using the contract-first
approach:
• WSDL2PWY – The WSDL2PWY tool uses a WSDL file as input to generate client stubs and
Pathway service skeleton files. The Pathway service skeleton files are used to generate a
Pathway application that can be deployed as a Web service in NonStop SOAP 4.
The WSDL2PWY tool must be used when developing services implemented as Pathway
applications.
• WSDL2C – The WSDL2C tool uses a WSDL file as input to generate the client stubs and service
skeleton files. The generated service skeleton files implement the basic interface code required
while developing a service using NonStop SOAP 4 service APIs.
The WSDL2C tool must be used when developing services implemented as DLLs using NonStop
SOAP 4 service APIs.
For more information about NonStop SOAP 4 tools, see Chapter 10: “NonStop SOAP Tools”
(page 194).
WSDL Considerations
To develop client applications and services using the contract-first approach, you can use a
pre-defined contract (WSDL file).
Using a Pre-defined WSDL File
To generate the service skeleton files, you can provide a pre-defined WSDL file as an input to
WSDL2PWY tool. The WSDL2PWY tool accepts any WSDL file that conforms to the World Wide
Web Consortium (W3C) standards. WSDL versions 1.1 and 2.0 are supported.
NOTE: The NonStop SOAP 4 server does not support or provides limited support for some WSDL
file elements for the services deployed in Pathway applications.
Table 21 lists the WSDL file elements that are not supported by the NonStop SOAP 4 server.
260 Using the Contract-First Approach in NonStop SOAP 4