How to Use axis2.xml Instead of Apache AXIS2/C Repository

Apache Axis2/C engine uses a client repository to load its libraries, modules and services. Generally user has to specify this repository using AXIS2C_HOME environment variable. Rather than having all (libraries, modules and services) in one directory, user can specify them using axis2.xml. Dinesh Premalal, explains..

Table of Content

1. Additional Parameters
2. Server Side
3. Client Side

Applies To

Additional Parameters

There are three additional parameters we have to specify in axis2.xml. These "parameter" elements need to add to axis2.xml as children of "axisconfig" element.

• libDir

  This parameter has a pointer to the directory which contains the Axis2/C libraries.

  <parameter name="libDir">/home/dinesh/axis2c/deploy/lib</parameter>

   

• servicesDir

  This parameter has a pointer to the directory which contains Axis2/C services. To load services we need to specify this parameter:

  <parameter name="servicesDir">/home/dinesh/axis2c/deploy/services</parameter>

   

• moduleDir

  The directory that contains module libaries is pointed by this parameter:

  <parameter name="moduleDir">/home/dinesh/axis2c/deploy/modules</parameter>

   

Server Side

On the server side, axis2.xml can be used in two ways instead of Axis2/C repository.

• Using AXIS2C_HOME environmental variable

  Use path to axis2.xml file instead of Axis2/C repository directoty, for AXIS2C_HOME environmental variable. Then, Axis2/C engine will be able to pick up the libraries, services and modules using above mentioned parameters:

  export AXIS2C_HOME=/home/dinesh/axis2c/deploy/axis2.xml

• "-r" option in axis2_http_server

  Use an option in axis2_http_server

  $./axis2_http_server -r /home/dinesh/axis2c/deploy/axis2.xml [other options]

NOTE: This method is not yet tested with mod_axis2, therefore might not work with it.

 

Client Side

On the client side too user has two ways of specifying axis2.xml, instead of a repository directory

• Using AXIS2C_HOME environmental variable

  Use path to axis2.xml file, instead of Axis2/C repository directory, for AXIS2C_HOME environmental variable and then Axis2/C engine will be able to pick up libraries, services and modules using above mentioned parameters.

• Using Client API

  One could even use client api to specify axis2.xml file path:

  client_home = "/home/dinesh/axis2c/deploy/axis2.xml"
    /* Create service client */
    svc_client = axis2_svc_client_create(env, client_home);

   

Author

Dinesh Premalal, Senior Software Engineer, WSO2 Inc. dinesh AT wso2 DOT com