新增 Web 服務參照

從 J2EE 1.3 規格開始,應用程式元件(應用程式用戶端、Web 模組、EJB 模組)可以利用稱為 Web 服務參照的「邏輯」名稱來定義指向外部 Web 服務的參照。在 J2EE 1.3 中,這些參照會新增至模組中的 webservicesclient.xml 中。從 J2EE 1.4 開始,參照會併入部署描述子中。

在部署時,Web 服務參照會連結於目標作業環境的 Web 服務介面。

您定義的每個 Web 服務參照,在這個應用程式元件中都會新增一個 service-ref 元素。Web 服務參照以它們定義在其中的應用程式元件或 Enterprise Bean 為範圍,因此,在執行時期,其他應用程式元件或 Bean 無法存取它們。 其他元件也可以定義同名的 Web 服務參照,不會發生名稱衝突。

註: 對於 J2EE 1.4 規格層次之前的專案層次而言,您可以利用工作台來定義 Web 服務參照,但不會在部署描述子(application-client.xml、web.xml 或 ejb-jar.xml)中加入 service-ref 元素。相反地,會在模組之 META-INF 資料夾的 webservicesclient.xml 檔中,宣告這項 Web 服務參照。比方說,如果您新增了指向 J2EE 1.3 應用程式用戶端的 Web 服務參照,這項參照會新增至 webservicesclient.xml 中。如果您新增了指向 J2EE 1.4 應用程式用戶端的 Web 服務參照,這項參照會新增至 application-client.xml 中。
提示: EJB 規格建議您在 Bean 環境的服務子環境定義(java:comp/env/service JNDI 環境定義)中,組織所有 Web 服務參照。

如果要定義 Web 服務參照,請執行下列動作:

  1. 從 J2EE 模組的部署描述子編輯器中,開啟「新增參照」精靈
  2. 選取服務參照,按下一步
  3. 從工作區的 Web 服務清單中,選取您要參照的 Web 服務。
  4. 名稱欄位中,指定參照的名稱,或接受精靈所提供的預設名稱(建議接受)。 部署描述子中的 service-ref-name 項目會使用在名稱欄位中輸入的值。這個名稱值就是 Enterprise Bean 程式碼所用的環境項目名稱。
  5. 下一步
  6. 說明文字區中,輸入參照的說明。
  7. 名稱空間 URI 欄位中,輸入新的名稱空間 URI,或接受精靈所輸入的值。 部署描述子 service-qname 項目的 xmlns:prefix 屬性會使用在這個欄位中輸入的值。
  8. 本端組件欄位中,指示訊息目的地會耗用或產生訊息。 部署描述子中的 service-qname 項目會使用在這個欄位中輸入的值:
    <service-qname xmlns:prefix="http://service.directory">
    		prefix:EmployeeDirectoryService
    </service-qname>
  9. 按一下完成
相關概念
用戶端部署描述子編輯器
相關工作
定義 J2EE 模組中的參照
新增 EJB 參照
新增訊息目的地參照
新增資源管理程式 Connection Factory 參照
新增資源環境參照
新增安全角色參照
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.