Select Page

Playing with Axis C++ and Apache 1.3.1

Playing with Axis C++ and Apache 1.3.1

Here is a How to since it take me a very long time to install something which should have been trivial….
For the benefit of the community, I am publishing it here on my free time 🙂 … Enjoy…

Apache Axis and Apache Axis C++ are implementation of the SOAP ("Simple Object Access Protocol") submission to W3C. From the W3C draft specification:

SOAP is a lightweight protocol for exchanging structured information in a decentralized, distributed environment. It is an XML based protocol that consists of three parts: an envelope that defines a framework for describing what is in a message and how to process it, a set of encoding rules for expressing instances of application-defined datatypes, and a convention for representing remote procedure calls and responses.

Axis C/C++ (Axis CPP) is a non-Java implementation of Axis. At its core Axis CPP has a C++ runtime engine. The provided tooling allows you to create C++ client-side stubs and server-side skeletons. The server skeletons can be deployed to either a full Apache web server using the supplied apache module or a "simple_axis_server" – which is a simple HTTP listener (designed to help you test your services).


1. Download either Apache 2.0 or Apache 1.3
unpack it to c:\apache

2. Download the latest version of Axis C++
unpack it to c:\axis

Note: try to avoid space in path, it has always been proved to be a mess under Windows.

3. Open  and add following lines at the end of Apache config file

Apache 1.3

in c:\apache\conf\http.conf

Apache 2.0

in c:\apache\conf\http.conf

LoadModule axis_module ../axis/lib/modules/mod_axis.dll
<Location /axis>
SetHandler axis
</Location>
LoadModule axis_module ../axis/lib/mod_axis2.dll
<Location /axis>
SetHandler axis
</Location>

4. Now it is starting to be interesting, both mod_axis.dll  and mod_axis2.dll have dependencies to an old dll which do no more exist since windows 98 ! msjava.dll

You need to copy from Internet msjava.dll into c:\axis\lib
You also need to copy the xerces parser xerces-c_2_2_0.dll  into c:\axis\lib

Axiss C++ required library in lib directory

5. Create a file axiscpp.conf (or search in zip distributions for a template of it) and copy it into c:\axis
Modify all path to DLL accordingly. Note that relative path or absolute path also work.

Example of  axiscpp.conf
# The comment character is ‘#’
#Available directives are as follows
#(Some of these directives may not be implemented yet)
#
#WSDDFilePath:The path to the server wsdd
#LogPath:The path to the axis log
#ClientLogPath:The path to the axis client log
#ClientWSDDFilePath:The path to the client wsdd
#Transport_http:The HTTP transport library
#Transport_smtp:The SMTP transport library
#XMLParser:The xml parser library
#NodeName:Node name
#ListenPort:Listening port
#Channel_HTTP:The HTTP transport channel library
#Channel_HTTP_SSL:The HTTP transport secure channel library

LogPath:c:\axis\logs\AxisLog.txt
WSDDFilePath:c:\axis\conf\server.wsdd
XMLParser:c:\axis\lib\AxisXMLParser.dll
Transport_http:c:\axis\lib\HTTPTransport.dll
Channel_HTTP:c:\axis\lib\HTTPChannel.dll
Channel_HTTP_SSL:c:\axis\lib\HTTPSSLChannel.dll

6. Go into c:/apache and create a small batch file there 

example of start script for Apache startApache.bat
SET AXIS_HOME=c:\axis
SET AXISCPP_DEPLOY=c:\axis
SET PATH=%PATH%;c:\axis\lib
SET LIB_PATH=%LIB_PATH%;c:\axis\lib

apache.exe
pause

7. create a file in c:\axis\conf\server.wsdd

Example of c:\axis\conf\server.wsdd
<?xml version="1.0" encoding="UTF-8"?>
<!– The Entity, wspath in the following internal subset allows setting a
     path for the webservices location –>
<!DOCTYPE vars [ <!ENTITY wspath "/home/sanjaya/Axis/webservices/"> ]>

<deployment xmlns="http://xml.apache.org/axis/wsdd/"
            xmlns:C="http://xml.apache.org/axis/wsdd/providers/C"
            xmlns:CPP="http://xml.apache.org/axis/wsdd/providers/CPP">
    <globalConfiguration>
    </globalConfiguration>
    <service name="transportProperties"
             provider="CPP:DOCUMENT"
             description="This is a simple test">
        <parameter name="className"
                   value="c:\axis\dll\calculator.dll"/>
        <parameter name="allowedMethods" value="add subtract"/>
    </service>
</deployment>

Use script 6.  to start Apache, if you get an exception, read it or verify DLL dependencies with DLL dependency walker

Go In a Browser and type http://localhost/axis

Axis-cpp-Working-in-apache

About The Author

I worked with various Insurances companies across Switzerland on online applications handling billion premium volumes. I love to continuously spark my creativity in many different and challenging open-source projects fueled by my great passion for innovation and blockchain technology.In my technical role as a senior software engineer and Blockchain consultant, I help to define and implement innovative solutions in the scope of both blockchain and traditional products, solutions, and services. I can support the full spectrum of software development activities, starting from analyzing ideas and business cases and up to the production deployment of the solutions.I'm the Founder and CEO of Disruptr GmbH.

Categories