最近研究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方法),代码如下:
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:
public interface SayHelloService {
public String sayHelloMr(String name);
public wsResult sayHelloMiss(String name);
}
3.创建实现类SayHelloImpl,实现接口SayHelloService:
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:\)。内容如下,具体配置见注释文字:
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 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文件的如下节点: