Web 服務(J2EE 1.3 至 J2EE 1.4)

J2EE 1.4 規格透過新的 JAX-RPC 1.0 API 增加了 Web 服務的支援。

JAX-RPC API 透過下列項目支援服務端點: J2EE 1.4 規格支援 J2EE 規格 (JSR 109) 的 Web 服務。JSR 109 定義了 Web 服務的部署需求並利用 JAX-RPC 程式設計模型。
利用 J2EE 移轉精靈移轉的 Web 服務成品如下:
  • Web 服務描述子
  • Web 服務用戶端描述子
  • JAX-RPC 對映描述子

移轉 Web 服務部署描述子

移轉至 J2EE 1.4 規格層次的 J2EE 1.3 專案所包含的任何 Web 服務部署描述子都會從 JSR-109 1.0 版(用於 J2EE 1.3)移轉至 J2EE 1.4。

JSR-109 1.0 版所定義的 Web 服務部署描述子是由 webservices.xml 檔、webservicesclient.xml 檔,以及 webservices.xmlwebservicesclient.xml 檔所參照的所有 JAX-RPC 對映部署描述子所組成。 如同其他 J2EE 部署描述子,移轉作業會修改描述子中所包含的資訊結構,以符合 J2EE 1.4 規格。Web 服務部署描述子特有的一項結構變更是完整名稱表示方式的改變。 在 JSR-109 1.0 版中,完整名稱是使用兩個連續的元素 <namespaceURI><localpart> 來表示,其分別包含名稱的名稱空間 URI 和本端部分。J2EE 1.4 中的完整名稱是以 XMLSchema QName 類型(使用 XML 名稱空間)為基礎。

以下提供移轉各 Web 服務部署描述子的進一步的詳細資料。
  • Web 服務描述子 (webservices.xml)

    webservices.xml 部署描述子存在於包含 J2EE Web 服務的 Web 專案和 EJB 專案中。<wsdl-port> 元素和 <soap-header> 元素都包含完整名稱, 且其內容會移轉成 J2EE 1.4 格式。

    webservices.xml 部署描述子在包含 J2EE Web 服務的 Web 專案中。<wsdl-port> 元素和 <soap-header> 元素都包含完整名稱, 且其內容會移轉成 J2EE 1.4 格式。

    比方說,如果 <wsdl-port> 在移轉之前的表示法如下:

    <wsdl-port>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBook</localpart>
    </wsdl-port>

    移轉之後,<wsdl-port> 的表示法如下:

    <wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>

    "pfx" 字首用來作為所有已移轉的完整名稱之名稱空間字首。

  • Web 服務用戶端描述子 (webservicesclient.xml)
    webservicesclient.xml 部署描述子在包含 J2EE Web 服務用戶端的 J2EE 1.3 Web 專案及應用程式用戶端專案中。在從 J2EE 1.3 移轉至 1.4 的期間,webservicesclient.xml 的內容會移轉並移至專案的部署描述子。所發生的程序如下:
    • 如果是 Web 專案,webserivcesclient.xml 中的所有 <service-ref> 元素都會移至 web.xml 的 <web-app> 元素之下。
    • 如果是應用程式用戶端專案,webservicesclient.xml 中的所有 <service-ref> 元素都會移至 application-client.xml<application-client> 元素之下。
    • Webservicesclient.xml 會被刪除。

    <service-qname> 元素和 <soap-header> 元素都包含完整名稱,且其內容會移轉成 J2EE 1.4 格式。比方說,如果 <service-qname> 在移轉之前的表示法如下:

    <service-qname>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBookService</localpart>
    </service-qname>

    移轉之後,<service-qname> 的表示法如下:

    <service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>

    "pfx" 字首用來作為所有已移轉的完整名稱之名稱空間字首。

  • JAX-RPC 對映描述子

    webservices.xmlwebservicesclient.xml 部署描述子都可以參照一或多個 JAX-RPC 對映部署描述子。

    webservices.xml 檔中,這些參照是包含在每個 <webservice-description> 元素之下的 <jaxrpc-mapping-file> 元素中。在 webservicesclient.xml 檔中,這些參照是包含在每個 <service-ref> 元素之下的 <jaxrpc-mapping-file> 元素中。

    在從 J2EE 1.3 移轉至 1.4 的期間,webservices.xmlwebservicesclient.xml 中所有的 JAX-RPC 對映部署描述子都會被移轉。移轉作業包括將所有完整名稱移轉成 J2EE 1.4 格式(請參閱上節的 webservices.xmlwebservicesclient.xml,以取得移轉後的完整名稱範例)。

相關工作
移轉安全 Web 服務
相關參考
Web 專案(Servlet 層次 2.3 至 Servlet 層次 2.4)
連接器專案(JCA 1.0 至 JCA 1.5)
J2EE 1.3 至 1.4 規格層次移轉
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.