web service开发：wsdl2java 客户端代码的生成

     在用到web service时，如果是调用自己开发的web service还好，可以有一个方法的接口或参数对象实体类什么的，但如果是调用第三方的服务，除了得到web service服务地址的wsdl文档外，没有任何实质性编码的东西，写原生调用太麻烦，这时就需要自己写一个方法的接口类。

这个，目前已经有比较成熟的工具，可以自动生成，下面作一下简单的介绍:

apache的wsdl2java工具，目前貌似CXF和axis各有一套，使用方式大同小异，但生成的代码会有所区别，这时说的是CXF提供的wsdl2java工具。

 

wsdl2java用法：

wsdl2java -p com -d src -all  aa.wsdl

-p  指定其wsdl的命名空间，也就是要生成代码的包名:

-d  指定要产生代码所在目录

-client 生成客户端测试web service的代码

-server 生成服务器启动web  service的代码

-impl 生成web service的实现代码

-ant  生成build.xml文件

-all 生成所有开始端点代码：types,service proxy,,service interface, server mainline, client mainline, implementation object, and an Ant build.xml file.

详细用法见：http://cwiki.apache.org/CXF20DOC/wsdl-to-java.html

 

一开始使用了CXF的这套工具，发现不是很方便，毕竟依赖CXF提供的工具jar包，个人不是很喜欢用。

后来发现JDK居然也自带了对web service生成java代码的功能，貌似1.6版本开始的，试用后发现效果十分不错，果断投入它的怀抱。下面作下简单的介绍，以备忘。

 

打开jdk下的bin目录 看下能否找到"wsimport.exe"这个文件

一般情况下都会有

如果没有则说明你的JDK不支持这个功能

然后在DOS窗口下输入wsimport 敲回车

如果提示错误的话 说明你的JDK环境变量还没有配好

一句话总结，如果你在dos窗口下输入wsimport正常，就可以

如果OK的话 输入以下命令就可以将wsdl文件生成java文件了

wsimport http://127.0.0.1/wsTest/hotelws?wsdl  -keep -p com.csl.hotelws -s g:/ws

参数说明

wsimport 这个是必须的 该工具的名称

http://127.0.0.1/wsTest/hotelws?wsdl  wsdl文件

-keep  是否生成源文件

-p com.csl.hotelws  生成后的java包名

-s g:/ws    生成后放哪个目录

但是前几天，在对一个第三方提供的web service使用该工具生成java代码的时候，居然出错了，网上查找后终于找到原因。

使用cxf wsdl2java或javax wsimport工具的时候，可能会遇到关于生成的Response类文件名冲突的问题 

Console代码  

1. WSDLToJava Error: Thrown by JAXB : A class/interface with the same name "***" is already in use. Use a class customization to resolve this conflict.  

目前可选择的方案： 

apache的wsdl2java工具，使用-autoNameResolution自动处理 

wsdl2java -autoNameResolution http://hello.joy2everyone.com/yourWebService?wsdl 

JDK自带的工具

wsimport -p com.test.client -keep http://hello.joy2everyone.com/yourWebService?wsdl -B-XautoNameResolution 

2.如果web service是己方开发的，可以修改代码，使用自定义bindings，详细可看sun webservice文档 

例如： 

Java代码  

1. public interface ValidateCCService  
2.     @WebMethod  
3.     @WebResult(name = "response")  
4.     public ValidateCCResponse validateCC(@WebParam(name = "request")ValidateCCRequest request);  

这个情况下定义的方法名，如果使用工具生成客户端代码，很可能存在Response冲突，因为定义的wsdl中会有一个关于接口方法的message 

<wsdl:message name="validateCCResponse"> 

</wsdl:message> 

方法名定义的message与接口定义返回的ValidateCCResponse，在工具生成客户端代码时就会产生命名冲突。 

但是通过更改接口方法名为： 

Java代码  

1. public interface ValidateCCService  
2.     @WebMethod  
3.     @WebResult(name = "response")  
4.     public ValidateCCResponse validate(@WebParam(name = "request")ValidateCCRequest request);  

即可解决该冲突。