使用Axis简单快速创建Webservice(含串行化的实现)
2009-11-18 17:24
751 查看
最近研究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:\）。内容如下，具体配置见注释文字：
<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"> <!-- 服务名称，自己定义. provider="java:RPC"或者provider="java:MSG"，style ：RPC, DOCUMENT or WRAPPED ，use： LITERAL or ENCODED...具体含义参见：http://ws.apache.org/axis/java/reference.html-->
<parameter name="wsdlTargetNamespace" value="http://ckp.com"/> <!-- 将显示在wsdl上的命名空间 ，自己定义-->
<parameter name="wsdlServiceElement" value="ckpService"/> <!-- 将显示在wsdl中wsdl:service节点的 name属性， 自己定义-->
<parameter name="schemaQualified" value="http://ckp.com/scheme/1.0"/> <!-- scheme命名空间限制，自己定义-->
<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"/>
<!-- 下面就是对方法的描述了，要写对方法的名字，返回值类型和参数的名字和类型。-->
<!-- 请注意参数：xmlns:operNS是scheme的targetNamespace属性-->
<!-- 请注意参数 ：xmlns:rtns要按返回值的类型(returnType)相应填写 -->
<operation name="sayHelloMr" qname="operNS:sayHelloMr" xmlns:operNS="http://ckp.com/scheme/1.0" returnQName="retNS:out" xmlns:retNS="http://ckp.com/scheme/2.0" returnType="rtns:string" xmlns:rtns="http://www.w3.org/2001/XMLSchema" soapAction="" >
<!-- 请注意参数 ：xmlns:tns要按输入参数的类型(type)相应填写 -->
<parameter qname="pns:name" xmlns:pns="http://ckp.com/scheme/1.0" type="tns:string" xmlns:tns="http://www.w3.org/2001/XMLSchema"/>
</operation>
<!-- 注意这个方法里的xmlns:rtns ，是返回类型的命名空间，因为里面有我们自定义的wsResult类型，所以指定为http://ckp.com/scheme/1.0 -->
<operation name="sayHelloMiss" qname="operNS:sayHelloMiss" xmlns:operNS="http://ckp.com/scheme/1.0" returnQName="retNS:out" xmlns:retNS="http://ckp.com/scheme/2.0" returnType="rtns:wsResult" xmlns:rtns="http://ckp.com/scheme/1.0" soapAction="" >
<parameter qname="pns:name" xmlns:pns="http://ckp.com/scheme/1.0" type="tns:string" xmlns:tns="http://www.w3.org/2001/XMLSchema"/>
</operation>
<parameter name="allowedMethods" value="sayHelloMr sayHelloMiss"/> <!-- value里面用空格隔开方法名 -->
<!-- 串行化的关键就在下面这里了，对自定义类型wsResult的描述。。。注意type属性里要带上包名,命名空间最好与上面返回类型的xmlns:rtns一致 -->
<typeMapping
xmlns:ns="http://ckp.com/scheme/1.0"
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配置内容一样，照着修改即可。官网上说，在部署服务时，你甚至可以把官方例子上的server-config.wsdd文件拷贝过来，手动修改即可，无需像本文一样用deploy.wsdd来生成。由于server-config.wsdd文件内容太多太复杂，我这里使用内容较少的deploy.wsdd来生成它，比较容易理解）。
六．关于部署到websphere
跟普通项目一样，打WAR包，部署到websphere，然后把server-config.wsdd文件拷贝到工程下的WEB_INF文件夹下即可。如果不需要附件功能，可以删掉server-config.wsdd文件的如下节点：
<parameter name="attachments.Directory" value="C:\Program Files\Apache Software Foundation\apache-tomcat-6.0.14\webapps\TestCustomAxis\WEB-INF\attachments"/>
。
今天再一想，不对呀。。。。。我想修改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:\）。内容如下，具体配置见注释文字：
<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"> <!-- 服务名称，自己定义. provider="java:RPC"或者provider="java:MSG"，style ：RPC, DOCUMENT or WRAPPED ，use： LITERAL or ENCODED...具体含义参见：http://ws.apache.org/axis/java/reference.html-->
<parameter name="wsdlTargetNamespace" value="http://ckp.com"/> <!-- 将显示在wsdl上的命名空间 ，自己定义-->
<parameter name="wsdlServiceElement" value="ckpService"/> <!-- 将显示在wsdl中wsdl:service节点的 name属性， 自己定义-->
<parameter name="schemaQualified" value="http://ckp.com/scheme/1.0"/> <!-- scheme命名空间限制，自己定义-->
<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"/>
<!-- 下面就是对方法的描述了，要写对方法的名字，返回值类型和参数的名字和类型。-->
<!-- 请注意参数：xmlns:operNS是scheme的targetNamespace属性-->
<!-- 请注意参数 ：xmlns:rtns要按返回值的类型(returnType)相应填写 -->
<operation name="sayHelloMr" qname="operNS:sayHelloMr" xmlns:operNS="http://ckp.com/scheme/1.0" returnQName="retNS:out" xmlns:retNS="http://ckp.com/scheme/2.0" returnType="rtns:string" xmlns:rtns="http://www.w3.org/2001/XMLSchema" soapAction="" >
<!-- 请注意参数 ：xmlns:tns要按输入参数的类型(type)相应填写 -->
<parameter qname="pns:name" xmlns:pns="http://ckp.com/scheme/1.0" type="tns:string" xmlns:tns="http://www.w3.org/2001/XMLSchema"/>
</operation>
<!-- 注意这个方法里的xmlns:rtns ，是返回类型的命名空间，因为里面有我们自定义的wsResult类型，所以指定为http://ckp.com/scheme/1.0 -->
<operation name="sayHelloMiss" qname="operNS:sayHelloMiss" xmlns:operNS="http://ckp.com/scheme/1.0" returnQName="retNS:out" xmlns:retNS="http://ckp.com/scheme/2.0" returnType="rtns:wsResult" xmlns:rtns="http://ckp.com/scheme/1.0" soapAction="" >
<parameter qname="pns:name" xmlns:pns="http://ckp.com/scheme/1.0" type="tns:string" xmlns:tns="http://www.w3.org/2001/XMLSchema"/>
</operation>
<parameter name="allowedMethods" value="sayHelloMr sayHelloMiss"/> <!-- value里面用空格隔开方法名 -->
<!-- 串行化的关键就在下面这里了，对自定义类型wsResult的描述。。。注意type属性里要带上包名,命名空间最好与上面返回类型的xmlns:rtns一致 -->
<typeMapping
xmlns:ns="http://ckp.com/scheme/1.0"
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配置内容一样，照着修改即可。官网上说，在部署服务时，你甚至可以把官方例子上的server-config.wsdd文件拷贝过来，手动修改即可，无需像本文一样用deploy.wsdd来生成。由于server-config.wsdd文件内容太多太复杂，我这里使用内容较少的deploy.wsdd来生成它，比较容易理解）。
六．关于部署到websphere
跟普通项目一样，打WAR包，部署到websphere，然后把server-config.wsdd文件拷贝到工程下的WEB_INF文件夹下即可。如果不需要附件功能，可以删掉server-config.wsdd文件的如下节点：
<parameter name="attachments.Directory" value="C:\Program Files\Apache Software Foundation\apache-tomcat-6.0.14\webapps\TestCustomAxis\WEB-INF\attachments"/>
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- 创建简单Eclipse插件实现Axis WebService客户端
- 创建简单Eclipse插件实现Axis WebService客户端
- 创建简单Eclipse插件实现Axis WebService客户端
- 创建简单Eclipse插件实现Axis WebService客户端
- 从零使用OpenCV快速实现简单车牌识别系统
- Android个人学习笔记-使用myeclipse快速创建webservice并在Android中调用
- 使用CXF框架实现webservice的一个简单例子
- Java_使用axis1.4调用WebService简单示例
- Webservice学习笔记二,使用Axis发布简单的Web服务
- Oracle DBLINK 简单使用 oracle在进行跨库访问时，可以通过创建dblink实现，今天就简单的介绍下如果创建dblink，以及通过dblink完成插入、修改、删除等操
- 使用LUCENE快速实现属于自己的英文分词程序——附简单实现
- 使用python创建一个简单的restful风格的webservice应用
- JAX-WS使用Handler实现简单的WebService权限验证
- Eclipse使用（七）—— 使用Eclipse创建JavaWeb项目并使用JDBC连接数据库实现简单的登陆注册功能
- 从零使用OpenCV快速实现简单车牌识别系统
- Maven搭建webService (三) 创建客户端－－－使用Apache CXF方式实现
- 使用axis发布简单的webservice
- 使用lucene3.6创建索引和实现简单搜索
- java 使用axis实现WebServise简单方法
- JAX-WS使用Handler实现简单的WebService权限验证