熟悉將用於 Apache Tuscany SCA for C++ 的 API。您將通過本文了解該 API 的主要組成部分，以便快速入門。

　　構建並連線簡單的 C++ 服務元件

　　關於 Tuscany

　　Apache Tuscany 是正處於孵化期的 Apache Software Foundation 專案。此專案的目標之一是獲得實現以下服務元件體系結構(Service Component Architecture，SCA)規範的 C++ 執行時：

• 　　SCA 組裝模型 (SCA Assembly Model)
• 　　SCA C++ 客戶機和實現 (SCA C++ Client and Implementation)
• 　　在本文中，我們將詳細說明採用 C++ 針對 Apache Tuscany C++ 執行時開發和部署服務元件的步驟。

　　介紹

　　Tuscany C++ 服務元件體系結構 (SCA) 執行時允許使用標準 C++ 程式碼構建 SCA 元件，並將其部署到 SCA 執行時可以查詢和載入的位置。為了實現此元件動態載入功能，執行時需要一系列描述檔案，這些構件以及您自己的標頭檔案一起用於生成代理和包裝，以允許從其他元件或客戶機程式碼採用與處理本地 C++ 物件類似的方式呼叫您的元件。

　　我們將首先建立一個簡單的 SCA 元件，然後建立第二個元件，並將二者連線到一起。

　　我們使用 Microsoft Visual Studio 作為開發環境，但也可以使用命令列編譯器和文字編輯器。您將瞭解如何設定 Studio 專案和開發應用程式。

　　注意：Tuscany SCA 依賴於 Tuscany SDO 專案和 Apache Axis2/C 專案。在開始工作前，必須確保在您的 PATH 環境變數中設定了 Tuscany SCA/SDO 庫和 Apache Axis 庫。有關更多資訊，請參見專案下載說明。

　　Tuscany SCA C++ 執行時將需要知道模組和元件所部署到的位置。部署根目錄使用環境變數 TUSCANY_SCACPP_SYSTEM_ROOT 進行標識。我們將馬上設定此變數，以便能夠從 Visual Studio 內執行我們的測試程式。如果您使用的是命令列，則在執行前都不需要設定這些內容。

　　TUSCANY_SCACPP_SYSTEM_ROOT 指定執行時將用於尋找已部署模組和子系統的路徑，我們將在稍後對此予以說明。根目錄必須具有兩個子目錄，分別名為“modules”和“subsystems”。

　　使用控制面板設定：TUSCANY_SCACPP_SYSTEM_ROOT=c:/mybasicsample。

　　轉到“控制面板”、“系統”，然後選擇“高階”選項卡，然後單擊“環境變數”按鈕。單擊“新建”按鈕，並將“變數名”設定為 TUSCANY_SCACPP_SYSTEM_ROOT，將“變數值”設定為 c:/mybasicsample。然後單擊“確定”，以設定此環境變數。

　　建立名為 mybasicsample 的目錄，其中包含兩個子目錄，分別名為 modules 和 subsystems。

　　現在已經準備好，可以進行部署了。我們可能應該編寫一些能夠部署的東西。

 簡單回顧一下 SCA 規範(您已經讀過了此規範——對嗎?)，就會記得 SCA 系統包含一個或多個子系統。每個子系統包含模組元件的列表。每個模組元件實際上是由模組實現的。在 C++ 中，存在一組描述性 XML 檔案，用於在編譯時生成服務代理和包裝以及在執行時查詢提供的服務。在開始進行開發前，有必要對這些檔案進行一下了解。描述子系統的檔案必須命名為 sca.subsystem，且必須儲存在自己的子目錄中，其位於根目錄中的 subsystems 目錄下。sca.subsystem 檔案描述子系統中涉及哪些模組元件。模組元件可以視為子系統的簡單部件，模組元件具有名稱，且同時指示實現模組元件行為的模組：

　　清單 1. 模組元件

<subsystem xmlns="http://www.osoa.org/xmlns/sca/0.9" name="MyServiceSubsystem">         <moduleComponent name="MyModuleComponent" module="FloatConverter" /> </subsystem>

　　清單 1 告知 SCA 執行時，模組元件“MyModuleComponent”是由名為“FloatConverter”的模組實現的，因此我們必須構建此模組。

　　sca.subsystem 檔案實際上是執行時構件，編譯時沒有用處。其他檔案(元件型別檔案和 sca.module 檔案)對“FloatConverter”模組進行描述，以便能在執行時找到它。這些檔案還幫助程式碼生成器為服務構建包裝和代理。我們將在下面的開發過程中更為詳細地討論這些檔案。

　　現在讓我們回到這一過程的開頭。我們希望將 C++ 類作為服務部署，並將服務放入名為“FloatConverter”的模組中。以下步驟將說明如何完成此任務。

　　首先，儘管可能有存在冗餘的風險(很多人肯定之前已經進行過此工作了)，我們將建立一個示例 C++ 應用程式。

　　注意：在開始開發過程前，您必須下載 SCA/SDO 程式碼並對其進行構建，或下載二進位制版本，以便稍後告知專案在何處查詢 SCA 執行時。設定兩個環境變數，分別名為 TUSCANY_SCACPP 和 TUSCANY_SDOCPP，指向 SCA 和 SDO 專案的部署目錄，在這兩個目錄下存在相應的 bin、lib 和 include 目錄。

　　首先，我要建立一個抽象基類，用於表示我們要公開的服務。這與定義 Java 介面等價。我們在此處建立的標頭檔案將由客戶機應用程式用於解釋可用的服務介面。

　　以下就是這個類，位於名為“Example.h”的標頭檔案中：

……

檢視原文