本文结合一个简单示例讲解了怎样把Axis和Ant结合起来进行Web服务的开发。帮助读者从简单的java源代码或者从一个服务描述文件（wsdl）开始，用Ant工具进行构建，设置，并把服务部署到Axis。
首先假定您熟悉 AXIS 处理系统和Ant工具。文中示例所需要的软件如下：
l Apache Axis 1.1
l Apache Ant 1.5.3
l Jarkat Tomcat 4.1.24
在开始前，假定上述软件已经安装和配置好了。
Axis和Ant简介
Axis 框架是来自 Apache Group 的、基于 java 的、最新的 SOAP 规范（SOAP 1.2）和 SOAP with Attachments 规范（来自 Apache Group ）的开放源代码实现。其本质上是一个SOAP引擎－－一个构建诸如客户端、服务器、网关等SOAP处理器的框架。是Apache SOAP的后继项目。但是，Axis使用SAX（基于事件）解析器获得了比Apache SOAP早期版本(使用DOM解析)非常明显的速度优势。另外，它还具有很强的灵活性和稳定性，支持Web服务描述语言1.1版。
Apache Ant是Apache软件基金会jakarta项目中的一个子项目，是一个基于Java的构建工具，类似于make，但它没有make那么复杂繁琐。Ant由一些内置任务（task）和可选择的任务组成，还可以配置第三方提供的任务。它的构建配置文件基于XML的，所以容易书写和维护，而且结构清晰。Ant还可以集成到一些开发环境中（例如visual age,jbuilder,Elipse)。
Axis对Ant的支持
Axis为支持Ant构建，提供了一个axis-ant.jar文件。该文件包含三个可选任务(task)的定义和实现：axis-wsdl2java，axis-java2wsdl和axis-admin。任务axis-wsdl2java与Axis提供的工具WSDL2Java具有同样的功能，根据web服务描述文件生成对应的Java源程序，它的属性设置与WSDL2Java的命令参数设置类似。而任务axis-java2wsdl则相反，它与Java2WSDL工具一样，是根据已有的类文件来生成Web服务描述文件。最后一个任务axis-admin是用于web服务的部署和取消部署的，对应于Axis的AminClient工具。
为了使Ant能够正确使用上述三个任务（task），还需要做一些配置。注意：Apache Ant的版本必须是1.5.1或更高版本。
1．设置系统的环境变量CLASSPATH包含Axis提供的axis-ant.jar文件，或者在Ant的配置文件（通常是build.xml）中设置路径包含它。例如，
<path id="axis.classpath">
<fileset dir="${axis.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>
2．然后使用<taskdef>声明导入axis-ant.jar文件中的属性文件所定义的任务（task）列表。
<taskdef resource="axis-tasks.properties"
classpathref="axis.classpath" />
3．设置在构建过程中可能要需要的java包，例如， Axis所有的jar包，wsdl4j.jar，junit.jar等等。
实例开发
下面就用一个实例来讲解怎样把Ant和Axis结合来开发Web服务。为了注重本文的目的，我们开发一个比较简单的Web服务，它接受客户端传入的字符串数组，如果传入的参数为null，则抛出一个自定义的异常，否则把每个字符串连接起来返回给客户端。
首先定义一个Web服务接口Hello，如下所示：
package com.bidlink.hello;
public interface Hello{
public String echo(String[] content ) throws
java.rmi.RemoteException,com.bidlink.hello.MyException;
}
自定义异常MyException包含一个时间值，以记录异常出现的时间，如下：
package com.bidlink.hello;
public class MyException extends org.apache.axis.AxisFault implements java.io.Serializable{
private java.util.Calendar occurTime;
public MyException() {
}
public MyException(
java.util.Calendar occurTime) {
super();
this.occurTime = occurTime;
}
public java.util.Calendar getOccurTime() {
return occurTime;
}
public void setOccurTime(java.util.Calendar occurTime) {
this.occurTime = occurTime;
}
}
1．axis-java2wsdl：从类文件生成服务描述文件
编译上面定义的两个文件Hell.java和MyException.java。接着编写Ant的配置文件build.xml（文件详细信息请查看示例源代码），使用axis-java2wsdl任务根据类Hello来生成Web服务描述文件hello.wsdl。任务具体配置如下：
<axis-java2wsdl classname="com.bidlink.hello.Hello"
location="http://localhost:8080/axis/services/Hello"
namespace="http://hello.bidlink.com"
output="hello.wsdl"
style="RPC"
extraclasses="com.bidlink.hello.MyException">
<classpath>
<pathelement path="${dist}"/>
</classpath>
</axis-java2wsdl>
其中，<pathelement path="${dist}"/>指出Hello.class和MyException.class文件的位置。
运行命令ant java2wsdl，构建出Web服务描述文件hello.wsdl。
2．axis-wsdkl2java：从服务描述文件生成服务源程序
下面讲解怎样根据刚刚得到的hello.wsdl文件生成服务所需要的java源程序。在这里需要用到任务axis-wsdl2java。任务属性设置如下：
<axis-wsdl2java all="true"
url="hello.wsdl"
deployscope="Request"
output="${gensrc}"
serverside="true"
skeletondeploy="false"
testcase="true"
noimports="false"
typemappingversion="1.2">
</axis-wsdl2java>
运行ant wsdl2java，根据axis-wsdl2java任务的属性配置生成相应的java源程序，本例所生成的文件包括：服务端服务接口文件Hello.java及其实现HelloSoapBindingImpl.java，以及客户端的HelloService.java，HelloServiceLocator.java，HelloServiceLocator.java和客户端存根文件HelloSoapBindingStub.java。又因为属性testcase="true"，所以还生成了测试文件HelloServiceTestCase.java。当然，自定义异常MyException也是重新生成的。
3．axis-admin：向Axis部署Hello服务
服务源程序生成后，需要根据服务的功能修改HelloSoapBindingImpl.java文件，以真正实现该Web服务。修改如下：
/**
* HelloSoapBindingImpl.java
*
* This file was auto-generated from WSDL
* by the Apache Axis WSDL2Java emitter.
*/
package com.bidlink.hello;
public class HelloSoapBindingImpl implements com.bidlink.hello.Hello{
public java.lang.String echo(java.lang.String[] in0) throws java.rmi.RemoteException, com.bidlink.hello.MyException {
if(in0 == null)
throw new MyException(java.util.Calendar.getInstance());
String retStr = "";
for(int i=0; i< in0.length; i++)
retStr += in0[i];
return retStr;
}
}
编译所有的生成的源程序，最后使用axis-admin任务向Axis部署Hello Web服务。
<axis-admin
port="${target.port}"
hostname="${target.server}"
failonerror="true"
servletpath="${target.appname}/services/AdminService"
debug="true"
xmlfile="deploy.wsdd"/>
运行ant deploy，部署Hello服务。
测试
现在可以测试所部署的Web服务hello。可以通过浏览器，也可以利用刚才生成的测试文件HelloServiceTestCase.java来进行该项工作。如果利用测试文件HelloServiceTestCase.java，那么还需要对它进行稍作修改。具体来说，就是添加一个main函数，然后修改所生成的测试方法。
参考资料
1．阅读Apache Axis开发指导文档
2．查看Apache Ant文档手册http://ant.apache.org/manual/index.html
3．http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages/AxisAntTasks得到更多关于Axis-Ant任务的信息。 
|
本类阅读TOP10