先創(chuàng)建一個webservice服務(wù),用來測試使用。提供三個服務(wù)接口,一個無參數(shù)、一個字符串參數(shù)、一個含有多個實(shí)體類參數(shù)(實(shí)體類參數(shù)也含有嵌套和集合)以及返回帶有嵌套和集合的返回?cái)?shù)據(jù),用來做測試使用,基本上可以涵蓋幾乎所有的webservice服務(wù)的情況了。
有關(guān)測試實(shí)體類
啟動webservice服務(wù)備用
請求端程序,支持.netframework 4.6.1+、.net core+和.net 5+所有版本,都可以通過nuget來引用 Wesky.Net.OpenTools 包。需要引用最新的版本,以保證功能完善。我此處使用.net 8的控制臺來引用,大佬們可以根據(jù)自己程序情況進(jìn)行引用,framework4.6以下版本不適用。
為了方便使用,我本地也直接編寫幾個實(shí)體類,用來傳參和做返回值接收使用:
先實(shí)例化一個WebserviceHelper對象,如果有用IOC容器的大佬,比如說使用asp.net core程序等,可以對該接口和類進(jìn)行依賴注入的注冊。如果沒用IOC容器的大佬,可以直接這樣new一個使用。此處我用new一個對象的使用方式來使用。并且獲取到asmx的url地址,地址此處需要添加?wsdl后綴。
申明要訪問的服務(wù)的名稱,例如HelloWorld,然后直接調(diào)用。由于沒有參數(shù),所以參數(shù)直接設(shè)為null
運(yùn)行程序進(jìn)行調(diào)用,可以看到獲取到了返回值的xml文檔。
直接調(diào)用的時(shí)候,返回值是一個 OpenToolResult
由于咱們的返回值就一個基礎(chǔ)類型string,所以需要調(diào)用解析基礎(chǔ)類型值的方法,得到最終的返回消息為 Hello World。
基礎(chǔ)類型值解析方法定義如下:
傳入?yún)?shù)為:獲取到的返回值、節(jié)點(diǎn)名稱(一般是方法名稱+“Result”)、命名空間,命名空間在調(diào)用的時(shí)候,會被存儲到類型OpenWebserviceInfo的屬性O(shè)penWebservice集合(是一個OpenWebserviceDocCache類型的集合)里面去,通過url地址和接口方法名字可以匹配到對應(yīng)的命名空間。
OpenWebserviceDocCache類型定義如下:
接著試一下傳入一個基礎(chǔ)類型參數(shù)的情況。訪問Hola方法,傳入Wesky字符串,成功獲取到返回值 Wesky World。
接下來試一下傳入多個實(shí)體類參數(shù),并且按照上面webservice的內(nèi)容,會返回一個其他一個實(shí)體類消息。
回看一下TestService服務(wù)接口的實(shí)現(xiàn),說明動態(tài)訪問是成功的。
訪問webservice方法定義說明。參數(shù)可以傳0個或多個參數(shù),會用來和解析度wsdl地址的同名方法服務(wù)參數(shù)個數(shù)做匹配,如果不匹配,則會提示錯誤信息。返回值Result.IsSuccess如果是true,代表發(fā)送請求成功;如果解析錯誤或者發(fā)送請求失敗等,則提示false,并且Message屬性會有具體錯誤信息描述。
返回值為實(shí)體類的解析方法定義說明。以上請求TestSevice服務(wù)接口時(shí)候,返回值是實(shí)體類,如果需要匹配本地的實(shí)體類,需要訪問 ExtractCustomerValueFromXml方法進(jìn)行解析處理。例如上面?zhèn)魅氲氖荝esultInfo類型作為返回值接收類。
一些核心代碼: