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