在C++中建立並使用Web服務

      web服務的確是.net中讓人激動的部分——但它們本身比.net要大。其中的道理很簡單。幾乎所有你能叫出名字的服務都有一些執行伺服器端代碼的機制：你在瀏覽器的地址欄中輸入一個URL；接收到你的請求，伺服器上就開始運行什麼東西，然後以html頁面返回你要的結果。它可能是ASP， ASP.net，servlets，甚至是五年前通過CGI觸發的perl本。因此想象一下，如果運行代碼返回的是XML格式而非HTML格式的結果，並且服務要求並非是在瀏覽器地址欄中輸入的url，而是某些代碼中以HTTP中的GET方法向伺服器請求獲知URL地址。那麼你現在得到的是一個程式和程式間的串連。正巧每種語言都一個類庫，因此在HTTP中產生一個GET請求變得很簡單，解析出XML也有了些捷徑。這種方案給你提供了一種跨平台，跨語言，跨廠商乃至一切的方法，只要它們都在INTERNET上或是以其他的方式相連，我們就可以在某個程式的代碼中調用另外一個完全不同的機器上的代碼。
　　這就是隱藏在WEB服務背後的基本觀念。但把代碼當作函數而非頁面，你該如何將參數傳遞給函數？如果它返回一個複雜的資料類型怎麼辦？如果一個WEB伺服器上提供多於一種WEB服務怎麼辦？你如何找出那些名字並確認所需要的是哪種服務？這就是本文所要說明的問題。使用類似於WEB服務描述語言（說 wizdle會更酷一些）開發有一定的標準，它們涵蓋了這些技術細節。如果你用Visual Studio.NET建立一個WEB服務，它將滿足這些標準。如果你只是需要WEB服務，而不管它是如何建立的，通過Visual Studio.NET，你會發現借用他人的代碼是如此簡單。

　　編寫一個WEB服務
　　為了編寫一個WEB服務，你至少要用一種方法寫一個類。這個類必須有WebService屬性，方法也要有WebMethod屬性。舉例來說，一個類可以代表一位客戶，並且有一個可以獲知客戶船運資訊的方法，或是能夠在客戶購物單上增加新物品的方法。WEB方法能夠接受和返回任何可用的類型，包括你定義的對象執行個體。它們能做任何事情：維護資料庫資料的內外一致性，做任何形式的運算，甚至調用另外一個WEB方法來完成任務。為了說明這一點，我將用Add的方法寫一個 CalculatorService類，如你所猜得那樣，將兩個數字加起來並返回他們的和。
　　我在Visual Studio.NET中建立了一個新工程。在Visual C++工程模板中，我選擇了可管理的WEB服務。我將工程命名為Calculator。產生的程式碼封裝括了一個Class1類——雖然我可以在類的列表中選中它，並在屬性視窗總改變它的名字，但我做的第一件事還是手工地將這個名字的.cpp檔案和.h檔案都改成了CalculatorService。（我努力避免類和名字空間重名，它會使Intellisense弄混）不管我怎麼樣取名，我必須手動的對檔案Calculator.asmx作更改，我在 Solution Explorer中雙擊它然後修改。修改後是：

＜@ WebService Class=Calculator.CalculatorService %＞

　　我獲得了一個叫做HelloWorld()的方法，把它改成Add()很簡單——我僅僅更改了.cpp檔案和.h檔案的名稱，改變了簽名以便它能夠接受浮點數，然後加了些代碼以返回和。
　　類聲明的結束部分：

using <System.Web.Services.dll> using namespace System; using namespace System::Web; using namespace System::Web::Services; namespace Calculator { 　public __gc 　class CalculatorService : public WebService 　{ 　　public: 　　　[System::Web::Services::WebMethod] 　　　double Add(double x, double y); 　}; }

　　實現的部分:

#include "stdafx.h" #include "Calculator.h" #include "Global.asax.h" namespace Calculator { 　double CalculatorService::Add(double x, double y) 　{ 　　return x + y; 　} }

　　如果你是一直在跟著我做，你就能選擇“開始”菜單中的DEBUG來測試代碼。你並沒有真正運行一個WEB服務，但這會開啟一個WEB瀏覽器並將 Calculator.asmx載入進去。這是一個真正應用你定義的類和方法的在WEB伺服器上啟動並執行檔案，如果你願意，開啟一個瀏覽器視窗，輸入這個 URL：http://localhost/Calculator/Calculator.asmx。如果碰到任何問題，你要確定，你的WEB伺服器已經啟動，而且瀏覽器並沒有使用Proxy 伺服器。在Proxy 伺服器上，localhost是Proxy 伺服器，而不是你的機器。你可以開啟Add的連結看看為方法所產生的文檔，甚至可以通過鍵入數字並點擊執行按鈕來測試。這時，將開啟另一個瀏覽器視窗以顯示你要求的包圍在XML中的結果。比如，我輸入2和3，得到如下 XML:

＜?xml version="1.0" encoding="utf-8" ＞ ＜double xmlns="http://tempuri.org/&quot＞5＜/double＞

　　2加3等於5，WEB服務看起來是在工作。
 
　　使用WEB服務
　　寫一個WEB服務相當簡單：你只需要一個類屬性，一個方法屬性和calculator.asmx檔案，而這三個都由Visual Studio產生。如果只需其中一個會更簡單。開頭我建立了一個叫CalcTest to的可管理的C++程式。在能夠使用WEB服務之前，你需要讓你的工程知道去哪裡找到它。我在Solution Explorer中按右鍵CalcTest工程，然後選擇添加WEB參數。添加WEB參數的對話方塊有一個可編輯框讓你輸入URL。你也能用目錄在 INTERNET或是自己的測試機器上尋找WEB服務。
　　最簡單的方法是鍵入URL到Calculator.asmx然後按斷行符號。你會看到和以前運行WEB服務工程時同樣的檔案。點擊添加參數結束這個過程。
　　參數一旦添加，調用WEB服務就像調用任何C++類一樣。添加參數建立一個標頭檔，這個檔案在任何你想使用WEB服務時都可以包括進去。我把輸出 Hello World的行替換成了建立代表我的WEB服務的對象和使用它的代碼。更改過的CalcTest.cpp檔案是這樣的：

#include "stdafx.h" #using <mscorlib.dll> #include <tchar.h> #include "WebService.h" using namespace System; // This is the entry point for this application int _tmain(void) { 　CalculatorService * Calc = new CalculatorService; 　System::Console::WriteLine("1 plus 1 is ", 　__box(Calc->Add(1,1))); 　return 0; }

　　（如果關鍵字不響應，查看我前面關於裝箱和拆箱基本類型的專題文章）
   　當程式運行起來，它輸出的，和我料想的一點不差：
　　1 plus 1 is 2
　　從代碼中調用一個WEB方法就這麼簡單。如果你想知道在XML上發生了什麼，為何你不需要從內部把數字解析出來？這僅僅是在你添加WEB參數時，給予你的諸多方便之一。
　　關於此點的可能性無窮無盡。你在伺服器上啟動並執行任何代碼，如果你願意，都能被別的代碼通過Internet訪問。安全性，認證，加密以及其它的對你都是可用的，並且也都被SOAP（Web服務標準之一）所支援。既然那些檔案實際上都是ASP.NET的一部分，所有你知道的有關ASP.NET同樣可運用於.NET中的Web服務。現在為何不試試程式對程式的整合？