使用Axis简单快速创建Webservice(含串行化的实现)

最近研究Axis。前几天写了一篇使用myEclipse，tomcat 和Axis发布webService ，当时受了公司某些“java过来人”的误导，说用Axis来创建Webservice，只能写先wsdl，再使用WSDL2Java方法来创建Webservice。我就稀里糊涂地想，那多麻烦啊，我想写个Webservice敢情得先写个wsdl吗？有没有直接把我写的类转成wsdl的方法？后来一看，嗨，Axis还真有个Java2WSDL方法。于是乎，我就先写类，然后Java2WSDL生成wsdl，然后WSDL2Java再生成Webservice。。。。。。居然很成功，测试也没问题，就大摇大摆放到博客上去了。

今天再一想，不对呀。。。。。我想修改Webservice，新增或者修改方法怎么办？难不成再生成一次wsdl然后再折腾回去？

我就想，Axis不就一框架嘛，框架这东西，一般只要写好某个配置文件不就ok了吗？干吗要手工运行那么多脚本和命令？

最后终于被我找到关键点，也就是wsdd文件，特撰文如下（上篇文章不删了，全当告诉大伙Axis里还有个Java2WSDL的玩意儿）：

一．准备工作：

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:\）。内容如下，具体配置见注释文字：

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配置内容一样，照着修改即可。官网上说，在部署服务时，你甚至可以把官方例子上的server-config.wsdd文件拷贝过来，手动修改即可，无需像本文一样用deploy.wsdd来生成。由于server-config.wsdd文件内容太多太复杂，我这里使用内容较少的deploy.wsdd来生成它，比较容易理解）。

六．关于部署到websphere

跟普通项目一样，打WAR包，部署到websphere，然后把server-config.wsdd文件拷贝到工程下的WEB_INF文件夹下即可。如果不需要附件功能，可以删掉server-config.wsdd文件的如下节点：

posted @ 2009-11-18 17:24 MichaelChen 阅读(2458) 评论(4) 编辑收藏举报

刷新页面返回顶部

重重的壳裹着轻轻的仰望

Yesterday is history,tomorrow is a mystery ,but today is a gift ,that is why it is called present

使用Axis简单快速创建Webservice(含串行化的实现)

公告