BEA Tuxedo 控件 8.1 上手指南

作者：
日期：2003-10-31

演示BEA Tuxedo 控件 8.1

內容列表

概覽

按照本上手指南中提到的步驟，您將可以在WebLogic Workshop上運行我們提供的Web服務應用程序，該應用程序將會訪問Tuxedo Bike Order Fulfillment Inventory應用程序提供的服務。從Web服務應用程序中訪問Tuxedo服務是藉助Tuxedo 控件來完成的。

JumpStart工具包中包含一個Tuxedo 控件擴展（名爲uBike.jcx的Java控件）和一個Web服務文件（uBikeWS.jws），以及uBike Tuxedo 應用程序（tuxubikeapp.zip）。

uBike應用程序提供的服務包括 SEARCHINVENTORY、ORDERITEM、SOLDITEM、MODIFYITEM 和DUMPDATABASE。除了DUMPDATABASE，其他服務的輸入都是FML32 buffer。所有服務的返回值都是FML32 buffer。除此之外，Tuxedo應用程序中還含有Tuxedo simpapp ATMI server，它可以提供一個名爲TOUPPER的Tuxedo服務，該服務接收一個STRING buffer並返回一個STRING buffer。

這個demo只演示如何使用現有的代碼；也就是說，它不是一個開發demo，而是一個開發完成的代碼的demo。您可以通過它來了解如何在WebLogic Workshop中使用Tuxedo 控件。

準備

爲了運行這個demo，您需要安裝WebLogic Platform 8.1。您還需要安裝Tuxedo系統（運行Tuxedo 8.1、8.0、7.1 或 6.5）來運行Tuxedo應用程序。不需要使用C/C++編譯器，因爲我們已經提供了Tuxedo應用程序的二進制文件。如果現在沒有安裝Tuxedo，您最好安裝和配置Tuxedo 8.1。所有產品都可以從以下地址獲得http://commerce.bea.com/index.jsp。

本demo假定Tuxedo 和 WebLogic Platform 8.1 被安裝在同一個系統之上。儘管實際上產品並沒有這個需求，但爲了簡化demo的安裝和配置，我們做了這個假設。目前，該demo只支持Windows平臺。

安裝和配置Jumpstart應用程序
1. 解壓縮TuxedoControlJSKit.zip 的內容到一個空目錄中，保留zip文件的目錄結構。該操作將創建兩個子目錄，分別是"tux"和"wlw"。Tux目錄中包含Tuxedo應用程序以及安裝腳本。Wlw目錄中包含部分Web服務應用程序。
2. 啓動WebLogic Workshop。選擇"開始"菜單，打開"所有程序-> BEA WebLogic Platform 8.1->WebLogic Workshop 8.1"。
3. 當WebLogic Workshop IDE啓動之後，單擊"File->New->Application"創建一個名爲uBikeApp的新應用程序。選擇"Empty Application"，並選擇"workshop"作爲server，如下圖所示。

4. 爲了使Tuxedo 控件能夠被您的應用程序所使用，您必須添加TuxedoControl.jar文件到Weblogic Workshop IDE的[application]面板的[Libraries]文件夾中。右鍵單擊剛創建的應用程序的[Libraries]文件夾並選擇[Add Library]。這將打開一個對話框，請瀏覽到TuxedoControl.jar文件所在的位置。它位於"BEAHOME" 目錄下的 ext_components\Tuxedo\controls目錄中，其中"BEAHOME"代表WebLogic Platform 8.1的安裝位置。

5. 創建一個名爲"uBikeWS"的新Web服務項目。在[application]面板中右鍵單擊"uBikeApp"應用程序，選擇[New Project]。請確保在右邊的列中選擇了正確的Web服務項目類型。

6. 導入位於"wlw"目錄下的Jumpstart工具包提供的文件。在[application]面板中右鍵單擊"uBikeApp"應用程序，選擇[Import]。瀏覽到"wlw"目錄，同時選中"controls"目錄和"uBikeWS.jws"文件，單擊[Import]按鈕。

