NonStop SOAP 4.1 User's Manual

Developing NonStop SOAP 4 Clients Using Client APIs
This section describes the procedure to develop and deploy a NonStop SOAP 4 client using the
NonStop SOAP 4 client API. This section describes the procedure to develop a client for the math
service.
To develop NonStop SOAP 4 clients, use one of the following:
• The client API stack
The client API stack enables you to develop NonStop SOAP 4 clients manually. This approach
provides higher flexibility to customize the client applications based on your business
requirements.
• The WSDL2C tool
The WSDL2C tool is a Java-based tool that is distributed with NonStop SOAP 4. You can use
this tool to generate the client stub and service skeleton files in the C programming language,
based on the WSDL file for the service. Your application business logic must be integrated
with the stub files.
For most applications, the WSDL2C tool is used to generate the client stub files because you
need not write the basic interface code manually. For more information on the WSDL2C tool,
see “NonStop SOAP Tools” (page 194).
Developing and deploying NonStop SOAP 4 clients involves the following tasks:
• Generating NonStop SOAP 4 Client Stubs using the WSDL2C tool
• Implementing Business Logic in Client Stubs
• Compiling the Client Code and Deploying the Client
• Testing the Client
Generating NonStop SOAP 4 Client Stubs using the WSDL2C tool
To create client stubs using the WSDL2C tool, complete the following steps:
NOTE: Ensure that the WSDL file for your service is located at < NonStop SOAP 4
Deployment Directory>/services/< service_name>. If the WSDL file is not present,
to create a WSDL file for your service, use the SoapAdminCL tool. For information, see NonStop
SOAP 4 Configuration Files (page 177).
1. Set the OSS environment variable NSSOAP_HOME to the OSS location where the NonStop
SOAP 4 installation directory is located:
OSS> export NSSOAP_HOME=<NonStop SOAP 4 Installation Directory>
For example:
OSS> export NSSOAP_HOME=/usr/tandem/nssoap/t0865h01
where,
/usr/tandem/nssoap/t0865h01
is the NonStop SOAP 4 installation directory location.
2. Add the directory containing the WSDL2C executable image to the OSS PATH variable.
OSS> export PATH=<NonStop SOAP 4 Installation Directory>/tools:$PATH
For example:
OSS> export PATH=/usr/tandem/nssoap/t0865h01/tools:$PATH
3. Add the <Java Installation Directory>/bin directory to the PATH environment
variable, using the command:
OSS> export PATH=<Java Installation Directory>/bin:$PATH
Developing NonStop SOAP 4 Clients Using Client APIs 119