「Web 服務」精靈會協助您建立新的 Web 服務、
配置 Web 服務以供部署,以及將 Web 服務部署到伺服器。
部署好 Web 服務之後,精靈會協助您產生用戶端 Proxy 和範例應用程式來測試 Web 服務。完成測試之後,
您可以利用「匯出」精靈將 Web 服務發佈到 UDDI Business Registry。
必備條件:
- 如果您要使用 Apache Jakarta Tomcat Servlet 儲存檔案作為伺服器,
您必須依照建立 Apache Tomcat 伺服器和 Web 專案的說明,
安裝此儲存檔案、配置其實例,然後建立一個 Web 專案以其作為目標。
- 建立或匯入 Bean 到 Web 專案的 Java™ 來源資料夾中。
如果要使用 Apache Axis 執行環境,從 Bean 建立 Web 服務,請執行下列動作:
- 切換至 J2EE 視景(視窗 > 開啟視景
> J2EE)。
- 在「專案瀏覽器」視圖中,選取您已建立或匯入 Web 專案之來源資料夾的 Bean。
- 按一下檔案 > 新建 > 其他。 接著選取 Web 服務以便顯示各種 Web 服務精靈。選取 Web 服務精靈。按下一步。
- 「Web 服務」頁面:選取由下而上 Java Bean Web 服務作為 Web 服務類型,
然後輸入要用來產生服務之 WSDL、WSIL 或 HTML 檔的 URI。
- 選取要使用滑塊完成之 Web 服務開發的階段:
- 開發:這會建立服務程式碼
- 組譯:
- 部署:這會建立服務的部署程式碼
- 安裝:這會在所選的伺服器上安裝服務
- 啟動:這會在安裝服務之後啟動伺服器
- 測試:這會提供用來測試服務的各種不同選項
- 選取伺服器:畫面上會顯示預設伺服器。如果您要將服務部署到另一部伺服器,
請按一下鏈結來指定另一部伺服器。
- 選取執行時期:畫面上會顯示預設執行時期。如果您要將服務部署到不同的執行時期,
請按一下鏈結來指定不同的執行時期。
- 選取服務專案:畫面上會顯示含有工作區中選定之專案的專案。如果要選取不同的專案和 EAR,
請按一下該專案的鏈結。 請確定選為用戶端 Web 專案的專案與服務 Web 專案不同,否則,用戶端產生的構件會改寫這個服務。
- 如果您要建立用戶端,請選取要產生之 Proxy 的類型,
然後對該用戶端重複上述步驟。
- 發佈 Web 服務:這會啟動「Web 服務瀏覽器」,將 Web 服務發佈到 UDDI 登錄。
- 監視 Web 服務:這會透過 TCP/IP 監視器傳送 Web 服務資料傳輸,
讓您能夠監看 Web 服務所產生的 SOAP 資料傳輸,
並測試這個資料傳輸是否符合 WS-I 標準。另外,
您也可以依照使用 TCP/IP 監視器來測試 Web 服務的說明,手動設定 TCP/IP 監視器。
- 「Web 服務 Java Bean 身分識別」頁面:列出 Web 服務 WSDL 名稱。 您可以選取下列選項:
- 選取要顯現的方法。
- 選取編碼樣式。RPC/Encoded 是建議用於 Axis 執行環境的編碼樣式。這個編碼方法不符合 WS-I 標準。
- 選取您是否要自訂套件至名稱空間的對映。
按下一步
- 「Web 服務套件至名稱空間的對映」頁面:如果您在前一個畫面選取了定義套件至名稱空間的自訂對映,
您可以在這個畫面按一下新增,來輸入自訂對映配對。
- 「Web 服務測試」頁面:如果您選擇要測試 Web 服務,
請對產生的 Web 服務選取測試機能。 如此會在「Web 服務瀏覽器」中開啟 Web 服務。 請選取您要測試的作業,輸入必要的資訊,然後按一下執行。結果會顯示在「狀態」窗格中。按下一步。
- 「Web 服務 Proxy」頁面:如果您選擇要產生 Proxy,
請選取是否要自訂套件至名稱空間的對映。
- 「Web 服務用戶端測試」頁面:請利用這個頁面來選取以下選項:
- 選取測試機能。您可以在「Web 服務瀏覽器」中測試產生的 Proxy,
也可以產生範例 Web 服務 JSP。
- 如果您選擇要透過 JSP 測試 Proxy,您可以選取 JSP 所在的資料夾,
也可以選取會併入 JSP 的方法。
- 選取在伺服器上執行測試來自動啟動伺服器。
- 「Web 服務發佈」頁面:選取是否要將這個 Web 服務發佈到 UDDI 登錄。按一下完成。 附註:您能會看到一則警告,指出從 Java 產生 WSDL 時發生錯誤。ClassNotFound:<Bean 名稱>。這個錯誤可以完全忽略。
建立 Web 服務之後,
根據您所選的選項,可能會發生下列狀況:
- 如果您選擇要使用 Web 服務 JSP 來測試產生的 Proxy,
則 Web 瀏覽器會以下列 URL 啟動 Proxy:
http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp。
您可以選取一個方法、輸入方法的值,然後按一下呼叫,
利用這個範例應用程式來測試 Web 服務。方法的結果會顯示在結果窗格中。
- 如果您選擇要利用「Web 服務瀏覽器」來測試 Web 服務,
則會開啟「瀏覽器」。請選取您要測試的作業,輸入必要的資訊,然後按一下執行。結果會顯示在「狀態」窗格中。
- 如果您選擇要發佈 Web 服務,則會啟動「Web 服務瀏覽器」,並顯示發佈 Web 服務所需的頁面。請遵循發佈 Web 服務中的指示來完成這項作業。
重要事項:如果範例不支援您的方法所包含的類型(如:陣列、索引內容和集合),
範例會忽略這些方法,且您會收到警告訊息。