用Axis开发基于Java的Web服务

概述

　　本文介绍了一个比较简单实用的基于Java的SOAP引擎——Apache组织推出的Axis——的安装、配置和应用开发方法，希望对有兴趣做基于Java的Web Services应用开发的朋友有所帮助。

Axis简介

Axis是Apache组织推出的SOAP引擎，Axis项目是Apache组织著名的SOAP项目的后继项目，目前最新版本是采用Java开发的1.4版本，C++的版本正在开发之中。Axis v1.4软件包可以从http://apache.justdn.org/ws/axis/下载得到。

Axis的安装

应用Axis开发Web Services，你需要有一个支持Servlet的服务器引擎，比如广为人知的Tomcat。当安装好Tomcat之后，只需将下载的Axis软件包解压缩，将其中的“webapps”目录下的“axis”目录整个拷贝到Tomcat安装目录下的“webapps”目录下即可。

Axis的配置

Axis基于Java开发，可以部署于多种操作系统，使用前需要配置一系列的系统变量，在此假定你已经在本机上装好了Tomcat，需要配置的系统变量如下表所示：
AXIS_HOME 即axis解压的目录（我的是在D:JServeraxis-1_4）
AXIS_HOME=D:JServeraxis-1_4

AXIS_LIB=%AXIS_HOME%lib

AXISCLASSPATH=%AXIS_LIB%axis.jar;%AXIS_LIB%axis-ant.jar;%AXIS_LIB%commons-discovery-0.2.jar;%AXIS_LIB%commons-logging- 1.0.4 .jar;%AXIS_LIB%jaxrpc.jar;%AXIS_LIB%log4j-1.2.8.jar;%AXIS_LIB%saaj.jar;%AXIS_LIB%wsdl4j-1.5.1.jar;%AXIS_LIB%tools.jar;%AXIS_LIB%activation.jar;%AXIS_LIB%mail.jar;

如果你不愿做这么繁琐的类路径设置，可以直接将axis软件包中“lib”目录下的所有.jar文件加入到系统环境变量CLASSPATH中即可。

实验一下

在%AXIS_HOME%webapps下找到axis文件夹，需要加入三个包 activation.jar、mail.jar、tools.jar,然后将其整个拷贝到%TOMCAT_HOME%webapps下，
启动Tomcat,打开浏览器访问http://localhost:8080/axis/，出现以下页面说明你配置成功了

发布我们的第一个程序

第一个程序简单的返回HELLO WORLD！
HelloWorldjava

public class HelloWorld {
public String sayHello()
{
return "HELLO WORLD!";
}
}

我们的第一种发布方式：

将HelloWorld.java拷贝到%TOMCAT_HOME%webappsaxis下,然后将其改名为HelloWorld.jws,这样AXIS就自然将其发布了.现在写个客户端程序访问一下：

TestClient.java

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

import javax.xml.rpc.ParameterMode;

public class TestClient
{
public static void main(String [] args) throws Exception {

String endpoint = "http://localhost:" +"8080"+ "/axis/HelloWorld.jws";//指明服务所在位置

Service service = new Service(); //创建一个Service实例，注意是必须的！
Call call = (Call) service.createCall();//创建Call实例，也是必须的！

call.setTargetEndpointAddress( new java.net.URL(endpoint) );//为Call设置服务的位置

call.setOperationName( "sayHello" );//注意方法名与HelloWorld.java中一样！！

String res = (String) call.invoke( new Object[] {} );//返回String，没有传入参数

System.out.println( res );
}
}

我们的第二种发布方式：

1、将HelloWorld.java编译成HelloWorld.class,放到%TOMCAT_HOME%webappsaxisWEB-INFclasses下

2、在%TOMCAT_HOME%webappsaxisWEB-INF下新建deploy.wsdd文件，即SOAP服务发布描述文件
deploy.wsdd

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<service name="HelloWorld" provider="java:RPC">
<parameter name="className" value="HelloWorld"/>
<parameter name="allowedMethods" value="sayHello"/>
</service>
</deployment>

在DOS下转换目录到%TOMCAT_HOME%webappsaxisWEB-INF，命令：

java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient -lhttp://地址:端口/axis/services/AdminService deploy.wsdd

你会发现目录下多了一个server-config.wsdd文件，这就是AXIS的配置文件，以后所有的服务发布描述都会在里面找到。（当然，你可以直接修改它，不用再写deploy.wsdd）然后打开浏览器http://localhost:8080/axis/servlet/AxisServlet，你就会看到你的服务已发布（如果使用Eclipse的话只需右键HelloWorld.java选择WebService,CreateWebService即可完成上面的所有工作)

同样用客户端程序访问一下：（注意和上边的差别！！）

HelloClient.java

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

public class HelloClient
{
public static void main(String [] args) throws Exception {

String endpoint = "http://localhost:" +"8080"+ "/axis/services/HelloWorld";//注意！差别仅仅在这里！！

Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress( new java.net.URL(endpoint) );
call.setOperationName("sayHello" );

String res = (String) call.invoke( new Object[] {} );

System.out.println( res );
}
}

http://gocom.primeton.com/blog/index.php?op=Default&postCategoryId=467&blogId=1660