[C#]動態叫用Web Service

  • 130277
  • 0
  • C#
  • 2009-09-02

Web Service對大家來說想必都不陌生,也大都了解Web Service可以應用在哪些範圍,跨平台系統整合、跨語言整合、跨網域資料處理等繁雜的問題,在沒有Web Service前我們需要進行較繁雜的處理程序才能完成,但有了Web Service後,這樣的問題似乎很輕易的被解決了。

摘要

Web Service對大家來說想必都不陌生,也大都了解Web Service可以應用在哪些範圍,跨平台系統整合、跨語言整合、跨網域資料處理等繁雜的問題,在沒有Web Service前我們需要進行較繁雜的處理程序才能完成,但有了Web Service後,這樣的問題似乎很輕易的被解決了。

Web Service很方便,在.net領域,只要會寫程式的人大多可以透過VS輕易的完成一個Web Service,而呼叫端只要將這個Web Service加入WebReference後就可以使用這個Web Service中的WebMethod,在一般的應用下是這個樣子的,但在以下這個狀況,我們要使用Web Service會遭遇到一些這個問題:

※在擁有Web Service參考且發行過的站台中再次加入新的Web Service參考

而本文件的做法可以克服到以上問題。

 

一般Web Service的做法

建立Web Service

當我們建立一個Web Service時,我們會看到以下內容,VS會先為我們建立一個HelloWorld的WebMethod。

 

01 [WebService(Namespace = "http://tempuri.org/")]
02 [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
03 public class WebService : System.Web.Services.WebService
04 {
05     public WebService()
06     {
07         //如果使用設計的元件,請取消註解下行程式碼 
08         //InitializeComponent(); 
09     }

10     [WebMethod]
11     public string HelloWorld()
12     {
13         return "Hello World";
14     }

15 }

 

加入Web參考

當我們想要引用上述的WebMethod時,我們會採用『加入Web參考』的方式將Web Service參考進來:

clip_image002

接著將此Web參考命名為HelloService:

clip_image004

加入參考後,我們就可以在站台的App_WebReferences中看到這個Web Service:

clip_image007

使用Web Service

要使用剛剛建立的WebReference只要加入以下的程式碼就可以呼叫這個Web Service了:

1 HelloService.Service tService = new HelloService.Service();
2 string tMsg = tService.HelloWorld();

 
問題起源

發行網站

若這是一個要提供給客戶的無Source網站,我們通常會進行『發行』,發行後每個網頁的後端程式會被編譯成一個dll檔,而App_WebReferences目錄也會被編譯成一個App_WebReferences.dll,如下圖:

clip_image009

在已發行站台中加入新的Web參考

我們將發行過的網站開啟,我們可以看到這個站台中有一個PrecompiledApp.config的檔案,代表這個站台已先行編譯過了,如下圖:

clip_image011

接著我們執行先行編譯站台的Default.aspx,OK,開的起來,代表這個站台發行過程中沒有出現任何問題,接著我們為這個新站台加入另一個Web Service參考『localhost』,加入過程很順利,也沒有發生任何阻礙,

clip_image013

但當我再次嘗試開啟Default.aspx時會出現這個錯誤:

clip_image015

錯誤的訊息告知:不允許使用目錄’/TestInvokeWebservice/App_WebReferences/’因為已先行編譯應用程式,該站台我們在先前的步驟中已經發行過了,而發行過程我們也已經編譯過該網站。

 

問題發生的原因

ASP.NET 2.0在佈署上提供了兩種方式:

1. Source佈署:直接將Source放在站台上,透過動態編譯的方式compile程式

2. 無Source佈署:即先行編譯,會先將cs端的程式先compile成dll,避免程式外洩

現今架構下,產品多走2.,專案可能多走1.,在2的佈署架構下,我們會將我們的網站進行發行,發行後App_Code、App_WebReferences等ASP.NET目錄都會被各自compile成一個獨立的dll檔,並會直接放在發行後站台的bin目錄下,而dll的名稱是唯一的

當我們嘗試在一個已先行編譯過的網站中(若已包含App_Code.dll、App_WebReferences.dll)加入App_Code、App_WebReferences這兩個目錄,我們就會看到上頭的錯誤畫面。

所以我們遭遇到了一個問題,我們如何在先行編譯過的站台中加入新的Web Service參考?如果我今天接受到的就是別人已經發行過的網站,我如何去添加我想要的Web Service參考呢?

解決方案

針對此問題,我們的解決方案叫:動態叫用Web Service

您甚至不用將Web Service加入參考,你只要知道該Web Service的佈署路徑,要呼叫的function名稱等,這個作法就可以幫您呼叫到該Web Service,以下說明做法。

動態叫用function內容

在此架構下,我們寫了一個function做為動態叫用Web Service的服務,以下先說明此function的參數,本function有五個參數,內容分別如下,要特別說明的是pArgs這個參數,您需要將要呼叫的Web Service function所要的參數組成object[]傳進來:

01 /// <summary> 
02         /// 動態呼叫Web Service
03         /// </summary> 
04         /// <param name="pUrl">WebService的http形式的位址,EX:http://www.yahoo.com/Service/Service.asmx </param> 
05         /// <param name="pNamespace">欲呼叫的WebService的namespace</param> 
06         /// <param name="pClassname">欲呼叫的WebService的class name</param> 
07         /// <param name="pMethodname">欲呼叫的WebService的method name</param> 
08         /// <param name="pArgs">參數列表,請將每個參數分別放入object[]中</param> 
09         /// <returns>WebService的執行結果</returns> 
10         /// <remarks> 
11         /// 如果呼叫失敗,將會拋出Exception。請呼叫的時候,適當截獲異常。 
12         /// 目前知道有兩個地方可能會發生異常: 
13         /// 1、動態構造WebService的時候,CompileAssembly失敗。 
14         /// 2、WebService本身執行失敗。 
15         /// </remarks> 

16         public object InvokeWebservice(string pUrl, string @pNamespace, string pClassname, string pMethodname, object[] pArgs)
17                WebClient tWebClient = new WebClient();
18                 //讀取WSDL檔,確認Web Service描述內容
19                 Stream tStream = tWebClient.OpenRead(pUrl + "?WSDL");
20                 ServiceDescription tServiceDesp = ServiceDescription.Read(tStream);
21                 //將讀取到的WSDL檔描述import近來
22                 ServiceDescriptionImporter tServiceDespImport = new ServiceDescriptionImporter();
23                 tServiceDespImport.AddServiceDescription(tServiceDesp, "", "");
24                 CodeNamespace tCodeNamespace = new CodeNamespace(@pNamespace);
25                 //指定要編譯程式
26                 CodeCompileUnit tCodeComUnit = new CodeCompileUnit();
27                 tCodeComUnit.Namespaces.Add(tCodeNamespace);
28                 tServiceDespImport.Import(tCodeNamespace, tCodeComUnit);
29
30                 //以C#的Compiler來進行編譯
31                 CSharpCodeProvider tCSProvider = new CSharpCodeProvider();
32                 ICodeCompiler tCodeCom = tCSProvider.CreateCompiler();
33
34                 //設定編譯參數
35                 System.CodeDom.Compiler.CompilerParameters tComPara = new  
36 System.CodeDom.Compiler.CompilerParameters();
37                 tComPara.GenerateExecutable = false;
38                 tComPara.GenerateInMemory = true;
39
40                 //取得編譯結果
41                 System.CodeDom.Compiler.CompilerResults tComResult =  
42 tCodeCom.CompileAssemblyFromDom(tComPara, tCodeComUnit);
43
44                 //如果編譯有錯誤的話,將錯誤訊息丟出
45                 if (true == tComResult.Errors.HasErrors)
46                 {
47                     System.Text.StringBuilder tStr = new System.Text.StringBuilder();
48                     foreach (System.CodeDom.Compiler.CompilerError tComError in tComResult.Errors)
49                     {
50                         tStr.Append(tComError.ToString());
51                         tStr.Append(System.Environment.NewLine);
52                     }

53                     throw new Exception(tStr.ToString());
54                 }

55
56                 //取得編譯後產出的Assembly
57                 System.Reflection.Assembly tAssembly = tComResult.CompiledAssembly;
58                 Type tType = tAssembly.GetType(@pNamespace + "." + pClassname, true, true);
59                 object tTypeInstance = Activator.CreateInstance(tType);
60                 //若WS有overload的話,需明確指定參數內容
61                 Type[] tArgsType = null;
62                 if (pArgs == null)
63                 {
64                     tArgsType = new Type[0];
65                 }

66                 else
67                 {
68                     int tArgsLength = pArgs.Length;
69                     tArgsType = new Type[tArgsLength];
70                     for (int i = 0; i < tArgsLength; i++)
71                     {
72                         tArgsType[i] = pArgs[i].GetType();
73                     }

74                 }

75
76 //若沒有overload的話,第二個參數便不需要,這邊要注意的是WsiProfiles.BasicProfile1_1本身不支援Web Service overload,因此需要改成不遵守WsiProfiles.BasicProfile1_1協議
77                 System.Reflection.MethodInfo tInvokeMethod = tType.GetMethod(pMethodname, tArgsType);
78                 //實際invoke該method
79                 return tInvokeMethod.Invoke(tTypeInstance, pArgs);
80 }

 

動態叫用function的code sample

以上的source您可隨意利用,原則上這個寫法大致滿足多數應用,而以下我們再補充AP段的寫法,當我想要透過以上的function去幫我呼叫一個外部的Web service:

以下範例說明透過DynamicInvokeWebservice. InvokeWebservice去呼叫InvokeWS中的HelloWorld function,程式的寫法如下,傳入要呼叫的WS路徑、namespace、class name、function name、參數列表,然後呼叫InvokeWebservice就可以呼叫到遠端的Web service了。

01         string tUrl = "http://localhost:8627/InvokeWS/Service.asmx";//WebService的http形式的地址
02         string tNamespace = "DynamicWS";//欲呼叫的WebService的命名空間
03         string tClassname = "Service";//欲呼叫的WebService的類名(不包括命名空間前綴)
04         string tMethodname = "HelloWorld";//欲呼叫的WebService的方法名
05         object[] tArgs = new object[2];//參數列表
06         tArgs[0] = "Jimmy";
07         tArgs[1] = "你好嗎?";
08
09         DynamicInvokeWebservice tDynamicInvokeWebservice = new DynamicInvokeWebservice();
10         object tReturnValue =  
11 tDynamicInvokeWebservice.InvokeWebservice(tUrl, tNamespace, tClassname, tMethodname, tArgs);
下面我們下了一個中斷點,經過測試後,我們確實可以呼叫到目標的Web service function,解決了我們前頭所遭遇到的問題:

 

clip_image018

 

後記

原則上這個作法應用的.net中的Reflection(反射)技術,若對這技術有興趣的人可以上MSDN參考。

 

版本修改:

如果要動態Invoke的Web Service是Windows整合驗證,那程式必須要做以下兩點修正,測試結果是沒問題的,如果Web Service有特別限定使用者的話(跨不同主機、跨Domain),請自行指定Credentials的帳號密碼:


//要加這行:透過目前預設的使用者登入
tWebClient.Credentials = System.Net.CredentialCache.DefaultCredentials;
//讀取WSDL檔,確認Web Service描述內容
Stream tStream = tWebClient.OpenRead(pUrl + "?WSDL");

 


System.Reflection.MethodInfo tInvokeMethod = tType.GetMethod(pMethodname, tArgsType);

//要加這三行:如果是Windows整合驗證的話,透過SoapHttp來對要invoke的目標WS做驗證
SoapHttpClientProtocol webRequest = (SoapHttpClientProtocol)tTypeInstance;
webRequest.PreAuthenticate = true;
webRequest.Credentials = System.Net.CredentialCache.DefaultCredentials;

//實際invoke該method
return tInvokeMethod.Invoke(tTypeInstance, pArgs);

 

參考資料:

HOW TO: 傳遞目前的憑證至 ASP.NET Web 服務

Dynamic Discovery and Invocation of Web services

游舒帆 (gipi)

探索原力Co-founder,曾任TutorABC協理與鼎新電腦總監,並曾獲選兩屆微軟最有價值專家 ( MVP ),離開職場後創辦探索原力,致力於協助青少年培養面對未來的能力。認為教育與組織育才其實息息相關,都是在為未來儲備能量,2018年起成立為期一年的專題課程《職涯躍升的關鍵24堂課》,為培養台灣未來的領袖而努力。