從 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 服務參照,請執行下列動作: