前言

相信很多同行哪怕學(xué)了許多主流技術(shù)，但工作上依然免不了和傳統(tǒng)企業(yè)打交道，而這樣的企業(yè)往往還在用webservice做接口交互。

本文是作者近兩年和醫(yī)療行業(yè)的廠家打交道研究出來的一點調(diào)用webservice接口的心得，代碼在生產(chǎn)環(huán)境也用了挺久了，專門撈出來作為一期干貨分享給大家。

愿天下再無webservice！

正文

引入Hutool依賴就不說了，直接上硬菜。

1、選擇測試案例

因為公司內(nèi)部調(diào)用的廠家webservice不方便公開，所以我在網(wǎng)上選擇了一個免費的webservice接口作為案例。

地址： http://www.webxml.com.cn/WebServices/WeatherWebService.asmx

這里選擇第一個即可

調(diào)試提供方的webservice接口，首先要學(xué)會分析一下，基本上就是三原則。

方法名稱、命名空間、入?yún)⒚Q，如下圖紅框所示。

借助Hutool中的SoapClient來實現(xiàn)客戶端調(diào)用webservice的工具類。

首先，抽取命名空間和webservice地址，這里地址在調(diào)試階段可以寫死，后續(xù)再改為配置形式。

其次，定義調(diào)用客戶端方法，入?yún)⒎謩e是方法名、入?yún)⒚?、入?yún)⒅怠?/p>

這樣這個方法被調(diào)用時，就可以動態(tài)傳入webservice中不同的方法及參數(shù)，達(dá)到公用的目的。

紅框部分就是Hutool提供的SoapClient創(chuàng)建客戶端

webservice在Hutool的工具類集合中屬于非核心維護(hù)的一類工具，所以內(nèi)部本身是有一些地方?jīng)]有優(yōu)化的。

比如上面截圖中的用法就是官網(wǎng)的說明，直接SoapClient.create()來創(chuàng)建。

我們點進(jìn)去源碼看一下，發(fā)現(xiàn)每次都是new一個對象。

但因為封裝的比較深，我們還是寫個簡單的方法驗證一下是不是每次都新建了對象。

直接創(chuàng)建兩次對象，然后進(jìn)行比較，看是否指向同一個引用，發(fā)現(xiàn)返回是false，說明確實是不同的對象。

考慮到生產(chǎn)環(huán)境下，存在訪問量突增的可能，如果每次創(chuàng)建一個對象存在隱患，這里我們使用單例模式優(yōu)化一下。

單例模式的寫法很多，我這里選擇Holder方式，也就是雙重檢查鎖進(jìn)一步優(yōu)化之后的方式，在高并發(fā)場景下要更合適一點。

接下來，我們驗證下單例模式是否生效。

修改下之前創(chuàng)建客戶端的代碼，這樣每次請求時，只獲取一次客戶端就可以了。

官網(wǎng)沒有明確指出如何處理錯誤信息，但本身提供了相關(guān)的方法，我這邊通過不斷驗證之后，給出了最優(yōu)解。

調(diào)用一開始的webservice接口，看是否可以成功。

最后，這里展示下我負(fù)責(zé)的項目在生產(chǎn)環(huán)境調(diào)用第三方廠家webservice接口的入?yún)⒑统鰠?，同樣使用的是上面封裝的工具類。

對方的入?yún)⒑统鰠⒍际荴ML格式，最終效果如下：

總結(jié)

1、拿到一個webservice接口后，首先分析命名空間、方法名、入?yún)⒚謩e是什么;

2、使用Hutool提供的SoapClient工具類完成webservice的動態(tài)調(diào)用，同時配合單例模式進(jìn)行優(yōu)化;

3、錯誤信息處理的優(yōu)化。

4、最后有一點要注意，Hutool的webservice工具類還未支持Java17，只兼容了Java8，因此不建議高版本使用，但目前大多數(shù)企業(yè)依然是Java8為主流版本，后續(xù)Hutool肯定也會根據(jù)版本來升級的。

想查看完整工具類的也可以自己去下載，然后自己測一測效果。