Contents

Introduction

Getting Started

Before beginning, check that there is the following directory structure and that you have all of the libraries on the ‘path’ (especially all the prerequisites). Below is a typical directory structure that you should expect to find if you have just downloaded and unzipped the package.

+- Axis

|    +- samples

|    |    +- client

|    |    |    +- calculator

|    |    |    |    +- Client.cpp

:    :    :    :

|    |    +- server

|    |    |    +- calculator

|    |    |    |    +- Calculator.cpp

:    :

|    +- deploy

|    |    +- wsdls

|    |    |    +- calculator.wsdl

:    :

|    +- lib

|    |    +- axis

|    |    |    +- wsdl2ws.jar

|    |    |    +- axis_client.lib or libaxis_client.so

|    |    |    +- axis_server.lib or libaxis_server.so
:    :

Note: The user must also have the correct level of Java on the build/test machine.

Creating the server side code

The first stage in creating the server side code is to create the server side stubs for the web service. This can be done very simply by using the Java application wsdl2ws.jar. This application will create both client and server side ‘stubs’ from which the user can create their web service application. (These ‘stubs’ remove the need for the user to have a deep understanding of how web services work, but the user should have some appreciation and at least a working knowledge of web service basics.) The key to web services is the WSDL file. This file contains a complete description of what methods are available in the service as well as the parameters names and types required by each method. In short, it provides a description of the interface. For this example, we will be using the calculator wsdl. In the following command line example, <inst_dir> is assumed to be the directory to which Axis was unzipped and <samp_dir> is assumed to be the directory in which the server side calculator sample is to be created. To create the server side stubs for the calculator sample, type the following at the command line:-

After running wsdl2ws, there should now be a new directory under the <samp_dir> called ‘Server’ which should contain 9 files as follows:-

AxisServiceException.cpp
AxisServiceException.hpp
Calculator.cpp
Calculator.hpp
CalculatorService.cpp
CalculatorWrapper.cpp
CalculatorWrapper.hpp
deploy.wsdd
undeploy.wsdd

Note: wsdl2ws will only generate files if they do not already exist. If the wsdl changes, the user must remember to delete the ‘old’ stubs before using wsdl2ws to generate the updated ones.

Building the server side code

Before building the server side you might want to familiarise yourself with the content of the generated files. In particular, the Calculator.cpp file which will contain the server side of the web service methods. If we concentrate on the ‘add’ method, the raw code produced by the stub is as follows:-

xsd__int Calculator::add(xsd__int Value0,xsd__int Value1)  
{
}

At present, the code will not compile because there is no ‘return’ value. Also, there is no method code content. Before the code has any use, the programmer will have to add the necessary program logic that the method is supposed to provide. In this case, it is to add the two numbers in the parameter list and return the result.
You can either add the content or use the already prepared Calculator.cpp file supplied in the <inst_dir>/samples/server/calculator directory.

xsd__int Calculator::add( xsd__int Value0, xsd__int Value1)
{
	return Value0 + Value1;
}

Once the logic within the Calculator.cpp file has been completed, the server side library can be built using the appropriate c/c++ compiler. Below are the compiler commands for each platform:-

Windows	Unix
cl *.cpp /GX /MD /D "WIN32" /I<inst_dir>/include /link<inst_dir>/lib/axis/axis_server.lib /DLL /OUT:"Calculator.dll"	gcc *.cpp -I <inst_dir>/include -L<inst_dir>/lib/axis/axis_server.so -o Calculator.so

After compilation, the appropriate library file should have been created.

Deploying the server side code

The SimpleAxisServer application uses a wsdd file to identify the connection between a web service name and the server library. The axiscpp.conf file contains a tag to identify the location of the wsdd file to be used by the server. The axiscpp.conf file can be found in the directory identified by the AXISCPP_DEPLOY environment variable. Below is the line containing the tag that identifies where the server wsdd file is located.

WSDDFilePath: <samp_dir>/Server/deploy.wsdd

The contents of the automatically generated deploy.wsdd file should be as follows:-

<?xml version="1.0" encoding="UTF-8"?>
<deployment xmlns=http://xml.apache.org/axis/wsdd/
            xmlns:CPP=http://xml.apache.org/axis/wsdd/providers/CPP>
    <service name="Calculator"
             provider="CPP:RPC"
             description="Axis C++ web service">
        <parameter name="className"
                  value="/user/local/apache/axis/Calculator.dll"/>
        <parameter name="allowedMethods"
                  value="add addRequest sub subRequest mul mulRequest div divRequest "/>
    </service>
</deployment>

Creating the client side code

The first stage in creating the client side code is to create the client side stubs for the web service. This can be done very simply by using the Java application wsdl2ws.jar. This application will create both client and server side ‘stubs’ from which the user can create their web service application. (These ‘stubs’ remove the need for the user to have a deep understanding of how web services work, but the user should have some appreciation and at least a working knowledge of web service basics.) The key to web services is the WSDL file. This file contains a complete description of what methods are available in the service as well as the parameters names and types required by each method. In short, it provides a description of the interface. For this example, we will be using the calculator wsdl. In the following command line example, <inst_dir> is assumed to be the directory to which Axis was unzipped and <samp_dir> is assumed to be the directory in which the client side calculator sample is to be created. To create the client side stubs for the calculator sample, type the following at the command line:-

Windows/Unix

java –classpath <inst_dir>/lib/axis/wsdl2ws.jar; <inst_dir>/lib/axisjava/axis.jar;<inst_dir>/lib/axisjava/commons-discovery.jar;<inst_dir>/lib/axisjava/commons-logging.jar;<inst_dir>/lib/axisjava/jaxrpc.jar;<inst_dir>/lib/axisjava/saaj.jar;<inst_dir>/lib/axisjava/wsdl4j.jar org.apache.axis.wsdl.wsdl2ws.WSDL2Ws <inst_dir>/deploy/wsdls/calculator.wsdl –sclient -o<samp_dir>/Client

After running wsdl2ws, there should now be a new directory under the <samp_dir> called ‘Client’ which should contain 2 files as follows:-

Calculator.cpp
Calculator.hpp

Building the client side code

Before building the client side you might want to familiarise yourself with the content of the generated files. In particular, the Calculator.cpp file which will contain the client side of the web service methods.

At present, there is no ‘client’ code, just the stub code. Before the stub code can be compiled, the programmer will have to provide a client program that will use one or more of the methods provided by the web service. In the following example, a client has been written that requires the function provided by the ‘add’ method in the calculator web service.

The client application writter can either provide their own client cpp file or use the already prepared Client.cpp file supplied in the <inst_dir>/samples/client/calculator directory, an extract from which follows:-

try
{
    Calculator	ws( “http://localhost:9080/axis/Calculator”);
    xsd__int	iValue1 = 25;
    xsd__int	iValue2 = 25;
    xsd__int	iResult = ws.add( iValue1, iValue2);
    xsd__int	iExpected = iValue1 + iValue2;

    cout << “Web Service:  ” << iValue1 << “ + “ << iValue2 << “ = “ << iResult << endl;
    cout << “Local Machine:” << iValue1 << “ + “ << iValue2 << “ = “ << iExpected << endl;
}
catch( AxisException & e)
{
    cout << "Axis Exception : " << e.what() << endl;
}
catch( exception & e)
{
    cout << "Exception : " << e.what() << endl;
}
catch( ...)
{
    cout << "Unknown exception " << endl;
}

Once the logic within the Client.cpp file has been completed, the client side executable can be built using the appropriate c/c++ compiler. Below are the compiler commands for each platform:-

Windows	Unix
cl *.cpp /GX /MD /D "WIN32" /I<inst_dir>/include /link<inst_dir>/lib/axis/axis_client.lib /OUT:"Calculator.exe"	gcc *.cpp -I <inst_dir>/include -L<inst_dir>/lib/axis/libaxis_client.so -o Calculator

After compilation, the appropriate executable file should have been created.

Running the client side code

With the SimpleAxisServer application already running and with the correct wsdd file deployed, the Calculator client application can now be run from the command line as follows:-

Windows	Unix
Calculator add 25 25 http://localhost:9080/axis/Calculator	./Calculator add 25 25 http://localhost:9080/axis/Calculator