Webservice接口的生成及调用

最近项目上要对接一个Webservice形式的接口，因为以前一直没有对接过这种类型的，所以这次专门查了一些资料学习下

一、Webservice的简单介绍

WebService是一种跨编程语言和跨操作系统平台的远程调用技术。它通过标准通信协议，在互联网上以服务的方式发布有用的程序模块，目前大部分是用SOAP作为通信协议。它提供一份详细的接口说明书，来帮助用户构建应用程序，这个接口说明书叫WSDL（Web服务描述语言，Web Service Description Language）。还有就是它请求报文和返回报文都是XML格式的。

优点：
1.跨编程语言和跨操作系统，通俗点说就是只要你网络是通的，你.net开发的东西，我java语言也可以调用，跟操作系统也没关系。

缺点：
1.服务端接口方为webservice则客户端也必须使用webservice。
2.因为webservice使用xml传输数据，因此性能上不能满足高并发

二、Webservice的服务端发布

1.发布web程序服务端发布 （这块后续单独写一个模块）

2.本地发布（这个其实很简单，就是写一个测试类运行一下就行，我直接贴代码）

package com.niu;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;

@WebService
public class TestWebservice {
    /**
     * 供客户端调用的方法
     * @param name
     * @return
     */
    public String getvalue(String name) {
        return "我叫"+name;
    }
    public static void main(String[] args) {
        //用于发布服务，第一个参数是服务地址，端口号需要未被占用的。第二个参数为本类
        Endpoint.publish("http://localhost:9002/Service/TestService",
        new TestWebservice());
        System.out.println("service succes");
    }
}

三、Webservice的代码生成

1.用dos命令生成代码（在idea中可以直接打开终端然后执行wsimport命令，前提是安装了jdk）

（1）wsimport -keep http://xxxx/xxx/xxx.asmx?wsdl

（2）wsimport -s d:\java\src -p com.nrj.client -keep http://xxxx/xxx/xxx.asmx?wsdl

         wsimport -s  文件路径 -p  包名 -keep http://xxxx/xxx/xxx.asmx?wsdl

 2.idea生成（直接右键open in terminal打开终端）

四、Webservice的客户端调用

1.简单调用（也是直接写个简单测试类，同时把生成的代码也放在项目中，然后运行就行）

package com.niu.ws;

import com.niu.TestWebservice;
import com.niu.TestWebserviceService;

public class ServiceTest {
    public static void main(String[] args) {
        TestWebservice ws = new TestWebserviceService().getTestWebservicePort();
        String name = ws.getvalue("张三");
        System.out.println("输出："+name);
    }
}

2.service编程实现调用

3.利用apache的AXIS直接调用远程的web service

4.HttpURLConnection调用方式

5.Ajax调用方式

五、wsdl的xml接口说明书

<service>    服务视图，webservice的服务结点，它包括了服务端点
<binding>     为每个服务端点定义消息格式和协议细节
<portType>   服务端点，描述 web service可被执行的操作方法，以及相关的消息，通过binding指向portType
<message>   定义一个操作（方法）的数据参数(可有多个参数)
<types>        定义 web service 使用的全部数据类型

<!--  Published by JAX-WS RI (http://jax-ws.java.net). RI's version is JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e.  -->
<!--  Generated by JAX-WS RI (http://jax-ws.java.net). RI's version is JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e.  -->
<definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://niu.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://niu.com/" name="TestWebserviceService">
<types>
<xsd:schema>
<xsd:import namespace="http://niu.com/" schemaLocation="http://localhost:9002/Service/ServiceHello?xsd=1"/>
</xsd:schema>
</types>
<message name="getvalue">
<part name="parameters" element="tns:getvalue"/>
</message>
<message name="getvalueResponse">
<part name="parameters" element="tns:getvalueResponse"/>
</message>
<portType name="TestWebservice">
<operation name="getvalue">
<input wsam:Action="http://niu.com/TestWebservice/getvalueRequest" message="tns:getvalue"/>
<output wsam:Action="http://niu.com/TestWebservice/getvalueResponse" message="tns:getvalueResponse"/>
</operation>
</portType>
<binding name="TestWebservicePortBinding" type="tns:TestWebservice">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
<operation name="getvalue">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
</operation>
</binding>
<service name="TestWebserviceService">
<port name="TestWebservicePort" binding="tns:TestWebservicePortBinding">
<soap:address location="http://localhost:9002/Service/ServiceHello"/>
</port>
</service>
</definitions>

自我分析：
1.服务端的类及方法：

TestWebservice ---->getvalue(String name)

2.客户端的使用：
（1）portType标签：portType中的name是原先的服务端类名，operation的name是服务端类名下的方法。
    TestWebservice ----->getvalue
（2）service标签：service中的name是服务端类名的实现类，port是可以获取该实现类的实例
    TestWebserviceService ---->TestWebservicePort
3.例子：
    TestWebservice ws = new TestWebserviceService().getTestWebservicePort();
    String name = ws.getvalue("张三");
4.总结：
  portType是接口标签
  service是实现类标签

六、常用的Webservice接口地址

IP地址来源搜索 WEB 服务（是目前最完整的IP地址数据）
Endpoint :http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx
Disco         :http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?disco
WSDL       :http://www.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl

随机英文、数字和中文简体字 WEB 服务
Endpoint :http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx
Disco        :http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?disco
WSDL       :http://www.webxml.com.cn/WebServices/RandomFontsWebService.asmx?wsdl

中国邮政编码 <-> 地址信息双向查询/搜索 WEB 服务
Endpoint :http://www.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx
Disco        :http://www.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx?disco
WSDL      :http://www.webxml.com.cn/WebServices/ChinaZipSearchWebService.asmx?wsdl

附参考链接

常用Webservice接口地址

https://blog.csdn.net/qq_41694906/article/details/88029533

关于 webservice客户端生成代码中的 JAXBElement <T> 字段类型的解决办法