< 上一個課程 | 下一個課程 >

第 3 課:建立 Web 服務用戶端

在本課程中,您將學習如何為 Web 服務建立用戶端。

開始之前

在開始之前,您必須先完成第 2 課:建立 Web 服務。

關於這項作業

Web 服務用戶端可以根據 WSDL 文件來建立,此文件說明 Web 服務的部署位置,以及此服務所提供的作業。您可以使用 Web 服務精靈產生的靜態 WSDL 檔案,也可以在建立 JAX-WS Web 服務時,使用動態 WSDL 檔案,這個動態 WSDL 檔案是執行時期根據它從新增至 Java 類別的註釋所收集的資訊而產生的。就本指導教學來說,將使用動態 WSDL 檔案。

檢視動態產生的 WSDL

關於這項作業

如果您的伺服器已啟動,您應當能夠快速測試您所標註的 Bean,以確定它是 Web 服務,並產生動態 WSDL 檔案。

程序

  1. 判斷您 Web 服務所使用的埠(如果您還不知道的話)。作法如下:
    1. 啟動「WebSphere Application Server 管理主控台」,作法是在「伺服器」視圖中,用滑鼠右鍵按一下您的伺服器,並選取管理 > 執行管理主控台。
    2. 展開伺服器 > 伺服器類型,並選取 WebSphere 應用程式伺服器。
    3. 從清單中選取您的伺服器名稱。依預設,這是 server1。
    4. 在「配置」標籤中,搜尋「通訊」標題,並展開埠。
    5. 所用的埠是 WC_defaulthost。本指導教學將使用範例埠號 9081。 在任何下列步驟中,請以您自己的埠取代這個號碼。
  2. 按下列圖示來啟動 Web 瀏覽器:出現在主要工具列中的「Web 瀏覽器」圖示
  3. 在瀏覽器中輸入下列 URL:http://localhost:9081/jwsAddressBook/AddressBookService,然後按 Return 鍵。即會顯示頁面,指出這是 Web 服務。
  4. 將 ?wsdl 新增至步驟 3 中的 URL 尾端,並再次按 Return 鍵:http://localhost:9081/jwsAddressBook/AddressBookService?wsdl。這時會顯示動態產生的 WSDL 檔。只要伺服器正在執行,這個檔案的用法與 Web 服務精靈產生之靜態 WSDL 檔案的用法相同。

建立通訊錄 Web 服務用戶端,並測試 JSP

