標註 Java Bean 來建立 Web 服務

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

開始之前

必要條件:
  • 工作區包含的 Java Bean 至少有一個公用方法。
  • 此 Java Bean 位於 Web 專案或基本 Java 專案中。

關於這項作業

如果要標註 Java Bean,請執行下列動作:

程序

  1. 在「企業瀏覽器」視圖中,按兩下 Java Bean,在 Java 編輯器中開啟檔案。
  2. 在實作 Web 服務的 Java 類別上,指定 @WebService 註釋。 同時指定註釋(如果有的話)應該有的任何屬性。
    • 新增註釋時顯示的大部分錯誤,都可以利用建議的快速修正來解決。如果要顯示快速修正程式,請按一下錯誤標記。
    • 如果要將註釋或屬性新增至現有的註釋,您可以使用「註釋」視圖,而不需要手動將此資訊新增至類別。使用註釋時,此視圖會提供基本驗證和指引。
  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: twsandoc001.html