spring boot-Soap协议客户端集成（根据WSDL文档调用WebService、maven的jaxb2插件）

一、背景

Springboot和SOAP协议之间进行交互的方式，基本可以分为种情况，一种是作为客户端去调SOAP接口，另一种是作为服务端提供SOAP接口。

本文主要讲解，作为客户端请求SOAP接口。

二、基本概念

1. 什么是webservice

Web service是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML（标准通用标记语言下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。

其实就是跨语言和操作系统的的远程调用技术。比如亚马逊，可以将自己的服务以webservice的服务形式暴露出来，我们就可以通过web调用这些，无论我们使用的语言是java还是c，这也是SOA应用一种表现形式。

2. WSDL

有人在WebService开发的时候，特别是和第三方有接口的时候，走的是SOAP协议，然后用户（或后台）给你一个WSDL文件（或网址）。

WSDL (Web Services Description Language,Web服务描述语言)是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程过程调用)。

WSDL是一个用于精确描述Web服务的文档，WSDL文档是一个遵循WSDL-XML模式的XML文档。

一个WSDL文档通常包含8个重要的元素，即definitions、types、import、message、portType、operation、binding、service元素。这些元素嵌套在definitions元素中，definitions是WSDL文档的根元素。

WSDL 服务进行交互的基本元素：

• Types（消息类型）：数据类型定义的容器，它使用某种类型系统（如 XSD）。

• Message（消息）：通信数据的抽象类型化定义，它由一个或者多个 part 组成。

• Part：消息参数

• PortType（端口类型）：特定端口类型的具体协议和数据格式规范。它由一个或者多个 Operation组成。

• Operation（操作）：对服务所支持的操作进行抽象描述，WSDL定义了四种操作：
  1.单向（one-way）：端点接受信息；
  2.要求-响应（solicit-response）：端点发送消息，然后接受相关消息；
  3.通知（notification[2] ）：端点发送消息。

• Binding：特定端口类型的具体协议和数据格式规范。binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用。

• Port：定义为绑定和网络地址组合的单个端点。

• Service：相关端口的集合，包括其关联的接口、操作、消息等。
  外层结构里面也可能有多层结构。**service元素包含一个或者多个port元素，其中每个port元素表示一个不同的Web服务。**port元素将URL赋给一个特定的binding，甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。

    <wsdl:service name="HelloService">
      <wsdl:port name="HelloServiceHttpPort"
          binding="tns:HelloServiceHttpBinding">
          <wsdlsoap:address
              location="http://localhost:8080/xfire/services/HelloService" />
      </wsdl:port>
  </wsdl:service>
  

2.1 如何查看WSDL文档(重要)

接口文档如下：以下是公共对外开放的查询手机号归属地的一个借口文档：
WSDL:http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl

This XML file does not appear to have any style information associated with it. The document tree is shown below.
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://WebXml.com.cn/" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://WebXml.com.cn/">
<wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
<a href="http://www.webxml.com.cn/" target="_blank">WebXml.com.cn</a> <strong>国内手机号码归属地查询WEB服务</strong>，提供最新的国内手机号码段归属地数据，每月更新。<br />使用本站 WEB 服务请注明或链接本站：<a href="http://www.webxml.com.cn/" target="_blank">http://www.webxml.com.cn/</a> 感谢大家的支持！<br />&nbsp;
</wsdl:documentation>
<wsdl:types>
<s:schema elementFormDefault="qualified" targetNamespace="http://WebXml.com.cn/">
<s:element name="getMobileCodeInfo">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="mobileCode" type="s:string"/>
<s:element minOccurs="0" maxOccurs="1" name="userID" type="s:string"/>
</s:sequence>
</s:complexType>
</s:element>
<s:element name="getMobileCodeInfoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="getMobileCodeInfoResult" type="s:string"/>
</s:sequence>
</s:complexType>
</s:element>
<s:element name="getDatabaseInfo">
<s:complexType/>
</s:element>
<s:element name="getDatabaseInfoResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="getDatabaseInfoResult" type="tns:ArrayOfString"/>
</s:sequence>
</s:complexType>
</s:element>
<s:complexType name="ArrayOfString">
<s:sequence>
<s:element minOccurs="0" maxOccurs="unbounded" name="string" nillable="true" type="s:string"/>
</s:sequence>
</s:complexType>
<s:element name="string" nillable="true" type="s:string"/>
<s:element name="ArrayOfString" nillable="true" type="tns:ArrayOfString"/>
</s:schema>
</wsdl:types>
<wsdl:message name="getMobileCodeInfoSoapIn