使用 IBM® WebSphere JAX-WS 執行時期環境從 WSDL 文件產生 Web 服務用戶端

Web 服務用戶端精靈可協助您產生 Java™ Bean Proxy 及範例應用程式。範例 Web 應用程式會示範如何編寫 Proxy 檔。

開始之前

必要條件:
  • 如果您使用 WebSphere® Application Server,強烈建議您在執行 Web 服務精靈之前先啟動伺服器,因為啟動 WebSphere Application Server 可能需要花費數分鐘,視電腦的速度而定。 如果要啟動伺服器,請在「伺服器」視圖中選取它(視窗 > 顯示視圖 > 伺服器),然後按一下滑鼠右鍵選取啟動。
  • 探索 WSDL 文件或將 WSDL 文件匯入至工作區。您可以使用包含 service 元素的 WSDL 檔。您可以從工作區中使用位於 URL 的靜態 WSDL 檔,或者,如果您在工作區有標註的 Bean 作為 JAX-WS Web 服務,您可以使用 WebSphere Application Server Feature Pack for Web Services 執行時期動態產生的 WSDL 檔。此 WSDL 位於 URL:http://localhost:port/service_project_name/service_nameService?wsdl。 例如,在 Feature Pack for Web Services 隨附的指導教學和範例所建立的通訊錄 JAX-WS Web 服務中,動態 WSDL 檔位於此 URL:http://localhost:9082/jwsAddressBook/AddressBookService?wsdl。
限制: 如果您要在任何 J2EE 儲存器之外執行簡式 Java Web 服務用戶端,您必須在簡式 Java 專案中產生 Web 服務用戶端。Web 服務精靈無法建立簡式 Java 專案。 最接近的形式為公用程式專案,但不支援從公用程式專案執行簡式 Java Web 服務用戶端(無儲存器)。 執行 Web 服務用戶端精靈之前,您必須先建立簡式 Java 專案。簡式 Java 專案的「JDK 編譯器」相符性層次必須設為執行 WebSphere Application Server 的 Java 版本。

關於這項作業

如果要從探索到的 WSDL 文件產生 Java 用戶端 Proxy 和範例應用程式,請執行下列動作:

