使用 IBM SOAP 執行時期環境從 Enterprise Bean (EJB) 建立 Web 服務

必備條件:

「Web 服務」精靈可協助您建立新的 Web 服務、進行部署配置,以及部署 Web 服務到伺服器。一旦部署了 Web 服務,精靈會協助您產生用戶端 Proxy 和範例應用程式來測試 Web 服務。在完成測試後,您可以使用「匯出」精靈將 Web 服務發佈至 UDDI Business Registry。

有關 EJB 工具的進一步資訊,請參閱 EJB 工具。

附註:Rational Developer 產品支援從 Stateless Session Enterprise Bean 建立 Enterprise Bean Web 服務。

您正要建立的 Web 服務是作為 Enterprise Bean 的用戶端。Enterprise Bean 必須在啟動 Web 服務之前部署。

如果要從 Enterprise Bean 建立 Web 服務,請執行下列步驟:

  1. 切換至 J2EE 視景(視窗 > 開啟視景 > J2EE)。
  2. 在「專案瀏覽器」視圖中,選取要在其中建立 Web 服務的 Web 專案。

    或者,您可以從 J2EE 視景啟動「Web 服務」精靈, 方法是選取將從哪一個 Enterprise Bean 建立 Web 服務,然後遵循其餘的步驟。

  3. 按一下檔案 > 新建 > 其他。接著選取 Web 服務以便顯示各種 Web 服務精靈。然後選取 Web 服務精靈。按下一步
  4. 「Web 服務」頁面:從 Web 服務類型下拉清單中,選取 EJB Web 服務。您可以選擇性地執行下列動作:
    • 在 Web 專案中啟動 Web 服務 - 如果您沒有選取這個選項,您必須手動啟動 Web 服務。您必須選取這個選項,才能啟用這個頁面中的其他選項。
    • 啟動 Web 服務瀏覽器,將 Web 服務發佈至 UDDI 登錄。
    • 產生 Web 服務的 Java™ Bean 用戶端 Proxy。產生的 Java Bean 用戶端 Proxy 將提供遠端程序呼叫介面給 Web 服務。
    • 測試 Web 服務 - 這可讓您在產生 Proxy 之前,在 Web 服務瀏覽器中測試 Web 服務。
    • 透過 TCP/IP 監視器傳送 Web 服務的資料傳輸,這可讓您監看 Web 服務所產生的 SOAP 資料傳輸, 並測試此一資料傳輸是否符合 WS-I 標準。
  5. 「服務部署配置」頁面:指定伺服器和用戶端部署設定。
    1. 按一下編輯,選取 IBM® SOAP 執行時期環境,再選取要在其中執行 Web 服務和 Web 服務用戶端的伺服器。 如果您要使用 IBM WebSphere 執行時期環境或 Apache Axis 1.0 執行時期環境,請參考適當的作業。
    2. 選取 EJB 專案、路由器專案和 Web 服務的 EAR。 如果它們還不存在,精靈會自動建立它們。
    3. 選取要在其中建立 Web 服務用戶端之專案的類型和名稱。如果您輸入現有專案的名稱,專案類型欄位必須符合現有專案的類型。 如果您輸入名稱的專案不存在,精靈會自動建立這個專案。請注意,只有 Web 專案是支援的 Axis 和 SOAP 執行時期用戶端專案類型。 如果您要在 Java、EJB 或應用程式用戶端專案中建立用戶端,您必須選取用戶端的 WebSphere 執行時期環境。
    4. 選取現有的 EAR 或輸入唯一名稱,將 Web 服務用戶端關聯於 Web 服務 EAR 以外的 EAR。附註:在 Web 服務和 Web 服務用戶端上選取不同的 EAR,可以減少發生執行時期錯誤的機會,但會使用比較多的系統資源。
  6. 「Web 服務 EJB 配置」畫面:按一下瀏覽 EJB Bean。這可讓您瀏覽 J2EE 視景來找出 Enterprise Bean。
  7. 在「瀏覽 Enterprise Bean」對話框中,選取包含 Enterprise Bean 和 EJB 專案的企業應用程式專案。之後,再選取您的 Enterprise Bean 和 EJB 專案。按一下確定。這時會自動完成 EJB 配置(如 JNDI 提供者 URL、JNDI 起始環境定義 Factory、EJB JNDI 名稱、EJB Home 介面類別名稱,以及 EJB 遠端介面路徑名稱等)。 請按一下確定

    附註: 「瀏覽 Enterprise Bean」對話框只會顯示含有所選 Web 專案的企業應用程式專案。您只能使用這個對話框, 來選取那些包含在同一個企業應用程式專案中, 當作 Web 專案的 Enterprise Bean 和 EJB 專案。

  8. 「Web 服務 Java Bean 身分」畫面:指定 Web 服務 URI 和範圍。您可以選擇性地選擇使用靜態方法和安全 SOAP。您可以修改這個頁面所列出的文件和資料夾名稱,或接受預設名稱。
  9. 「Web 服務 Java Bean 方法」畫面:選取要顯示的方法,選擇輸入和輸出編碼樣式。如果您要檢視 Java 至 XML 對映,請選取顯示伺服器類型對映
  10. 「Web 服務 Java 至 XML 對映」頁面:如果您選擇檢視對映,您可以在這裡見到它們。另外,您也可以選取編輯和使用自訂對映來自訂您的對映。
  11. 「Web 服務測試」頁面:如果您選擇要測試 Web 服務,請選取所產生 Web 服務的測試機能,再按一下「啟動」。這會在 Web 服務瀏覽器中開啟 Web 服務。請選取您要測試的作業,輸入必要的資訊,再按一下執行。結果會顯示在「狀態」窗格中。測試好 Web 服務之後,請關閉瀏覽器視窗,再按下一步
  12. 「產生 Web 服務連結 Proxy」畫面:如果您選擇要產生 Proxy,請選擇連結和 Proxy 選項。
  13. 「Web 服務用戶端測試」頁面:請利用這個頁面來選取下列選項:
    • 選取您的測試機能。您可以在 Universal Test Client 或 Web 服務瀏覽器中測試產生的 Proxy, 也可以產生範例 Web 服務 JSP。
    • 如果您選擇利用 JSP 來測試 Proxy,您可以選取 JSP 要放在其中的資料夾,且您可以選擇要併入 JSP 的方法。
    • 選取在伺服器中執行測試來自動啟動伺服器。
  14. 「Web 服務發佈」頁面:選擇是否要將這個 Web 服務發佈在 UDDI 登錄中。按一下完成
建立好 Web 服務之後,會發生下列情況,這會隨著您選取的選項而不同:

重要事項:如果您的方法包括範例不支援的類型,如:陣列、索引內容和集合, 那麼範例會省略方法,而您會接收到警告訊息。

當您從 Enterprise Bean 建立 Web 服務後, 就可以使用 Universal Test Client 來測試 Web 服務的方法,然後將 Web 服務發佈至 UDDI Business Registry。 如果需要測試和發佈應用程式的詳細資訊,請參閱「伺服器」工具文件。

如果需要 EJB 的詳細資訊,請參閱 EJB 應用程式開發文件。

使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.