WebService

本文參考了https://blog.csdn.net/c99463904/article/details/76018436甘耿。

一握爷、簡介

Web Service技術(shù)燃异， 能使得運行在不同機器上的不同應(yīng)用無須借助附加的、專門的第三方軟件或硬件冀痕， 就可相互交換數(shù)據(jù)或集成脆栋。依據(jù)Web Service規(guī)范實施的應(yīng)用之間打却， 無論它們所使用的語言纹磺、 平臺或內(nèi)部協(xié)議是什么施掏， 都可以相互交換數(shù)據(jù)钮惠。

簡單的說，WebService就是一種跨編程語言和跨操作系統(tǒng)平臺的遠程調(diào)用技術(shù)七芭。所謂跨編程語言和跨操作平臺素挽，就是說服務(wù)端程序采用java編寫，客戶端程序則可以采用其他編程語言編寫狸驳，反之亦然预明。跨操作系統(tǒng)平臺則是指服務(wù)端程序和客戶端程序可以在不同的操作系統(tǒng)上運行耙箍。 遠程調(diào)用撰糠，就是一臺計算機的應(yīng)用可以調(diào)用其他計算機上的應(yīng)用。例如：支付寶辩昆，支付寶并沒有銀行卡等數(shù)據(jù)阅酪，它只是去調(diào)用銀行提供的接口來獲得數(shù)據(jù)。還有天氣預(yù)報等汁针，也是氣象局把自己的系統(tǒng)服務(wù)以webservice服務(wù)的形式暴露出來术辐，讓第三方網(wǎng)站和程序可以調(diào)用這些服務(wù)功能。
XML,SOAP和WSDL就是構(gòu)成WebService平臺的三大技術(shù) 扇丛。

WebService采用Http協(xié)議來在客戶端和服務(wù)端之間傳輸數(shù)據(jù)术吗。WebService使用XML來封裝數(shù)據(jù)尉辑，XML主要的優(yōu)點在于它是跨平臺的帆精。

WebService通過HTTP協(xié)議發(fā)送請求和接收結(jié)果時，發(fā)送的請求內(nèi)容和結(jié)果內(nèi)容都采用XML格式封裝隧魄，并增加了一些特定的HTTP消息頭卓练，以說明HTTP消息的內(nèi)容格式，這些特定的HTTP消息頭和XML內(nèi)容格式就是SOAP協(xié)議規(guī)定的购啄。

WebService服務(wù)器端首先要通過一個WSDL文件來說明自己有什么服務(wù)可以對外調(diào)用襟企。簡單的說，WSDL就像是一個說明書狮含，用于描述WebService及其方法顽悼、參數(shù)和返回值曼振。 WSDL文件保存在Web服務(wù)器上，通過一個url地址就可以訪問到它蔚龙”溃客戶端要調(diào)用一個WebService服務(wù)之前，要知道該服務(wù)的WSDL文件的地址木羹。WebService服務(wù)提供商可以通過兩種方式來暴露它的WSDL文件地址：1.注冊到UDDI服務(wù)器甲雅，以便被人查找；2.直接告訴給客戶端調(diào)用者坑填。

WebService交互的過程就是,WebService遵循SOAP協(xié)議通過XML封裝數(shù)據(jù)抛人，然后由Http協(xié)議來傳輸數(shù)據(jù)。

二脐瑰、調(diào)用WebService

1妖枚、獲取WebService的wsdl文檔

WSDL(Web Services Description Language), web服務(wù)描述語言，他是webservice服務(wù)端使用說明書蚪黑，說明服務(wù)端接口盅惜、方法、參數(shù)和返回值忌穿，WSDL是隨服務(wù)發(fā)布成功抒寂，自動生成，無需編寫掠剑。

通過在webservice的URL后面加上"?wsdl"的方式屈芜。比如天氣預(yù)報的的就是http://ws.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl

2、閱讀wsdl文檔

