1.基础问题
1.1 soup-Simple Object Access Protocal简单对象访问协议
a).承载在http协议之上,http支持传输img/html/文件等,soup请求和响应域都是xml.
c).wsdl->Web Services Description Language, 网络服务接口文档 ,用于描述Web service函数的参数及其返回值的.
http://www.webservicex.net/CurrencyConvertor.asmx?wsdl //请求后加?wsdl返回的即是对应的wsdl文件
1.2 可供测试的webservice
2. 示例1-postman发起即可
requestHeader
Content-Type:application/soap+xml; charset=utf-8
Content-Length:380
SOAPAction:http://WebXml.com.cn/getSupportCity //如果在post数据域中传递方法名,则不需要传递
requestBody
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetGeoIP xmlns="http://www.webservicex.net/">
<IPAddress>180.102.21.198</IPAddress>
</GetGeoIP>
</soap12:Body>
</soap12:Envelope>
ResponseBody
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetGeoIPResponse xmlns="http://www.webservicex.net/">
<GetGeoIPResult>
<ReturnCode>1</ReturnCode>
<IP>180.102.21.198</IP>
<ReturnCodeDetails>Success</ReturnCodeDetails>
<CountryName>China</CountryName>
<CountryCode>CHN</CountryCode>
</GetGeoIPResult>
</GetGeoIPResponse>
</soap:Body>
</soap:Envelope>
9. Java发布Webservice服务
10. WSDL文件-Web Services Description Language(XML子集)
a). <import>相当于java的import
b). xmlns相当于java的import,和地址后面的targetNameSpace是对应的
c). targetName相当于java的package
10.1 通过soupUI生成入参报文和URL
a). 安装soupUI->SOAP->Initial WSDL->标签中填入相应值即可
10.2 WSDL转成java文件
a). 首先新建一个 “Dynamic Web Project”, 比如: WebServiceClientTest.这个的用处是为了存放产生的Java代码。
b). 工程->右键->WebServiceClientTest , New-->Others --->Web Services-->Web Service Client->在Service definition 输入wsdl的地址
滑动条拉到Develop client 上。
c). 一直下一步就产生Java Code了。
d). 产生的Code中, 有一个Java 文件以Proxy结尾, 这个就是调用的Class了
10.5 WSDL文件格式-xml
10.5.1 -webservice中使用的数据类型
为了最大程度的平台中立性,WSDL 使用 XML Schema 语法来定义数据类型。
10.5.2 函数(操作)的入参和出参描述
a). 接口中的每一个方法对应两个message
//示例
<wsdl:message name="GetKeyAndSignalizationRequest">
<wsdl:part name="body" element="kas_v1:GetKeyAndSignalizationRequest"/>
</wsdl:message>
<wsdl:message name="GetKeyAndSignalizationResponse">
<wsdl:part name="body" element="kas_v1:GetKeyAndSignalizationResponse"/>
</wsdl:message>
10.5.3 端口-最重要-wsdl中可执行的操作及信息
a). 下面包含N个Operation,每个operation对应一个操作
b).
//示例
<wsdl:portType name="KeyAndSignalizationPortType">
<wsdl:operation name="getKeyAndSignalization">
<wsdl:input message="tns:GetKeyAndSignalizationRequest" name="KeyAndSignalizationInput"/>
<wsdl:output message="tns:GetKeyAndSignalizationResponse"/>
</wsdl:operation>
<wsdl:operation name="heartbeat">
<wsdl:input message="tns:HeartbeatRequest" name="heartbeatInput"/>
<wsdl:output message="tns:HeartbeatResponse"/>
</wsdl:operation>
</wsdl:portType>
10.5.4 -实现类-为每一端口(portType)定义消息格式和协议细节
a). <binding>元素两个属性,name-binding名称,type指向portType中一个值
b). <soap:binding> style-取值rpc或document,取document;transport定义要使用的SOAP协议,取HTTP
c). <soap:operation> soapAction在httpHeader中传给server,需要唯一,暴露给外界调用的操作
//示例
<wsdl:binding name="KeyAndSignalizationV1SoapBinding" type="defs:KeyAndSignalizationPortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="getKeyAndSignalization">
<soap:operation soapAction="cks-ws-keyAndSignalization"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
10.5.5 -定义ws的名称
port[address] 定义ws绑定的地址
//示例
<wsdl:service name="KeyAndSignalizationV1Service">
<wsdl:port name="KeyAndSignalizationV1SoapPort" binding="tns:KeyAndSignalizationV1SoapBinding">
<soap:address location="cks-ws-keyAndSignalization" />
</wsdl:port>
</wsdl:service>