Web 服務精靈可協助您建立新的 Web 服務、配置它以準備部署,然後將 Web 服務部署至伺服器。部署 Web 服務之後,精靈會協助您產生用戶端 Proxy 和範例應用程式來測試 Web 服務。
當您完成測試時,可以使用「匯出」精靈將 Web 服務發佈至「UDDI 商業登錄」。
開始之前
- 如果您使用 WebSphere® Application Server,強烈建議您在執行 Web 服務精靈之前先啟動伺服器,因為啟動 WebSphere Application Server 可能需要花費數分鐘,視電腦的速度而定。
如果要啟動伺服器,請在「伺服器」視圖中選取它(視窗 > 顯示視圖 > 伺服器),然後按一下滑鼠右鍵選取啟動。
- 在 Web 專案或 Java™ 專案的 Java 來源資料夾中,建立或匯入 Bean。
如果要匯入,請選取 Java 資源:src 資料夾,然後從「檔案」功能表中選取,並瀏覽至套件所在的位置。
關於這項作業
如果要使用 IBM® WebSphere JAX-WS 執行時期環境從 Bean 建立 Web 服務,請執行下列動作:
程序
- 切換至 Java EE 視景(視窗 > 開啟視景 > Java EE)。
- 在「企業瀏覽器」視圖中,選取您在 Web 專案的來源資料夾中建立或匯入的 Bean。
- 按一下檔案 > 新建 > 其他。選取 Web 服務,以顯示各種 web 服務精靈。選取 Web 服務精靈。按下一步。
- 在 Web 服務頁面中,選取由下而上 Java Bean Web 服務作為 Web 服務類型。您也可以選擇執行下列動作:
- 使用滑塊選取您要完成的 Web 服務開發階段。這會在剩餘的精靈畫面上設定數個預設值:
- 開發:這會開發 Web 服務的 WSDL 定義及實作。其中包括建立模組之類的作業,在適當情況下,模組將包含產生的程式碼、WSDL 檔、部署描述子及 Java 檔。
- 組合:這會確保當目標應用程式伺服器有需要時,負責管理 Web 服務或用戶端的專案會與 EAR 相關聯。
- 部署:這會建立服務的部署程式碼。
- 安裝:這會在目標伺服器上安裝及配置 Web 模組和 EAR。需要對 WSDL 檔的端點所做的任何變更都在此階段中完成。
- 啟動:這會在服務安裝於伺服器之後啟動伺服器。
- 測試:這會提供各種選項來測試服務,例如使用「通用服務用戶端」、「Web 服務瀏覽器」或範例 JSP。
- 選取伺服器執行時期:畫面上會顯示預設伺服器。如果您要將服務部署到不同的伺服器,請按一下伺服器鏈結並指定另一部伺服器。
此作業支援下列伺服器執行時期環境:
- WebSphere Application Server 7.0 版或更新版本
- WebSphere Application Server Liberty 8.5.5 版
- 選取 Web 服務執行時期:畫面上會顯示預設執行時期。如果要將服務部署到 IBM WebSphere JAX-WS 執行時期,請按一下執行時期鏈結,並在開啟的視窗中選取它。
- 選取服務專案和服務 EAR 專案:畫面上會顯示工作區中選取的專案。僅支援已啟用 Java 5.0、Java 6.0 或 Java 7.0 資料類型的 Web 專案。
如果要選取不同的專案和 EAR,請按一下專案鏈結或輸入名稱,讓精靈會為您建立專案。 請確定選為「用戶端 Web 專案」的專案與「服務 Web 專案」不同,否則,用戶端產生的構件會改寫服務。對於 JAX-WS Web 服務,伺服器和用戶端專案可以共用相同的 EAR。
- 如果您要建立用戶端,請選取要產生的 Proxy 類型,並對用戶端重複步驟 1 到 4。 稍後可以使用使用 IBM WebSphere JAX-WS 執行時期環境從 WSDL 文件產生 Web 服務用戶端中概述的步驟建立用戶端
- 監視 Web 服務:這會透過 TCP/IP 監視器傳送 Web 服務資料流量,讓您能夠監看 Web 服務所產生的 SOAP 資料流量,並測試此資料流量是否符合 WS-I 標準。另外,您也可以手動設定 TCP/IP 監視器,如使用 TCP/IP 監視器來測試 Web 服務所述。
- WebSphere JAX-WS 由下而上 Web 服務配置:
註: 如果 Bean 已有 @javax.jws.WebService 註釋,此頁面的大部分欄位會停用,因為精靈不需要為您產生委派 Bean。
您只能選擇產生 WSDL 檔。如果您只將 @javax.jws.WebService 新增至 Java Bean,但想要啟用其他選項,例如 SOAP 1.2 連結或 MTOM,您應該結束精靈並移除註釋,或繼續閱讀「使用註釋建立 Web 服務」說明文件。
此精靈不容許您對現存局部標註的 Bean 附加新的註釋。
- 「WebSphere JAX-WS WSDL 介面配置」頁面: 如果您在前一頁選擇產生 WSDL 檔,則會顯示此頁面讓您配置已產生的 WSDL 檔。您可以配置下列各項:
- WSDL 目標名稱空間
- WSDL 服務名稱
- WSDL 埠名稱
- 「測試 Web 服務」頁面:如果您選擇測試 Web 服務,請為產生的 Web 服務選取測試機能,然後按一下啟動。這會在「Web 服務瀏覽器」或「通用服務用戶端」中開啟 Web 服務。
請選取您要測試的作業,輸入必要的資訊,然後按一下執行。結果會顯示在「狀態」窗格中。按下一步。
- 「WebSphere JAX-WS Web 服務用戶端配置」頁面:如果您選擇產生用戶端,您可以在此頁面指定下列選項:
- 輸出資料夾:這是將產生用戶端程式碼的位置。
- 目標套件:Web 服務用戶端精靈會產生一些 Java 檔。
依預設會根據 WSDL 檔中指定的名稱空間來建立套件名稱。如果要置換此預設行為,您可以指定自己的套件名稱。
- 產生可攜式用戶端:選取這個勾選框,可讓您在各機器之間或各 WebSphere Application Server 實例之間,移動您的 Web 服務用戶端程式碼。
如果選取此選項,則會將 WSDL 文件及其依賴的所有 XML 綱目和其他 WSDL 文件,複製到用戶端專案的 WEB-INF/wsdl 下,然後將一個指向此副本的 file:relativeURL 注入 JAX-WS 服務類別的靜態起始設定區塊中。
- 為產生的用戶端啟用非同步呼叫:如果選擇啟用非同步用戶端,則會對 Web 服務中的每一個方法再多建立兩個方法。
這些是輪詢和回呼方法,可讓用戶端以非同步方式運作。
- 指定 JAX-WS 或 JAXB 連結檔:如果您已建立 JAX-WS 或 JAXB 自訂連結檔,請選取此勾選框,以利用它們建立 Web 服務用戶端。
如果選取此選項,精靈的下一頁可讓您瀏覽至自訂連結宣告檔。
- 自訂用戶端 Proxy 類別名稱:如果您要變更預設埠名稱至服務實作類別名稱的對映,請選取此勾選框
- 「自訂連結宣告」頁面:如果您選擇指定 JAX-WS 或 JAXB 連結檔,您可以在此頁面瀏覽至檔案。
- 「Proxy 產生配置」頁面:對於每一個定義的埠,您可以輸入 Proxy 類別的名稱,或接受預設值。
- 「Web 服務用戶端測試」頁面:
- 測試產生的 Proxy:如果選取此選項,Web 瀏覽器中會啟動範例用戶端,讓您測試功能。
- 選取測試機能。您可以在「通用服務用戶端」或「Web 服務瀏覽器」中測試產生的 Proxy,也可以產生並使用範例 JAX-WS 2.0 JSP。
- 資料夾:如果您選擇透過 JSP 測試 Proxy,您可以選取 JSP 所在的資料夾,也可以選取 JSP 中包含的方法。
- 方法:選取要公開的方法。如果您選擇啟用非同步呼叫,則應該也會列出非同步方法。
- 在伺服器執行測試:這會自動啟動伺服器。
結果
建立 Web 服務之後,視您選取的選項而定,可能會有下列情形:
- 如果您選擇使用 Web 服務 JSP 來測試產生的 Proxy,Web 瀏覽器中會在下列 URL 啟動 Proxy:http://localhost:port/WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp
您可以使用此範例應用程式選取方法、輸入方法的值,然後按一下呼叫,以測試 Web 服務。
方法的結果會顯示在「結果」窗格中。
- 如果您選擇使用「通用測試用戶端」來測試產生的 Proxy,瀏覽器視窗中會使用與下列相似的 URL 啟動它:http://localhost:port/UTC/preload?object=BeanPackage.BeanServiceProxy。
在「物件」下,展開 Proxy stub 來顯示 Web 服務的方法。按一下您要測試的方法,在「參數」窗格中輸入值,然後按一下呼叫。將會自動產生結果。
- 如果您選擇使用「Web 服務瀏覽器」來測試 Web 服務,則會開啟瀏覽器。請選取您要測試的作業,輸入必要的資訊,然後按一下執行。結果會顯示在「狀態」窗格中。
限制: 從相依於不同 JAR 檔中包含的其他類別的類別檔來產生 JAX-WS Web 服務時,專案需要從「Java EE 模組相依關係」或從「使用者程式庫」中參照這些外部 JAR 檔。
當 JAR 包含在 EAR 專案中時,您能夠使用 Java EE 模組相依關係。
如果 JAR 是 WebSphere Application Server 上配置的「共用程式庫」的一部分,則產生 Web 服務之前,必須使用「使用者程式庫」來配置要開發的專案。
如果要將使用者程式庫新增至專案,請執行下列動作:
- 用滑鼠右鍵按一下專案,然後按一下
- 按一下
- 建立使用者程式庫,並於其中新增公用程式 JAR。