程序

  1. 按一下檔案 > 新建> 其他。選取 Web 服務,以顯示各種 Web 服務精靈。選取 Web 服務用戶端精靈。按下一步。
  2. 「Web 服務」頁面:在服務定義欄位中,輸入您在上一節所發現之動態產生 WSDL 檔案的 URL:http://localhost:9081/jwsAddressBook/AddressBookService?wsdl。
    1. 利用調節器來選取您想完成的 Web 服務用戶端開發階段。就本指導教學來說,請選取測試用戶端。這會產生所有必要的用戶端程式碼,以及提供用戶端的各種測試選項。
    2. 伺服器:確定已選取 WebSphere 7.0 版和更新版本的伺服器。
    3. Web 服務執行時期:確定已選取 JAX-WS 執行時期。
    4. 用戶端專案:選取您在第 1 課中建立的用戶端專案:jwsAddressBookClient。
    5. 用戶端 EAR 專案:選取 jwsAddressBookEAR。 對於 JAX-WS Web 服務,伺服器和用戶端專案可以共用相同的 EAR。
    6. 監視 Web 服務:這會透過 TCP/IP 監視器傳送 Web 服務資料流量,讓您能夠監看 Web 服務所產生的 SOAP 資料流量,並測試此資料流量是否符合 WS-I 標準。「TCP/IP 監視器」無法監視受 RSP 原則集保護的 Web 服務,因此請勿選取這個選項。
    按下一步。
  3. 「WebSphere JAX-WS Web 服務用戶端配置」頁面:
    • 輸出資料夾:接受將在其中產生用戶端 Java 類別的預設資料夾。
    • 目標套件:Web 服務用戶端精靈會從指定的 WSDL 產生一些 Java 檔。依預設會根據 WSDL 檔中指定的名稱空間來建立套件名稱。如果要置換這個預設行為,您可以在 WSDL 檔案中,指定自己的套件名稱來作為名稱空間。就本指導教學來說,請接受預設值。
    • 產生可攜式用戶端:選取這個勾選框,可讓您在各機器之間或各 WebSphere Application Server 實例之間,移動您的 Web 服務用戶端程式碼。本指導教學不需要此項。
    • 為產生的用戶端啟用非同步呼叫:如果選擇啟用非同步用戶端,則會對 Web 服務中的每一個方法再多建立兩個方法。這些是輪詢和回呼方法,可讓用戶端以非同步方式運作。請選取這個選項。
    • 指定 JAX-WS 或 JAXB 連結檔:如果您已建立 JAX-WS 或 JAXB 自訂連結檔,請選取這個勾選框,以利用它們來建立這項 Web 服務。在本指導教學中,請勿選取此項。
    • 自訂用戶端 Proxy 類別名稱:您可以接受預設的 Proxy 名稱,也可以輸入您自己的 Proxy 名稱。在本指導教學中,請勿選取此項。
    • 產生綱目程式庫:選取此項時,將會在 Java 編譯器中執行「JAX-WS 綱目」,以產生綱目。在本指導教學中,請勿選取這個選項。
    • 產生 Web 服務部署描述子:就 JAX-WS Web 服務而言,部署資訊是由執行時期動態產生;不再需要靜態部署描述子。選取這個勾選框將會產生部署描述子。本指導教學不需要部署描述子。
    • 要產生的 JAX-WS 程式碼版本:從 WebSphere Application Server 7.0 版起,您可以產生符合 JAX-WS 2.1 標準的程式碼。就本指導教學來說,請選取 2.1。
    按下一步。
  4. 「Web 服務用戶端測試」頁面:
    • 測試產生的 Proxy:請選取此項,來測試用戶端的功能。
    • 選取測試機能。您可以在「通用測試用戶端」或「Web 服務瀏覽器」中測試產生的 Proxy,也可以產生範例 JAX-WS 2.0 JSP。就本指導教學來說,請選取 JAX-WS JSP。
    • 資料夾:您可以選取用來放置 JSP 的資料夾。接受預設值。
    • 方法:選取要公開的方法。應當也會列出非同步方法。請確定已選取所有方法。
    • 在伺服器執行測試:這會自動啟動伺服器。
    按一下完成。範例 JSP 會在瀏覽器視窗中開啟。

使用範例 JSP 來測試 Web 服務用戶端

關於這項作業

下列步驟會同步測試 Web 服務。

程序

  1. 只要您選取的選項正確,TestClient.jsp 應會自動啟動。如果沒有顯示,請選取 jwsAddressBookClient/WebContent/sampleAddressBookPortProxy/TestClient.jsp,按一下滑鼠右鍵選取執行方式 > 在伺服器中執行
  2. 如果要同步測試這項服務,請選取 saveAddress 方法,並在名稱欄位中輸入資訊。所有其他欄位都是選用的。按一下呼叫。
  3. 選取 findAddress 方法,輸入 saveAddress 方法期間您使用的名稱,然後按一下呼叫。saveAddress 方法所儲存的資訊應該會顯示在結果窗格中。
  4. 如果要以非同步方式來測試服務,請在「服務品質」窗格中,選取啟用非同步呼叫勾選框。
  5. 選取 findAddress 方法,輸入 saveAddress 方法期間您使用的名稱,然後按一下呼叫。
  6. 這時會顯示新鏈結,指出該方法進行中。請按一下該鏈結,以便在「結果」窗格中顯示方法回應。

結果

測試好 Web 服務之後,請維持開啟 JSP,這樣一來,一旦 Web 服務和用戶端受到保護,您就可以再次測試服務。

課程回顧

< 上一個課程 | 下一個課程 >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: jaxwstd_exercise13.html