NonStop SOAP 4.1 User's Manual

5. On successful execution, the following service skeleton files are generated:
• The NonStop SOAP 4 skeleton source file, where the axis2_svc_skeleton interface
functions are implemented
• The service skeleton source file, where you must implement the business logic for your
application
• Header file for the service skeleton file
For example, for the math service, the following files are generated in the <NonStop SOAP
4 Deployment Directory>/services/math/ directory:
• axis2_svc_skel_mathService.c
• axis2_skel_mathService.c
• axis2_skel_mathService.h
Implementing the Business Logic in the Service Skeleton Files
After you generate the service skeleton and client stub files for the service, you must implement the
business logic.
For example, for the math service, you need to implement the business logic in the
axis2_skel_mathService.c file. To add the business logic for the add operation, update the
axis2_skel_mathService_add()function.
A sample implementation of the axis2_skel_mathService_add() is available in the <NonStop
SOAP 4 Installation Directory
>/sample_services/math/service/axis2_skel_mathService.c file. If you do not
want to edit the source files, you can replace the <NonStop SOAP 4 Deployment
Directory>/services/math/src/axis2_skel_mathService.c file with the <NonStop
SOAP 4 Installation
Directory>/sample_services/math/service/axis2_skel_mathService.c file, which
implements the business logic for all the math operations.
Compiling the Service Code and Deploying the Service
After you implement the business logic in the service skeleton file, you must deploy the service.
To deploy the service complete the following steps:
1. Copy the Makefile from the <NonStop SOAP Installation
Directory>/sample_services/math/service directory to the <NonStop SOAP
Deployment Directory>/services/math/src directory.
2. Set AXIS2C_HOME to <NonStop SOAP 4 Deployment Directory> using the following
command:
OSS> export AXIS2C_HOME=<NonStop SOAP 4 Deployment Directory>
3. Run the make command to build the libmath.so DDL file:
OSS> make
The make command copies the libmath.so file to the <NonStop SOAP 4 Deployment
Directory>/services/math directory.
4. Ensure that the services.xml and the service DLL (.so) files are located in the <NonStop
SOAP 4 Deployment Directory>/services/math directory.
OSS> cd <NonStop SOAP 4 Deployment Directory>/services/<service_name>
OSS> ls
libmath.so services.xml
The math service is deployed in NonStop SOAP 4. To access the service WSDL, go to the
following Web address:
http://< ip address>:< port number>/url_pattern/services/math?wsdl
102 NonStop SOAP 4 Service APIs