【转】使用Axis简单快速创建Webservice

　　一．准备工作：

　　1.  安装Axis。去官方网站http://ws.apache.org/axis/下载axis包，然后解压到任何一个目录。本例使用的是axis-bin-1_4.tar.gz ，解压到E:\axis-bin-1_4\axis-1_4。

　　2.  开发环境准备。本例使用MyEclipse6.0 ，web server使用tomcat6。

 

　　二．创建Web工程：

　　1． MyEclipse中新建web工程，名称为TestCustomAxis。工程目录为：D:\JavaProject\TestCustomAxis。

　　2． 引入axis包： 把axis目录下的E:\axis-bin-1_4\axis-1_4 \lib\下的所有jar包拷贝到工程下面的WebRoot\WEB-INF\lib下，MyEclipse会自动添加到引用库（Referenced Libraries）：

 

　　三．写接口和类代码：

　　1.这里我想顺便测试一下Axis是否支持对复杂对象的串行化，于是自定义一个wsResult类（注意这个类一定要是标准写法，属性有get，set方法），代码如下：

　　package com.ckp;

　　public class wsResult {

　　private int errorCode;

　　private String errorString;

　　private String resultVal;

　　public wsResult(){

　　this.errorCode = 0;

　　this.errorString = "";

　　this.resultVal = "";

　　}

　　public int getErrorCode() {

　　return errorCode;

　　}

　　public void setErrorCode(int errorCode) {

　　this.errorCode = errorCode;

　　}

　　public String getErrorString() {

　　return errorString;

　　}

　　public void setErrorString(String errorString) {

　　this.errorString = errorString;

　　}

　　public String getResultVal() {

　　return resultVal;

　　}

　　public void setResultVal(String resultVal) {

　　this.resultVal = resultVal;

　　}

　　}

 

　　2.定义接口SayHelloService，所属包是com.ckp：

　　package com.ckp;

　　public interface SayHelloService {

　　public String sayHelloMr(String name);

　　public wsResult sayHelloMiss(String name);

　　}

 

　　3.创建实现类SayHelloImpl，实现接口SayHelloService：

　　package com.ckp;

　　public class SayHelloImpl implements SayHelloService{

　　public String sayHelloMr(String name){

　　return "Hello you,,,Mr."+name;

　　}

　　public wsResult sayHelloMiss(String name){

　　wsResult retObj = new wsResult();

　　retObj.setResultVal("Hello,Miss"+name);

　　return retObj;

　　}

　　}

 

　　工程结构如下图：

 

　　四．配置Axis：

　　1.修改web.xml文件，没什么特殊要求的话，可以直接把axis压缩包（E:\axis-bin-1_4\axis-1_4\webapps\axis\WEB-INF\）里的web.xml拷贝过来覆盖工程的web.xml。

　　2.书写deploy.wsdd，这是关键步骤。在任意位置创建文件deploy.wsdd（比如创建到E:\）。内容如下，具体配置见注释文字：

　　<deployment

　　xmlns="http://xml.apache.org/axis/wsdd/"

　　xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

　　<!-- Services from TestAxisService WSDL service -->

　　<service name="TestAxisService" provider="java:RPC" style="wrapped" use="literal">   <!-- 服务名称，自己定义 -->

　　<parameter name="wsdlTargetNamespace" value="http://ckp.com"/>                 <!-- 将显示在wsdl上的命名空间 ，自己定义-->

　　<parameter name="wsdlServiceElement" value="ckpService"/>                      <!-- 将显示在wsdl中wsdl:service节点的 name属性， 自己定义-->

　　<parameter name="schemaQualified" value="http://ckp.com"/>                  <!-- 自己定义-->

　　<parameter name="wsdlServicePort" value="testCustomAxis"/>                  <!-- 将显示在wsdl中wsdl:port节点的 name属性， 自己定义 -->

　　<parameter name="className" value="com.ckp.SayHelloImpl"/>                  <!-- 实现类名，要带上包名 -->

　　<parameter name="wsdlPortType" value="SayHelloService"/>                       <!-- 接口名 -->

