使用Visual Studio.NET調用WebService

一、概述

很多次看到網友討論VC中調用WebService的問題，其實在Visual Studio.Net（下稱VS.NET）及其以後的版本中調用WebService已經變得相當簡單。你所要做的只是“找到 WebService的發布地址”，然後將其引用添加到VC項目中即可。接下來VS.NET幫你產生的代理類，會幫你搞定一大堆的麻煩事，包括：網路調 用、資料傳遞等等；什麼SOAP啊、網路啊，你都可以不管。

二、託管還是非託管？

　　對於VS.NET產生的C++代理類，很多人都認為必須使用Managed 程式碼，其實事實並非這樣。VS.NET可以產生託管和非託管兩個版本的代理類，至於要不要使用託管，那是你自己的選擇。
　 　具體地說，對於使用託管的程式，VS.NET會產生基於託管類庫的代理類；你可以在產生的程式碼中找到類的行：public System::Web::Services::Protocols::SoapHttpClientProtocol。對於不使用託管的程式， VS.NET會產生基於ATL的代碼；你可以在產生的程式碼中找到類似的行：template >。
我想，如果不是確實需要的話，大部份人會選擇非託管的方式，因為這起碼可以讓我們的程式脫離.Net Framework運行。

三、動態設定WebService調用地址

　　這也是網上討論得比較多的一個問題，因為WebSercie的地址不可能一成不變，特別是在開發調試的時候。幸運的是，在兩種版本的代理類中，都可以非常方便地在運行時設定WebService的地址。（具體做法參見執行個體）

四、程式樣本（非託管）

　　由於已經有文章詳細講述了 VC託管程式中調用 WebService 的過程，因此以下樣本只描述非託管VC程中調用WebService的方法。

１、建立一個非託管的MFC應用程式，注意是非託管的，如（圖１）

圖1、建立非託管程式
完成後，查看VC項目屬性，可以確認不使用託管

圖2、查看是否使用託管

2、添加WebService引用
在VC項目名稱上，單擊右鍵，選擇“添加Web引用”。如（圖3）：

圖3、添加Web引用

在彈出的“添加Web引用”對話方塊中，填入WebSercie的引用地址， 然後點擊“轉到按鈕”，可以看到WebService的提示頁面。

圖4、“添加Web引用”對話方塊

　　點擊頁面上的“Service Description” 連結可以看到具體的WebMethod的聲明。我的這個WebService樣本中，只定義了一個Web方法。該方法接受一個字串作為使用者名稱，並返回一個字串作為對使用者的問候語。如所示：

圖5、查看WebMethod原型

　　在中填入“Web引用名”，然後點擊“添加引用按鈕”。（在非託管版的代理類中，這裡填的“Web引用名”將沒有任保實質性的作用，所以隨 便填入一個名字即可。但是在託管版的代理類中，“Web引用名”將成為代量類的命名空間） 。接下來，VS.NET將產生一個WebService的代理類，產生完後，會自動開啟WebService.h標頭檔：

WebService.h並不是代理類，這個標頭檔其實是用於包含所有的代理類的標頭檔，你可以多添加幾個“Web引用”試試。

3、瀏覽代理類
　　我們不妨瀏覽一下產生的代理類，做到有個基本的瞭解。切換到“類別檢視”，可以看到一個“Debug”命名空間，全部展開，可以看到產生的代理類的全部成員：

圖6、瀏覽產生的程式碼

4、調用樣本
首先包含標頭檔，並開啟命名空間

#include "WebService.h"
using namespace Debug; // 這個命名空間是自動產生的，與Web服務的實現有關          

以下是調用代碼

void CInvokeDemoDlg::OnBnClickedButton1()
{
 // TODO: 在此添加控制項通知處理常式代碼

 // 因為產生的程式碼是基於ATL的，所以要初始化COM
 CoInitialize(NULL);

 HRESULT hr = S_OK;
 CComBSTR hiResult;
 CComBSTR username = "vckBase";

 CDebug* debug = new CDebug; // 代理對象

 // 可以調用SetUrl動態設定Web服務地址
 // debug->SetUrl("http://blog.eray.cn/debug.asmx");

 hr = debug->Hi(username,&hiResult); //注意，傳回值是以指標形式反回的

 if(FAILED(hr))
 {
  MessageBox("調用失敗");
 }
 else
 {
  CString str(hiResult);
  MessageBox(str,"調用結果");
 }

 delete debug;
 CoUninitialize();
}          

由於產生的代理類是基於ATL的，所以在調用前要初始化COM調用。在上述的代碼中就使用了CComBSTR而沒有直接使用BSTR，因為 CComBSTR屬於智能類型，可以自己管理記憶體配置，比較方便。 上述代碼中有一行被注釋的代碼調用了SetUrl來設定WebService的調用地址。在實際的項目中，可以將這個地址寫在設定檔中。
5、運行結果
來，看一下吧～

五、結束語

　　通過以上樣本可以看出，其實在VS.NET中實現非託管的C++調用WebService是相當簡單的。當然，在實際的使用過程中，為了程式的徤壯，還需要更多的代碼邏輯，比如錯誤處理等等。