7. 啓動WebLogic Server。在Weblogic Workshop IDE中選擇"Tools->Weblogic Server->Start Weblogic Server"。
8. 在命令行提示窗口中執行"setWLSEnv.cmd"腳本，設置WebLogic Server環境變量。setWLSEnv.cmd位於"BEAHOME"下的weblogic81\server\bin目錄中，其中"BEAHOME"代表WebLogic Platform 8.1的安裝目錄

9. 如果不存在"TUXDIR"環境變量，請設置它，並使其指向您的Tuxedo安裝位置。
10. 進入步驟1創建的"tux"目錄，執行ant命令。該命令將會執行"build.xml"腳本，這個腳本將會：
1. 在系統上配置我們提供的Tuxedo應用程序
2. 爲系統和Tuxedo應用程序配置WebLogic Server提供的WebLogic Tuxedo Connector (WTC) 服務。
3. 啓動Tuxedo應用程序。
在執行過程中，腳本將會提示輸入用戶名和密碼。該用戶名和密碼就是您的 WebLogic Server的管理員用戶名和密碼。默認爲"weblogic"和"weblogic"。除此之外，腳本還可能彈出消息，說無法找到實例，可以忽略它。

11. 在[application]面板的"uBikeWS"項目下雙擊"uBikeWS.jws"文件，打開Java Web服務文件。

12. 在WebLogic Workshop中單擊[start]按鈕或按下"Ctrl+F5"，啓動Web服務應用程序。集成的測試瀏覽器應該出現在屏幕上，並顯示出"uBikeWS.jws "文件提供的Web服務。在測試瀏覽器中向下拉動滾動條，察看所有可用的Web服務。

13. 在Workshop測試瀏覽器中，在"SearchInventory"Web服務的"color"參數中輸入"GREEN"，並單擊[SearchInventory]按鈕，您將獲得一組綠色自行車的列表。

14. 向下拖動滾動條，察看包含了所有綠色自行車的Web服務響應。

15. 從結果集中選擇並複製一個序列號，單擊頁面頂部的[Test Operations]鏈接。如果您選擇的條目沒有庫存，下一步的結果將會略有不同。
16. 粘貼序列號到"soldBike"服務的[SerialNumber]字段中，單擊[soldBike]。
17. 檢查頁面底部的成功消息。

18. 再次選擇[Test Operations]鏈接，並執行"getAllBikes"服務，察看自行車是否已經不在商品目錄中。
19. 選擇[Test Operations]鏈接運行"SearchInventory"服務，輸入一或多個字段，比如在[Color]中輸入"RED"、在[Size]中輸入"56"，並單擊"SearchInventory"按鈕。察看返回的結果，並確認只返回符合指定條件的自行車。

20. 如果願意，可以在Tuxedo系統的命令提示窗口中使用tmadmin命令顯示服務的統計情況。使用printserver (psr)或printservice (psc)顯示各個服務器或服務的請求統計。請確認已經設置了TUXCONFIG環境變量。如果沒有設置，請執行位於Jumpstart工具包的"tux"目錄下的"setenv.cmd"命令腳本。
21. 察看控件擴展uBike.jcx的代碼
a. 它只是一個接口定義。開發擴展不需要任何代碼，所有的一切都是描述性的。
b. 操作的方法簽名決定了數據在buffer中如何存放。
c. 註解可以提供描述服務的附加信息
d. 一般只有那些十分了解Tuxedo應用程序的人才能開發該文件。即他需要了解服務、buffer內容、等等。
e. 該控件擴展可以被一個Java控件封裝，這個Java控件可以改變用戶看到的接口。
f. 該控件可以應用於各種Workshop類型的應用程序。
22. 察看Web服務擴展uBikeWS.jws的代碼
a. 控件實例被聲明但沒有被初始化。當控件真正被使用時，Workshop運行時環境執行實例化的工作。
b. SearchInventory、orderBike、modifyBike、soldBike、和getAllBikes Web服務只是簡單地發佈它們底層使用的Tuxedo 服務。Web服務實現沒有執行任何操作。
c. getBikesWithinPriceRange Web服務的確執行了一些處理。它調用控件擴展的getAllBikes方法，然後基於傳遞給Web服務的參數進行結果過濾。