　　<parameter name="typeMappingVersion" value="1.2"/>

　　<!-- 下面就是对方法的描述了，要写对方法的名字，返回值类型和参数的名字和类型 -->

　　<operation name="sayHelloMr" qname="operNS:sayHelloMr" xmlns:operNS="http://ckp.com" returnQName="retNS:out" xmlns:retNS="http://ckp.com" returnType="rtns:string" xmlns:rtns="http://www.w3.org/2001/XMLSchema" soapAction="" >

　　<parameter qname="pns:name" xmlns:pns="http://ckp.com" type="tns:string" xmlns:tns="http://www.w3.org/2001/XMLSchema"/>

　　</operation>

　　<operation name="sayHelloMiss" qname="operNS:sayHelloMiss" xmlns:operNS="http://ckp.com" returnQName="retNS:out" xmlns:retNS="http://ckp.com" returnType="rtns:wsResult" xmlns:rtns="http://ckp.com" soapAction="" >

　　<parameter qname="pns:name" xmlns:pns="http://ckp.com" type="tns:string" xmlns:tns="http://www.w3.org/2001/XMLSchema"/>

　　</operation>

　　<parameter name="allowedMethods" value="sayHelloMr sayHelloMiss"/> <!-- value里面用空格隔开方法名 -->

　　<!-- 串行化的关键就在下面这里了，对自定义类型wsResult的描述。。。注意type属性里要带上包名 -->

　　<typeMapping

　　xmlns:ns="http://ckp.com"

　　qname="ns:wsResult"

　　type="java:com.ckp.wsResult"

　　serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"

　　deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"

　　encodingStyle=""

　　/>

　　</service>

　　</deployment>

　　3.把web工程部署到tomcat，启动tomcat。

　　4.生成server-config.wsdd文件，步骤如下：

　　1）新建makeWsdd.bat，内容如下

　　set Axis_Lib=E:\ axis-bin-1_4\axis-1_4\lib

　　set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%

　　set Axis_Servlet=http://localhost:8080/TestCustomAxis/services/AdminService

　　%Java_Cmd% org.apache.axis.client.AdminClient -l %Axis_Servlet% E: \deploy.wsdd

　　写对axis包的路径和刚才手写的deploy.wsdd路径，以及webserver服务地址。

　　2）命令行下，执行makeWsdd.bat：（注意此步骤进行时tomcat必需是启动状态）：

　　执行成功会显示如下信息：

　　在apache-tomcat-6.0.14\webapps\TestCustomAxis\WEB-INF\下也会出现server-config.wsdd文件。

　　5.重启tomcat。

　　五．测试Webservice：

　　1.先测试wsdl，浏览器输入：http://localhost:8080/TestCustomAxis/services：

　　点击TestAxisService的wsdl，查看wsdl文件，可以看到，自定义类型wsResult的串行化也成功了：

　　2.测试服务是否正确执行：我们用Myeclipse自带的测试工具来测试：

　　1)打开Myeclipse里的Web Services Explorer:

　　2)弹出如下界面，选择右上角的WSDL Page :

　　3)显示如下，地址栏输入我们的wsdl地址，点击 Go:

　　4)显示如下,可以点击方法1或者方法2进入测试某个方法：

　　5)点击方法1，进入如下界面，随便输入参数”奥巴马”，点击Go，下放显示结果Hello you,,,Mr.奥巴马 。

　　6)点击方法2，进入如下界面，随便输入参数” 布兰妮”，点击Go，下放显示结果，可以看到自定义的wsResult类正确被串行化的结果：

　　总结：与Xfire相比，用Axis写Webservice稍微复杂些，不过还是很简单地。建工程，写接口，写类，拷贝一个web.xml，写deploy.wsdd ，生成server-config.wsdd，万事ok！

　　弄明白如何手工写wsdd文件的好处是，灵活性比较大，如果以后想对Webservice修改或者添加方法。直接修改server-config.wsdd文件即可（server-config.wsdd文件里有一段内容，与deploy.wsdd配置内容一样，照着修改即可）。