使用 IBM SOAP 執行時期環境從 WSDL 文件產生 Java 用戶端 Proxy 和範例應用程式

「Web 服務用戶端」精靈可協助您產生 Java™ Bean Proxy 和範例應用程式。範例應用程式示範如何撰寫 Proxy 檔的編碼。

必備條件:
  1. 如果您是使用 WebSphere 伺服器, 請建立目標為適當伺服器的動態 Web 專案(如建立 WebSphere 伺服器和 Web 專案所述)。
  2. 尋找及匯入 WSDL 文件至 Web 專案中。您只能使用含有 service 元素的 WSDL 檔。

從找到的 WSDL 文件產生 Java 用戶端 Proxy 和範例應用程式。

  1. 切換至 J2EE 視景(視窗 > 開啟視景 > J2EE)。
  2. 在「專案瀏覽器」視圖中,選取要在其中產生範例應用程式的 Web 專案。
  3. 按一下檔案 > 新建 > 其他。接著選取 Web 服務以便顯示各種 Web 服務精靈。選取 Web 服務用戶端精靈。按下一步
  4. 「Web 服務」畫面:選取要產生的 Proxy 類型以及是否要測試它。
  5. 「用戶端環境配置」頁面:選取 Web 服務用戶端的執行時期環境和伺服器。
    1. 按一下探索選項,選取 IBM® SOAP 執行時期環境,再選取要在其中執行 Web 服務用戶端的伺服器。 如果您要使用 Apache Axis 1.0 執行時期環境或 IBM WebSphere 執行時期環境,請參考適當的作業。
    2. 選取要在其中建立 Web 服務用戶端之專案的類型和名稱。
      • 如果您輸入現有專案的名稱,專案類型欄位必須符合現有專案的類型。 請確定選為用戶端 Web 專案的專案與服務 Web 專案不同,否則,用戶端產生的成品會改寫這個服務。
      • 如果您輸入名稱的專案不存在,精靈會自動建立這個專案。
      • 請注意,只有 Web 專案是支援的 Axis 和 SOAP 執行時期用戶端專案類型。 如果您要在 Java、EJB 或應用程式用戶端專案中建立用戶端,您必須選取用戶端的 WebSphere 執行時期環境。
    3. 選取現有的 EAR 或輸入唯一名稱,將 Web 服務用戶端關聯於 Web 服務 EAR 以外的 EAR。附註:在 Web 服務和 Web 服務用戶端上選取不同的 EAR,可以減少發生執行時期錯誤的機會,但會使用比較多的系統資源。
  6. 「選取 Web 服務」畫面:輸入用來產生 Java Bean 的 WSDL、WSIL 或 HTML 檔的 URI。您也可以選擇性地從這個檔案產生 WSIL 檔。
  7. 「產生 Web 服務連結 Proxy」畫面:請選取連結和 Proxy 選項。
  8. 「Web 服務 Proxy 測試」畫面:選取要用來測試 Proxy 的測試機能,以及 Proxy 中所要併入的方法。附註:Universal Test Client (UTC) 只與部署在 WebSphere 伺服器上的 Web 服務用戶端相容。按一下完成

附註:

重要事項:建議您選取服務 WSDL 文件,不要選取連結 WSDL 文件,以便產生包含完整端點資訊的用戶端 Proxy。service 元素是您將發佈之「商業服務」的基礎。您不能利用沒有 service 元素的 WSDL 文件來發佈「商業服務」。如果您從 WSDL 連結文件產生 Proxy,您必須先呼叫 setEndPoint() 方法來設定端點 URL,之後,才能呼叫 Proxy 中的任何其他方法。從 WSDL 連結文件產生的 Proxy 不會自動配備端點 URL。

所產生的 Java Bean Proxy 會提供一個遠端程序呼叫介面到 Web 服務。樣本 Web 應用程式會示範如何撰寫 Proxy 檔程式碼。

產生好 Java 用戶端 Proxy 之後,您就可以透過使用 Web 服務範例 JSP 或 Universal Test Client 的 Proxy 來測試 Web 服務的方法。

如果需要建立 Web 專案的詳細資訊,請參閱 Web 應用程式開發文件。

使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.