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

必備條件:

您正要建立的 Web 服務是作為 Enterprise Bean 的用戶端。您必須先部署好 Enterprise Bean,才能啟動 Web 服務。

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

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

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

從 Enterprise Bean 建立 Web 服務

  1. 切換至 J2EE 視景(視窗 > 開啟視景 > J2EE)。
  2. 在「專案瀏覽器」視圖中,展開「EJB 模組」,選取要從中產生 Web 服務的 Session Bean。
  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. 「選取物件」頁面:如果您先選取 Session Bean 再啟動精靈, 這個頁面的欄位應該會預先填入。如果沒有的話,請按一下瀏覽 EJB Bean。請在開啟的視窗中,選取用來產生 Web 服務的 Enterprise Bean 所在的 EAR 專案 - 這會將這個 EAR 所包含的 Stateless Enterprise Bean 移入下面的表格中。
  6. 「服務部署配置」頁面:指定伺服器和用戶端部署設定。
    1. 按一下編輯,選取 IBM® WebSphere® 執行時期環境, 再選取要在其中執行 Web 服務和 Web 服務用戶端的伺服器。 如果您要使用 IBM SOAP 執行時期環境或 Apache Axis 1.0 執行時期環境,請參閱適當的作業。
    2. 選取 Service 專案和 Web 服務的 EAR。 如果它們還不存在,精靈會自動建立它們。
    3. 選取要在其中建立 Web 服務用戶端之專案的類型和名稱。如果您輸入現有專案的名稱,專案類型欄位必須符合現有專案的類型。 如果您輸入名稱的專案不存在,精靈會自動建立這個專案。請注意,只有 Web 專案是支援的 Axis 和 SOAP 執行時期用戶端專案類型。 如果您要在 Java、EJB 或應用程式用戶端專案中建立用戶端,您必須選取用戶端的 WebSphere 執行時期環境。
    4. 選取現有的 EAR 或輸入唯一名稱,將 Web 服務用戶端關聯於 Web 服務 EAR 以外的 EAR。附註:在 Web 服務和 Web 服務用戶端上選取不同的 EAR,可以減少發生執行時期錯誤的機會,但會使用比較多的系統資源。
  7. 「Web 服務 EJB 配置」頁面:選取「路由器」專案(這必須是預先存在的 EJB 專案)。如果您有預先存在的服務端點介面,您可以選擇使用它。另外,也可以由 Web 服務精靈來產生一個服務端點介面。請選取傳輸類型:SOAP over HTTP 或 SOAP over JMS。 如果您選取 JMS,請完成必要的 JMS URI 內容。請選取任何欄位,再按 F1 來取得各欄位的詳細資訊。
  8. 在精靈的「Web 服務 Java Bean 身分」頁面中:這個頁面會列出 Web 服務 URI 和產生的 WSDL 檔的位置。這個頁面有下列選項:
    • 方法畫面會顯示 Bean 中的方法摘要。您可以選擇併入或移除所產生 Web 服務中的方法。
    • 選取 Web 服務的樣式和編碼。只有 Document/Literal 是符合 WS-I 標準。
    • 選擇啟用安全。啟用安全會使 Web 服務成為不符 WS-I 標準。
    • 定義自訂套件至名稱空間對映。
  9. 「Web 服務套件至名稱空間對映」頁面:如果您已在上一畫面中選取定義套件至名稱空間的自訂對映,您可以按一下新增,在這個畫面中輸入您的自訂對映配對。另外,您也可以按一下匯入來匯入 .properties 檔中的自訂對映配對。內容檔的內容格式必須是 package=namespace
  10. 「Web 服務測試」頁面:如果您選擇要測試 Web 服務,請選取所產生 Web 服務的測試機能,再按一下「啟動」。這會在 Web 服務瀏覽器中開啟 Web 服務。請選取您要測試的作業,輸入必要的資訊,再按一下執行。結果會顯示在「狀態」窗格中。測試好 Web 服務之後,請關閉瀏覽器視窗,再按下一步
  11. 如果您選擇要產生 Proxy,這時就會顯示「Web 服務 Proxy」頁面。用戶端 Proxy 會提供遠端程序呼叫介面給您的 Web 服務。Java 用戶端 Proxy 的預設資料夾是 / EJBWebProjectClient。 您可以選擇性地選擇啟用所產生 Proxy 的安全,或定義自訂套件至名稱空間對映。
  12. 「Web 服務用戶端套件至名稱空間對映」頁面:如果您已在上一畫面中選取定義套件至名稱空間的自訂對映,您可以按一下新增,在這個畫面中輸入您的自訂對映配對。 另外,您也可以按一下匯入來匯入 .properties 檔中的自訂對映配對。內容檔的內容格式必須是 package=namespace
  13. 如果您選擇要測試產生的 Proxy,這時會顯示「Web 服務用戶端測試」頁面。請利用這個頁面來選取下列選項:
    • 選取您的測試機能。您可以在 Universal Test Client 或 Web 服務瀏覽器中測試產生的 Proxy, 也可以產生範例 Web 服務 JSP。
    • 如果您選擇利用 JSP 來測試 Proxy,您可以選取 JSP 要放在其中的資料夾,且您可以選擇要併入 JSP 的方法。
  14. 如果您選擇要發佈您的 Web 服務,請利用「Web 服務發佈」頁面來選取要在其中發佈的 UDDI 登錄。按一下完成
  15. 建立好 Web 服務之後,會發生下列情況,這會隨著您選取的選項而不同:
    • 如果您選擇利用 Web 服務 JSP 來測試產生的 Proxy, 該 Proxy 就會於 Web 瀏覽器中的下列 URL 啟動:http://localhost: port/ EJBWebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp。您可以選取一個方法、輸入方法的值, 然後按一下呼叫,來利用這個範例應用程式測試 Web 服務。方法的結果會顯示在結果窗格中。
    • 如果您選擇利用 Universal Test Client 來測試產生的 Proxy,它將在瀏覽器視窗的下列 URL 啟動:http://localhost:9080/UTC/preload?object= BeanPackage. BeanServiceProxy。 請在「參照」窗格的「物件參照」下,展開 Proxy Stub 來顯示 Web 服務的方法。按一下您要測試的方法,在「參數」窗格中輸入值,再按一下呼叫。下面會產生結果。
    • 如果您選擇要利用「Web 服務瀏覽器」測試 Web 服務,這時會開啟「瀏覽器」。請選取您要測試的作業,輸入必要的資訊,再按一下執行。結果會顯示在「狀態」窗格中。
    • 如果您已經選取發佈 Web 服務,將會啟動「Web 服務瀏覽器」,並顯示將您的 Web 服務發佈至 IBM UDDI Test Registry 時所需的頁面。請遵循發佈 Web 服務中的指示來完成這項作業。

如果需要 EJB 的詳細資訊,請參閱 EJB 應用程式開發文件。如果需要從 EJB 建立 Web 服務的範例, 請參閱「指導教學展示區」和「範例展示區」。

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