WebService 常用免费调用接口与 JWS(Java Web Service) 调用第三方 webService 天气服务

怼烎@ 2022-03-19 06:38 967阅读 0赞

**目录**

WebService 常用免费调用接口

wsimport 生成代理类

JWS 客户端调用

--------------------

# WebService 常用免费调用接口 #

<table> 
 <tbody> 
 <tr> 
 <td style="width:505px;">天气预报Web Service，数据来源于中国气象局</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/WeatherWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">IP地址来源搜索Web Service（是目前最完整的IP地址数据）</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">随机英文、数字和中文简体字Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中国邮政编码 &lt;-&gt; 地址信息双向查询/搜索Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">验证码图片Web Service 支持中文、字母、数字 图像和多媒体</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ValidateCodeWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ValidateCodeWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ValidateCodeWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">Email 电子邮件地址验证Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ValidateEmailWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ValidateEmailWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ValidateEmailWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中文简体字 &lt;-&gt;繁体字转换Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/TraditionalSimplifiedWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/TraditionalSimplifiedWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/TraditionalSimplifiedWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中文 &lt;-&gt; 英文双向翻译Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/TranslatorWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/TranslatorWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/TranslatorWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">火车时刻表Web Service （第六次提速最新列车时刻表）</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/TrainTimeWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/TrainTimeWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/TrainTimeWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中国股票行情数据Web Service（支持深圳和上海股市的基金、债券和股票）</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ChinaStockWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ChinaStockWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ChinaStockWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">即时外汇汇率数据Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ExchangeRateWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ExchangeRateWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ExchangeRateWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">腾讯QQ在线状态Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中国电视节目预告（电视节目表）Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/webservices/ChinaTVprogramWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/webservices/ChinaTVprogramWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/webservices/ChinaTVprogramWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">外汇-人民币即时报价Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ForexRmbRateWebService.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ForexRmbRateWebService.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ForexRmbRateWebService.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中国股票行情分时走势预览缩略图Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/webservices/ChinaStockSmallImageWS.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/webservices/ChinaStockSmallImageWS.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/webservices/ChinaStockSmallImageWS.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">国内飞机航班时刻表 Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/webservices/DomesticAirline.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/webservices/DomesticAirline.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/webservices/DomesticAirline.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">中国开放式基金数据Web Service</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/ChinaOpenFundWS.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/ChinaOpenFundWS.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/ChinaOpenFundWS.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 <tr> 
 <td style="width:505px;">股票行情数据 Web Service（支持香港、深圳、上海基金、债券和股票；支持多股票同时查询）</td> 
 <td style="width:397px;"> <a href="http://www.webxml.com.cn/WebServices/StockInfoWS.asmx" rel="nofollow">Endpoint</a> <a href="http://www.webxml.com.cn/WebServices/StockInfoWS.asmx?disco" rel="nofollow">Disco</a> <a href="http://www.webxml.com.cn/WebServices/StockInfoWS.asmx?wsdl" rel="nofollow">WSDL</a> </td> 
 </tr> 
 </tbody> 
</table>

本文将选取里面的 "中国气象局" 天气查询服务作为调用演示。

<table> 
 <tbody> 
 <tr> 
 <td> <a href="http://www.webxml.com.cn/WebServices/WeatherWebService.asmx" rel="nofollow">Endpoint 地址：http://www.webxml.com.cn/WebServices/WeatherWebService.asmx</a> <a href="http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl" rel="nofollow">WSDL</a>地址：<a href="http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl" rel="nofollow">http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl</a> </td> 
 </tr> 
 </tbody> 
</table>

# wsimport 生成代理类 #

1、已经知道 Java 开发时，使用自带的 wsimport.exe 工具即可根据服务端提供的 WSDL 文件生成客户端代理类，所以第一步就是根据上面的 WSDL 地址生成客户端使用的代理类。

**解析组件 's:schema' 时出错：**

PS E:\wmx\webservice> wsimport -keep -d E:\wmx\webservice -verbose http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl
    正在解析 WSDL...
    [WARNING] src-resolve.4.2: 解析组件 's:schema' 时出错。在该组件中检测到 's:schema' 位于名称空间 'http://www.w3.org/2001/XMLSchema' 中, 但无法从方案文档 'http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl#types?schema1' 引用此名称空间的组件。如果这是不正确的名称空间, 则很可能需要更改 's:schema' 的前缀。如果这是正确的名称空间, 则应将适当的 'import' 标记添加到 'http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl#types?schema1'。
      http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl#types?schema1的第 44 行
    [WARNING] src-resolve: 无法将名称 's:schema' 解析为 'element declaration' 组件。
      http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl#types?schema1的第 44 行
    [ERROR] undefined element declaration 's:schema'
      http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl的第 44 行
    [ERROR] undefined element declaration 's:schema'
      http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl的第 85 行
    Exception in thread "main" com.sun.tools.internal.ws.wscompile.AbortException
            at com.sun.tools.internal.ws.processor.modeler.wsdl.JAXBModelBuilder.bind(JAXBModelBuilder.java:129)
            at com.sun.tools.internal.ws.processor.modeler.wsdl.WSDLModeler.buildJAXBModel(WSDLModeler.java:2283)
            at com.sun.tools.internal.ws.processor.modeler.wsdl.WSDLModeler.internalBuildModel(WSDLModeler.java:183)
            at com.sun.tools.internal.ws.processor.modeler.wsdl.WSDLModeler.buildModel(WSDLModeler.java:126)
            at com.sun.tools.internal.ws.wscompile.WsimportTool.buildWsdlModel(WsimportTool.java:429)
            at com.sun.tools.internal.ws.wscompile.WsimportTool.run(WsimportTool.java:190)
            at com.sun.tools.internal.ws.wscompile.WsimportTool.run(WsimportTool.java:168)
            at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
            at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
            at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
            at java.lang.reflect.Method.invoke(Method.java:498)
            at com.sun.tools.internal.ws.Invoker.invoke(Invoker.java:159)
            at com.sun.tools.internal.ws.WsImport.main(WsImport.java:42)
    PS E:\wmx\webservice>

