Sun Java System Application Server

Apache AXIS client for InteropHelloWorld application

This document describes how to compile and execute an Apache Axis Java client with the InteropHelloWorld web service. This document contains the following sections:

Overview
Building and Running the Axis client
Troubleshooting

Overview

Axis is an implementation of the Simple Object Access Protocol (SOAP) from the Apache Foundation. It includes a SOAP client that can access the InteropHelloWorld web service. To build and run the JAXRPC-Interop sample, You must have Axis 1.1 or later for this sample application.

To run the JAXRPC-Interop client, follow these steps:

Download Apache Axis.
Extract the contents of the Apache Axis archive file (zip or tar-gz file).
Create a /lib directory under install_dir/samples/webservices/interop
Copy following library files this /lib directory:
- axis.jar
- commons-discovery.jar
- commons-logging.jar

Building, Deploying, and Running the Application

The general instructions for building, deploying, and running sample applications are provided in Using Ant with Sample Applications. In reading this document, use the following application-specific variables for this application:

install_dir is the directory where Application Server is installed.
app_dir is the application base directory: install_dir/samples/webservices/interop/apps/axis-client.
appname is the application name: axisClient.

Follow this procedure:

In a command shell, change your working directory to the app_dir directory:
```
cd install_dir/samples/webservices/interop/apps/axis-client
```
Compile and assemble the client by executing the command asant. The default target will rebuild the axisClient.jar file.
Run the client by executing the command asant run.
The client sends the string "AXIS" to the InteropHelloWorld web service. The web service returns the following message to the client, which you will see in your command shell window:
```
You're talking to a Sun Web Service using AXIS client.
```

Troubleshooting

If you encounter errors while executing asant core or running the client, ensure the libraries axis.jar, commons-discovery.jar and commons-logging.jar are present in app_dir/lib directory.