Web Services for Java EE 規格
Web Services for Java™ Platform, Enterprise Edition (Java EE) 規格中定義程式設計模型和執行時期架構,供實作基於 Java 語言的 Web 服務。Web Services for Java EE 規格的另一個名稱是「Java 規格需求 (JSR) 109」。該規格包含用於開發和實作 Web 服務的開放式標準。
Web Services for Java EE 規格以 Java EE 技術為基礎,並支援 Web 服務和用戶端的 Java API for XML Web Services (JAX-WS) 和 Java API for XML-based RPC (JAX-RPC) 程式設計模型,在可調整又安全的環境內,能夠在應用程式伺服器之間交互作業並具備可攜性。 此規格根據 Web 服務的業界標準(包括 Web 服務說明語言 (WSDL) 和 SOAP),說明 Web 服務的開發和部署。
您可以透過各種方式整合 Java EE 技術與 Web 服務。 您可以將 Java EE 元件公開為 Web 服務,例如 JavaBeans 和 Enterprise Bean。 當您將 Java EE 元件公開為 Web 服務時,以 Java 程式碼撰寫的用戶端,或不是以 Java 程式碼撰寫的現有 Web 服務用戶端,都可以存取這些服務。 Java EE 元件也可以當作 Web 服務用戶端。
Web Services for Java EE 規格是 Web 程式設計方面的理想平台,因為它提供開放式標準,可讓不同類型的語言、作業系統及軟體透過網際網路順暢溝通。
如果要將 Java 應用程式當作 Web 服務用戶端,WSDL 檔與 Java 應用程式之間必須存在對映。 若為 JAX-WS 應用程式,您可以使用註釋來定義此對映。您可以選擇性地使用 webservices.xml 部署描述子來指定 WSDL 檔的位置,並置換 @WebServices 註釋中定義的值。 若為 JAX-RPC 應用程式,您必須定義 JAX-RPC 對映檔。如需進一步瞭解 WSDL 檔案與 Web 服務應用程式之間定義的對映,依照所使用的程式設計模型,請參閱 Web 服務規格與 API 說明文件中的 JAX-WS 規格或 JAX-RPC 規格。
您可以使用 Java 元件來實作 Web 服務,作法是在 WSDL 檔中指定元件介面和連結資訊,並設計應用程式伺服器基礎架構來接受服務要求。
這整個封裝的程序都是根據 Web Services for Java EE 規格。
此規格特別針對 Web 服務定義 webservices.xml 部署描述子。 webservices.xml 部署描述子檔案定義一組 Web 服務,可供您部署在啟用 Web Services for Java EE 的儲存器中。
對於 JAX-WS Web 服務,webservices.xml 部署描述子是選用的,因為您可以利用註釋來指定部署描述子檔所包含的所有資訊。 您可以使用部署描述子檔來擴增或置換現有的 JAX-WS 註釋。 webservices.xml 部署描述子所定義的任何資訊會置換註釋所指定的任何對應資訊。
@WebService(wsdlLocation=”http://myhost.com/location/of/the/wsdl/ExampleService.wsdl”)
而 webservices.xml 為 WSDL 文件指定不同檔名,如下所示:
<webservices>
<webservice-description>
<webservice-description-name>ExampleService</webservice-description-name>
<wsdl-file>META-INF/wsdl/ExampleService.wsdl</wsdl-file>
…
</webservice-description>
</webservices>
則部署描述子 META-INF/wsdl/ExampleService.wsdl 中指定的值會置換註釋值。關於 Web 服務部署描述子檔案中指定的值與 @WebService 和 @WebServiceProvider 註釋的屬性,如需它們之間有何相關性的詳細資料,請參閱 Web Service for Java EE 規格第 5 節。
對於 JAX-RPC Web 服務,您必須在 webservices.xml 部署描述子檔案中定義部署性質。
- 埠名稱
- 埠服務實作
- 埠服務端點介面
- 埠 WSDL 定義
- 埠完整名稱
- JAX-WS Web 服務的 MTOM/XOP 支援
- JAX-WS Web 服務的通訊協定連結
- JAX-RPC 對映
- 處理程式(選用)
- Servlet 對映(選用)
如需支援的標準和規格的完整清單,請參閱 Web 服務規格與 API 說明文件。