了解使用wsimport命令生成webService客户端代码实例

这几天做项目需要调用别人给提供的服务接口，要用到这块，正好做个收藏：

wsimport简介

在JDK的bin文件夹中，有一个wsimport.exe工具，可依据wsdl文件生成相应的类文件，将生存在本地这些类文件拷贝到需要使用的项目中，就可以像调用本地的类一样调用webService提供的方法。该工具可以用于非Java的服务器，如用C#编写的WebService，通过wsimport则生成Java的客户端实现。

常用命令如下：

1. wsimport -keep -d D:\temp\d -s D:\temp\s -p com.map -verbose http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl 

-keep：是否生成java源文件

-d：指定.class文件的输出目录

-s：指定.java文件的输出目录

-p：定义生成类的包名，不定义的话有默认包名

-verbose：在控制台显示输出信息

-b：指定jaxws/jaxb绑定文件或额外的schemas

-extension：使用扩展来支持SOAP1.2

wsimport实例

在此，推荐一个网站， 提供了全面的WebService接口供参考 ：http://www.webxml.com.cn/zh_cn/web_services.aspx

在本地生成查询号码归属地的webService

(1) 进入网站找到

其中，.asmx网址说明了调用的方法、输入参数、返回数据，.wsdl是我们要用来生成代码的网址。

(2) 新建一个Java Project，工程创建好后，生成src目录

(3) cmd命令，进入jdk的bin目录下运行命令：

[html]  view plain  copy

1. wsimport -keep -s D:\Workspaces -p com.cn.phone -verbose http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl

-s后的路径如果不是工程的src目录，需把生成的包拷贝到src目录下

刷新项目，便会看到我们生成的文件了

当我们点击几个java文件看时，是不是发现中文注释乱码了，如果想把源代码的编码变成UTF-8，可以下载一个工具：UTFCastExpress

http://download.csdn.net/detail/aqsunkai/9535166

(4) 在该路径下写测试类：

1. package com.cn.phone;  
2.   
3. public class PhoneWsClient {  
4.   
5.     public static void main(String[] args){  
6.         //创建一个MobileCodeWS工厂  
7.         MobileCodeWS factory = new MobileCodeWS();  
8.         //根据工厂创建一个MobileCodeWSSoap对象  
9.         MobileCodeWSSoap mobileCodeWSSoap = factory.getMobileCodeWSSoap();  
10.         //调用WebService提供的getMobileCodeInfo方法查询手机号码的归属地  
11.         String searchResult = mobileCodeWSSoap.getMobileCodeInfo("18512155752", null);  
12.         System.out.println(searchResult);  
13.   
14.     }  
15. }  

运行main方法后：

在本地生成查询天气预报的webService

直接使用wsimport 通过该地址生成Java文件时，会报错。因为该wsdl里面包含 ref = "s:schema" 这样的引用。而jaxb是不支持的。所以需要手动将该wsdl下载下来做下修改，然后再生成java文件。

(1) 将页面另存为

(2) 将所有的 <s:element ref="s:schema" />
                  <s:any /> 改成 <s:any minOccurs="2" maxOccurs="2"/>，一共有三处需要修改，建议查找<s:element ref="s:schema" />，修改时把<s:any />也要删掉

(3) 运行命令：

[java]  view plain  copy

1. wsimport -keep -s D:\Workspaces -p com.cn.weather -verbose C:\Users\sun\Desktop\WeatherWS.xml  

(4) 把生成的包拷贝到src目录下

需要注意的是，要修改WeatherWS.java文件中wsdl的url，因为我们用的是本地文件生成的，要修改成网站的url：http://ws.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl

(5)  在该路径下写测试类

[java]  view plain  copy

1. package com.cn.weather;  
2.   
3. import java.util.List;  
4.   
5. public class WeatherWsClient {  
6.   
7.     public static void main(String[] args) {  
8.          //创建一个WeatherWS工厂  
9.          WeatherWS factory = new WeatherWS();  
10.          //根据工厂创建一个WeatherWSSoap对象  
11.          WeatherWSSoap weatherWSSoap = factory.getWeatherWSSoap();  
12.          //调用WebService提供的getWeather方法获取南宁市的天气预报情况  
13.          ArrayOfString weatherInfo = weatherWSSoap.getWeather("钓鱼岛", null);  
14.          List<String> lstWeatherInfo = weatherInfo.getString();  
15.          //遍历天气预报信息  
16.          for (String string : lstWeatherInfo) {  
17.            System.out.println(string);  
18.            System.out.println("------------------------");  
19.           }  
20.          //获得中国省份、直辖市、地区和与之对应的ID  
21.          ArrayOfString s = weatherWSSoap.getRegionProvince();  
22.          List<String> list = s.getString();  
23.          for (String string : list) {  
24.                System.out.println(string);  
25.                System.out.println("------------------------");  
26.          }  
27.     }  
28. }  

运行main方法后：