一次搞定：借助Hutool封裝代碼快速解決webservice調(diào)用煩惱

作者：程序員濟(jì)顛 2023-10-23 18:50:52

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

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

愿天下再無(wú)webservice！

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

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

這里選擇第一個(gè)即可

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

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

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

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

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

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

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

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

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

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

但因?yàn)榉庋b的比較深，我們還是寫(xiě)個(gè)簡(jiǎn)單的方法驗(yàn)證一下是不是每次都新建了對(duì)象。

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

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

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

接下來(lái)，我們驗(yàn)證下單例模式是否生效。

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

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

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

最后，這里展示下我負(fù)責(zé)的項(xiàng)目在生產(chǎn)環(huán)境調(diào)用第三方廠家webservice接口的入?yún)⒑统鰠ⅲ瑯邮褂玫氖巧厦娣庋b的工具類(lèi)。

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

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

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

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

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

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

責(zé)任編輯：龐桂玉來(lái)源： 51CTO博客