「Web 服務用戶端」精靈可協助您產生 Java™ Bean Proxy 和範例應用程式。範例 Web 應用程式示範如何編寫 Proxy 檔。
必備條件:
- 如果您是使用 Apache Jakarta Tomcat Servlet 儲存器做為伺服器,
您必須安裝它、配置其實例,然後建立以它為目標的 Web 專案(如建立 Apache Tomcat 伺服器和 Web 專案所述)。
- 如果您是使用 WebSphere® 伺服器,
請建立目標為適當伺服器的動態 Web 專案(如建立 WebSphere 伺服器和 Web 專案所述)。強力建議您先啟動伺服器,再執行 Web 服務精靈,因為可能需要好幾分鐘才會啟動 WebSphere Application Server(視電腦速度而定)。如果要啟動伺服器,請在「伺服器」視圖中選取它(視窗 > 顯示視圖 > 伺服器),按一下滑鼠右鍵,然後按一下啟動。
- 探索和匯入 WSDL 文件至 Web 專案中。您只能使用含有 service 元素的 WSDL 檔。
從找到的 WSDL 文件產生 Java 用戶端 Proxy 和範例應用程式。
- 切換至 J2EE 視景(視窗 > 開啟視景 > J2EE)。
- 在「導覽器」視圖中,選取要在其中產生範例應用程式的 Web 專案。
- 按一下檔案 > 新建 > 其他。接著選取 Web 服務以便顯示各種 Web 服務精靈。選取 Web
服務用戶端精靈。按下一步。
- 「Web 服務」頁面:選取要產生的 Proxy 類型以及是否要測試它。
- 「用戶端環境配置」頁面:選取 Web 服務用戶端的執行時期環境和伺服器。
- 按一下探索選項,選取 Apache Axis 1.0 執行時期環境,再選取要在其中執行 Web 服務用戶端的伺服器。 如果您要使用 IBM® SOAP 執行時期環境或 IBM WebSphere 執行時期環境,請參考適當的作業。
- 選取要在其中建立 Web 服務用戶端之專案的類型和名稱。
- 如果您輸入現有專案的名稱,專案類型欄位必須符合現有專案的類型。
請確定選為用戶端 Web 專案的專案與服務 Web 專案不同,否則,用戶端產生的成品會改寫這個服務。
- 如果您輸入名稱的專案不存在,精靈會自動建立這個專案。
- 請注意,只有 Web 專案是支援的 Axis 和 SOAP 執行時期用戶端專案類型。
如果您要在 Java、EJB 或應用程式用戶端專案中建立用戶端,您必須選取用戶端的 WebSphere 執行時期環境。
- 「選取 Web 服務」頁面:輸入用來產生用戶端的 WSDL、WSIL 或 HTML 檔的 URI。您也可以選擇性地從這個檔案產生 WSIL 檔。
- 「Web 服務 Proxy」頁面:這個畫面會顯示 Proxy 的選項。它會列出要產生 Proxy 的資料夾,您可以選擇性地建立名稱空間和套件之間的自訂對映。
- 「Web 服務名稱空間至套件對映」頁面:如果您已在上一頁中選取定義名稱空間至套件的自訂對映,您可以按一下新增,在這個頁面中輸入您的自訂對映配對。
- 「Web 服務用戶端測試」頁面:選取要用來測試 Proxy 的測試機能,以及 Proxy 中所要併入的方法。附註:Universal Test Client (UTC) 只與部署在 WebSphere 伺服器上的 Web 服務用戶端相容。
- 按一下完成。如果您已選擇要測試 Proxy,就會在瀏覽器視窗中開啟測試用戶端。
所產生的 Java Bean Proxy 會提供一個遠端程序呼叫介面到 Web 服務。樣本 Web 應用程式會示範如何撰寫 Proxy 檔程式碼。
產生好 Java 用戶端 Proxy 之後,您就可以透過使用 Web 服務範例 JSP 或 Universal Test Client 的 Proxy 來測試 Web 服務的方法。
- 如果您選擇利用 Web 服務 JSP 來測試產生的 Proxy,
該 Proxy 就會於 Web 瀏覽器中的下列 URL 啟動:http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp。您可以選取一個方法、輸入方法的值,
然後按一下呼叫,來利用這個範例應用程式測試 Web 服務。方法的結果會顯示在結果窗格中。
- 如果您選擇利用 Universal Test Client 來測試產生的 Proxy,它將在瀏覽器視窗的下列 URL 啟動:http://localhost:9080/UTC/preload?object= BeanPackage. BeanServiceProxy。
請在「參照」窗格的「物件參照」下,展開 Proxy Stub 來顯示 Web 服務的方法。按一下您要測試的方法,在「參數」窗格中輸入值,再按一下呼叫。下面會產生結果。
- 如果您選擇要利用「Web 服務瀏覽器」測試 Web 服務,這時會開啟「瀏覽器」。請選取您要測試的作業,輸入必要的資訊,再按一下執行。結果會顯示在「狀態」窗格中。
如果需要建立 Web 專案的詳細資訊,請參閱 Web 應用程式開發文件。