Types - 數(shù)據(jù)類型定義的容器朴译，它使用某種類型系統(tǒng)(一般地使用XML Schema中的類型系統(tǒng))井佑、（入?yún)⒑统鰠⒌臄?shù)據(jù)類型）。
Message - 通信消息的數(shù)據(jù)結(jié)構(gòu)的抽象類型化定義眠寿，使用Types所定義的類型來定義整個消息的數(shù)據(jù)結(jié)構(gòu)（入?yún)⒑统鰠ⅲ?br> Operation - 對服務(wù)中所支持的操作的抽象描述躬翁，一般單個Operation描述了一個訪問入口的請求/響應(yīng)消息對（方法）。
PortType - 對于某個訪問入口點類型所支持的操作的抽象集合盯拱，這些操作可以由一個或多個服務(wù)訪問點來支持（服務(wù)類）盒发。它可以有一個或多個Operation
Binding - 特定服務(wù)訪問點與具體服務(wù)類的綁定（不看內(nèi)容，看關(guān)系）狡逢。
Port - 定義為webservice單個服務(wù)訪問點宁舰。
Service- 相關(guān)服務(wù)訪問點的集合。

wsdl.png

WSDL文檔應(yīng)該從下往上閱讀奢浑。

1.先看service標簽蛮艰，看相應(yīng)port的binding屬性，然后通過值查找上面的binding標簽雀彼。

2.通過binding標簽可以獲得具體協(xié)議等信息壤蚜，然后查看binding的type屬性

3.通過binding的type屬性即寡，查找對應(yīng)的portType，可以獲得可操作的方法和參數(shù)袜刷、返回值等嘿悬。

4.通過portType下的operation標簽的message屬性，可以向上查找message獲取具體的數(shù)據(jù)參數(shù)信息水泉。

3善涨、由工具生成客戶端代碼

有幾種方式生成客戶端代碼，我這里介紹一種方式：使用axis2.

首先去官網(wǎng)下載(http://axis.apache.org/axis2/java/core/download.html)草则，注意下載Binary distribution版的钢拧。

然后解壓到一個目錄。

接著設(shè)置環(huán)境變量：AXIS2_HOME：D:\software\axis2-1.7.9炕横。后面的是我解壓的目錄源内。

然后在PATH后面添加一個：%AXIS2_HOME%\bin

接著去到你想要生成文件的目錄打開cmd運行以下命令：

wsdl2java -uri http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl -p com.ltest -s -o stub

-uri后面的參數(shù)是wsdl文件的地址，可以是本地份殿，也可以是網(wǎng)絡(luò)地址膜钓。-p后面的是包，-o后面的將要生成的文件目錄名卿嘲。

然后將生成的XXXStub.java文件拖到項目的目錄颂斜，就可以直接使用了。

import org.junit.Test;

import java.rmi.RemoteException;

public class WebServiceTest {
    @Test
    public void testWebService() throws RemoteException {
        //創(chuàng)建WeatherWebServiceStub對象
        WeatherWebServiceStub stub = new WeatherWebServiceStub();
        //這是一個內(nèi)部類
        WeatherWebServiceStub.GetSupportCity city = new WeatherWebServiceStub.GetSupportCity();
        //設(shè)置請求參數(shù)
        city.setByProvinceName("湖北");
        //獲得響應(yīng)
        WeatherWebServiceStub.GetSupportCityResponse response = stub.getSupportCity(city);
        //將響應(yīng)解析為另一種類型
        WeatherWebServiceStub.ArrayOfString array = response.getGetSupportCityResult();
        //再將解析結(jié)果轉(zhuǎn)換為字符串?dāng)?shù)組
        String[] string = array.getString();
        //構(gòu)造請求參數(shù)
        WeatherWebServiceStub.GetWeatherbyCityName getWeatherbyCityName = new WeatherWebServiceStub.GetWeatherbyCityName();
        getWeatherbyCityName.setTheCityName("南京");
        //獲得響應(yīng)
        WeatherWebServiceStub.GetWeatherbyCityNameResponse cityNameResponse = stub.getWeatherbyCityName(getWeatherbyCityName);
        //同樣解析為另一種類型
        WeatherWebServiceStub.ArrayOfString getWeatherbyCityNameResult = cityNameResponse.getGetWeatherbyCityNameResult();
        String[] string1 = getWeatherbyCityNameResult.getString();
        for (String s : string1) {
            System.out.println(s);
        }
    }
}

上面的例子是使用的免費的天氣的WebService接口拾枣∥执可以看出，請求參數(shù)與響應(yīng)都是預(yù)先定義好的格式梅肤，在發(fā)送請求前以及得到響應(yīng)結(jié)果后都需要進行額外的操作司蔬。