標註 EJB Bean 來建立 Web 服務

您可以在 EJB Bean 中標註類型、方法、欄位及參數,以指定 Web 服務。

開始之前

必要條件:
  • 工作區包含的 EJB 3.x Session Bean 至少有一個公用方法。
  • 這個 EJB Bean 位於啟用 JAX-WS 的 EJB 專案中。
  • 專案的「目標執行時期」為 WebSphere® Application Server 7.0 版或更高版本。

關於這項作業

使用註釋從 EJB Bean 建立 Web 服務的步驟如下:
  1. 使用 @WebService 註釋及實作所需的其他任何註釋來標註 EJB Bean。
  2. 建立 Web 服務的 JMS 或 HTTP 路由器模組,如建立 Web 服務路由器模組中所述。從 WebSphere Application Server 第 8 版開始,如果您將 EJB 應用程式包裝在 WAR 模組中,則不需要建立路由器模組。
  3. 將應用程式發佈至伺服器,如藉由發佈至伺服器,從標註的 EJB Bean 建立 Web 服務中所述
如果要標註 EJB Bean,請執行下列動作:

程序

  1. 在「企業瀏覽器」視圖中,按兩下 Java™ Bean,在 Java 編輯器中開啟檔案。
  2. 在實作 Web 服務的 Java 類別上,指定 @WebService 註釋,以及 @Stateless、@Stateful 或 @Singleton 註釋。同時指定註釋(如果有的話)應該有的任何屬性。
    • 新增註釋時顯示的大部分錯誤,都可以利用建議的快速修正來解決。如果要顯示快速修正程式,請按一下錯誤標記。
    • 如果要將註釋或屬性新增至現有的註釋,您可以使用「註釋」視圖,而不需要手動將此資訊新增至類別。使用註釋時,此視圖會提供基本驗證和指引。
  3. 選用項目:使用這些及其他註釋來進一步自訂 Web 服務:
    • 在實作 Web 服務的 Java 類別上,在您要為服務自訂的每一個方法上指定 @WebMethod 註釋。 您可以使用此註釋來排除服務中的方法。依預設會公開服務中的所有公用方法,包括 Object 類別下的繼承方法。
    • 在 Web 服務中公開的方法上,使用 @WebParam 和 @WebResult 註釋,自訂參數和結果到訊息組件和 XML 元素之間的對映。
    • 在異常狀況類別上,指定 @WebFault 註釋將類別對映至 WSDL 錯誤。

結果

將註釋新增至 Bean 之後,「服務」視圖應該會在 JAX-WS 標題下列出 Web 服務。從這個視圖中,您可以用滑鼠右鍵按一下 Web 服務,並選取使用 Web 服務瀏覽器進行測試或使用通用服務用戶端進行測試,以測試 Web 服務。從這個視圖中,您也可以產生部署描述子,並管理與服務相關聯的原則集。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: twsanbuejb.html