程序

  1. 切換至 Java EE 視景(視窗 > 開啟視景 > Java EE)。
  2. 按一下檔案 > 新建 > 其他。選取 Web 服務,以顯示各種 Web 服務精靈。選取 Web 服務用戶端精靈。按下一步。
  3. Web 服務頁面,選取您用來產生用戶端的 WSDL 檔。您也可以選擇執行下列動作:
    1. 使用滑塊選取您要完成的 Web 服務用戶端開發階段。這會在剩餘的精靈畫面上設定數個預設值。
      • 開發:開發 Web 服務用戶端的 WSDL 定義及實作。其中包括建立模組之類的作業,在適當情況下,模組將包含產生的程式碼、WSDL 檔、部署描述子及 Java 檔。
      • 組合:確保當目標應用程式伺服器有需要時,負責管理 Web 服務用戶端的專案會與 EAR 相關聯。
      • 部署:建立用戶端的部署程式碼。
      • 安裝:在目標伺服器上安裝及配置 Web 模組和 EAR。需要對 WSDL 檔的端點所做的任何變更都在此階段中完成。
      • 啟動:當用戶端安裝在伺服器之後啟動伺服器。
      • 測試:提供各種選項來測試服務,例如使用「Web 服務瀏覽器」或範例 JSP。
    2. 選取伺服器:畫面上會顯示預設伺服器。如果您要將服務部署到不同的伺服器,請按一下鏈結來指定另一部伺服器。
      此作業支援下列伺服器執行時期環境:
      • WebSphere Application Server 7.0 版或更新版本
      • WebSphere Application Server Liberty 8.5.5 版
    3. 選取執行時期:畫面上會顯示預設執行時期。如果您要將服務部署到不同的執行時期,請按一下鏈結來指定不同的執行時期。
    4. 選取用戶端專案:畫面上會顯示工作區中選取的專案。如果要選取不同的專案和 EAR,請按一下專案鏈結。 您可以選取 Web 專案、EJB 專案、Java 專案或 Java EE 應用程式用戶端專案,作為用戶端程式碼的位置。請確定選為「用戶端 Web 專案」的專案與「服務 Web 專案」不同,否則,用戶端產生的構件會改寫服務。對於 JAX-WS Web 服務,伺服器和用戶端專案可以共用相同的 EAR。
    5. 監視 Web 服務:透過 TCP/IP 監視器傳送 Web 服務資料流量,讓您能夠監看 Web 服務所產生的 SOAP 資料流量,並測試此資料流量是否符合 WS-I 標準。另外,您也可以手動設定 TCP/IP 監視器,如使用 TCP/IP 監視器來測試 Web 服務所述。
  4. 「WebSphere JAX-WS Web 服務用戶端配置」頁面:
    • 輸出資料夾:選取資料夾供您在其中產生用戶端的 Java 類別,或接受預設值。
    • 目標套件:Web 服務用戶端精靈會從指定的 WSDL 產生一些 Java 檔。 依預設會根據 WSDL 檔中指定的名稱空間來建立套件名稱。如果要置換此預設行為,您可以在 WSDL 檔中指定自己的套件名稱作為名稱空間。
    • 產生可攜式用戶端:選取此勾選框可讓您將 Web 服務用戶端程式碼移至另一部機器或另一個 WebSphere Application Server 實例。 如果選取此選項,則會將 WSDL 文件及其依賴的所有 XML 綱目和其他 WSDL 文件,複製到用戶端專案的 WEB-INF/wsdl 下,然後將一個指向此副本的 file:relativeURL 注入 JAX-WS 服務類別的靜態起始設定區塊中。
    • 為產生的用戶端啟用非同步呼叫:如果選擇啟用非同步用戶端,則會對 Web 服務中的每一個方法再多建立兩個方法。 這些是輪詢和回呼方法,可讓用戶端以非同步方式運作。
    • 指定 JAX-WS 或 JAXB 連結檔:如果您已建立 JAX-WS 或 JAXB 自訂連結檔,請選取此勾選框,以利用它們建立此 Web 服務。
    • 自訂用戶端 Proxy 類別名稱:您可以接受預設的 Proxy 名稱,也可以輸入您自己的 Proxy 名稱。
    • 產生 Web 服務部署描述子:就 JAX-WS Web 服務而言,部署資訊是由執行時期動態產生;不再需要靜態部署描述子。選取此勾選框會產生它們。
    • 容許供應商延伸:如果您選取此勾選框,-extension 選項會新增至 wsgen 或 wsimport 指令。 -extension 選項指定是否對 JAX-WS 規格未指定的功能啟用或接受自訂延伸。 使用延伸會導致應用程式不可攜,或不能與其他實作交互操作。 如需詳細資料,請參閱 WebSphere Application Server 資訊中心的 JAX-WS 應用程式的 wsgen 指令及 JAX-WS 應用程式的 wsimport 指令主題。
  5. 「自訂連結宣告」頁面: 如果您在上一頁選取提供 JAX-WS 或 JAXB 連結檔,您可以瀏覽至它們所在的位置。
  6. 「Proxy 產生配置」頁面: 如果已選擇自訂用戶端 Proxy 類別名稱,請利用這個頁面來指定每一個埠的 Proxy 類別名稱。
  7. 「Web 服務用戶端測試」頁面:
    • 測試產生的 Proxy:如果選取此選項,Web 瀏覽器中會啟動範例用戶端,讓您測試功能。
    • 選取測試機能。您可以在「Web 服務瀏覽器」中測試產生的 Proxy,也可以產生範例 JAX-WS 2.0 JSP。
    • 資料夾:如果您選擇透過 JSP 測試 Proxy,您可以選取 JSP 所在的資料夾,也可以選取 JSP 中包含的方法。
    • 方法:選取要公開的方法。如果您選擇啟用非同步呼叫,則應該也會列出非同步方法。
    • 在伺服器執行測試:自動啟動伺服器。
  8. 按一下完成。如果您選擇測試 Proxy,瀏覽器視窗中會開啟測試用戶端。

結果

產生的 Java Bean Proxy 會提供 Web 服務的遠端程序呼叫介面。範例 Web 應用程式會示範如何編寫 Proxy 檔。

產生 Java 用戶端 Proxy 之後,您可以使用 Web 服務範例 JSP 或「Web 服務瀏覽器」,透過 Proxy 來測試 Web 服務的方法。

  • 如果您選擇使用「Web 服務瀏覽器」來測試 Web 服務,則會開啟瀏覽器。請選取您要測試的作業,輸入必要的資訊,然後按一下執行。結果會顯示在「狀態」窗格中。
  • 如果您選擇測試 Java 小型用戶端,則執行 Java 小型用戶端時的系統輸出會顯示在「主控台」視圖中。您可以在執行配置對話框按一下執行,以執行 Java 小型用戶端。作為一般 Java 應用程式,用戶端會使用對應的 WebSphere Application Server 小型用戶端執行時期儲存器 JAR。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tsampappjaxws.html