1、如上所示生成时出错，执行失败，出现的原因是 webService 服务端如果是 .net 写的，则使用 Java wsimport.exe 生成时就会报错。

2、开发中如果没有遇到这个错误，自然是最好，万一遇到，则可以一试，亲测有效。

**解决办法**

1、针对 .net 开发的 webService 服务端，Java wsimport.exe 生成代理类出错解决办法如下：

<table> 
 <tbody> 
 <tr> 
 <td> 1）将服务端的 wsdl 文档保存到本地，如 E:\wmx\webservice\weather.wsdl.xml、E:\wmx\webservice\weather.wsdl、E:\wmx\webservice\weather.xml （经实测文件的后缀名其实关系不大，都可以正常生成） 2、修改 wsdl 文档以下内容: 将文件中所有的 &lt;s:element ref="s:schema" /&gt;&lt;s:any /&gt; 替换成 &lt;s:any minOccurs="2" maxOccurs="2"/&gt; </td> 
 </tr> 
 </tbody> 
</table>

![20190215171112365.gif][]

2、直接在 wsdl 文档页面右键，选择查看源代码，然后将 Ctrl + S 保存即可，然后便可打开文件，替换其中的内容：

![20190215171808471.gif][]

3、此时使用 wsimport.exe 再次生成，便可以正确执行：

![20190215171952985.gif][]

# JWS 客户端调用 #

1、显然这种别人写的服务端，不用多想，将生成的 .java 文件全部导入即可，然后需要找到里面的服务接口，可以凭直觉，也可以从 wsdl 文档中的 <service> 元素中查找

2、通常情况下，从 wsdl 的 Url 地址中也是可以找到的，如本例的 ：http://www.webxml.com.cn/WebServices/Weath  
erWebService.asmx?wsdl，就是其中的 "WeatherWebService"

![20190215172736784.gif][]

3、将生成好的 .java 文件导入到项目中：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdteDE5OTMzMjg_size_16_color_FFFFFF_t_70][]

特别提醒：

<table> 
 <tbody> 
 <tr> 
 <td> 1）代理类中有些类相互引用时，使用的是绝对地址，如在&nbsp;WeatherWebServiceSoap 接口中使用了这样的代码， cn.com.webxml.ArrayOfString 来引用&nbsp;ArrayOfString ，于是要不就是自己新建和它一样的包，然后放置进去，如上所示，要不就是修改源码中原来的包名和自己包名的保持一致，否则报错。 2）因为 wsimport.exe 是转换的本地的 wsdl 文件，而不是在线的 wsdl 文件，所以代码中关联的也是本地的 wsdl 文件，这个文件必须存在，如果这个文件删除了，则项目运行的时候就会找不到而解析失败。所以如果文件移动了位置，则代码中也要相应的修改。 3）建议将 wsdl 文件放在项目中(资源目录下)，这样就可以和项目一起移动，否则如果将来项目移动了，而忘了本地的 wsdl 文件，显然运行就报错了。 </td> 
 </tr> 
 </tbody> 
</table>

4、调用测试类代码如下，这是我们自己唯一要写的代码（如果上面没有移动 wsdl文件到项目中内部的话），几行即可搞定：

import cn.com.webxml.ArrayOfString;
 import cn.com.webxml.WeatherWebService;
 import cn.com.webxml.WeatherWebServiceSoap;
 
 import java.util.List;
 import java.util.logging.Logger;
 
 /**
 * Created by Administrator on 2019/1/25 0025.
 */
 public class Web_service {
 //日志记录器
 public static final Logger logger = Logger.getGlobal();
 
 public static void main(String[] args) {
 /**1、创建实现类对象
 * */
 WeatherWebService weatherWebService = new WeatherWebService();
 /** 2、获取服务接口实例
 * 这些代码只能看着源码跟着感觉来写，因为代码完全是人家写的，对方通常也不会提供什么使用文档的
 */
 WeatherWebServiceSoap weatherWebServiceSoap = weatherWebService.getWeatherWebServiceSoap();
 /**
 *3、有了服务接口实例，就可以调用其中的方法了，这里返回值也是对方使用的对象
 */
 ArrayOfString arrayOfString = weatherWebServiceSoap.getWeatherbyCityName("长沙");
 /**
 * 4、看着源码即可轻松写出，毕竟都是程序猿，猜也猜出它的目的
 */
 List<String> stringList = arrayOfString.getString();
 int count = 1;
 for (String s : stringList) {
 System.out.println((count++) + ":::" + s);
 }
 }
 }

5、运行结果如下：

![20190215183434901.gif][]

如上所示，获取数据成功，有了数据，至于怎么使用，就是自己的事情了，根据业务需求使用即可。

[20190215171112365.gif]: /images/20220319/008dc512e42a4551ba060d65d5bcd255.png
[20190215171808471.gif]: /images/20220319/0c2cb435848a4eb28ecbf0c9bebe0521.png
[20190215171952985.gif]: /images/20220319/d0ccdbde4fff49feb1199578c174c51f.png
[20190215172736784.gif]: /images/20220319/0d59f2b449054abd98a191ce7555325b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdteDE5OTMzMjg_size_16_color_FFFFFF_t_70]: /images/20220319/6f6a595ab469440084a7774aa43f9a9f.png
[20190215183434901.gif]: /images/20220319/3489e1cf48af487694952c6dcea777c1.png