使用 Apache Axis 執行環境,從 Java Bean 建立 Web 服務

「Web 服務」精靈會協助您建立新的 Web 服務、 配置 Web 服務以供部署,以及將 Web 服務部署到伺服器。 部署好 Web 服務之後,精靈會協助您產生用戶端 Proxy 和範例應用程式來測試 Web 服務。完成測試之後, 您可以利用「匯出」精靈將 Web 服務發佈到 UDDI Business Registry。

必備條件:
  1. 建立或匯入 Bean 到 Web 專案的 Java™ 來源資料夾中。
如果要使用 Apache Axis 執行環境,從 Bean 建立 Web 服務,請執行下列動作:
  1. 切換至 J2EE 視景(視窗 > 開啟視景 > J2EE)。
  2. 在「專案瀏覽器」視圖中,選取您已建立或匯入 Web 專案之來源資料夾的 Bean。
  3. 按一下檔案 > 新建 > 其他 接著選取 Web 服務以便顯示各種 Web 服務精靈。選取 Web 服務精靈。按下一步
  4. 「Web 服務」頁面:選取由下而上 Java Bean Web 服務作為 Web 服務類型, 然後輸入要用來產生服務之 WSDL、WSIL 或 HTML 檔的 URI。
    1. 選取要使用滑塊完成之 Web 服務開發的階段:
      • 開發:這會建立服務程式碼
      • 組譯:
      • 部署:這會建立服務的部署程式碼
      • 安裝:這會在所選的伺服器上安裝服務
      • 啟動:這會在安裝服務之後啟動伺服器
      • 測試:這會提供用來測試服務的各種不同選項
    2. 選取伺服器:畫面上會顯示預設伺服器。如果您要將服務部署到另一部伺服器, 請按一下鏈結來指定另一部伺服器。
    3. 選取執行時期:畫面上會顯示預設執行時期。如果您要將服務部署到不同的執行時期, 請按一下鏈結來指定不同的執行時期。
    4. 選取服務專案:畫面上會顯示含有工作區中選定之專案的專案。如果要選取不同的專案和 EAR, 請按一下該專案的鏈結。 請確定選為用戶端 Web 專案的專案與服務 Web 專案不同,否則,用戶端產生的構件會改寫這個服務。
    5. 如果您要建立用戶端,請選取要產生之 Proxy 的類型, 然後對該用戶端重複上述步驟。
    6. 發佈 Web 服務:這會啟動「Web 服務瀏覽器」,將 Web 服務發佈到 UDDI 登錄。
    7. 監視 Web 服務:這會透過 TCP/IP 監視器傳送 Web 服務資料傳輸, 讓您能夠監看 Web 服務所產生的 SOAP 資料傳輸, 並測試這個資料傳輸是否符合 WS-I 標準。另外, 您也可以依照使用 TCP/IP 監視器來測試 Web 服務的說明,手動設定 TCP/IP 監視器。
  5. 「Web 服務 Java Bean 身分識別」頁面:列出 Web 服務 WSDL 名稱。 您可以選取下列選項:
    • 選取要顯現的方法。
    • 選取編碼樣式。RPC/Encoded 是建議用於 Axis 執行環境的編碼樣式。這個編碼方法不符合 WS-I 標準。
    • 選取您是否要自訂套件至名稱空間的對映。
    下一步
  6. 「Web 服務套件至名稱空間的對映」頁面:如果您在前一個畫面選取了定義套件至名稱空間的自訂對映, 您可以在這個畫面按一下新增,來輸入自訂對映配對。
  7. 「Web 服務測試」頁面:如果您選擇要測試 Web 服務, 請對產生的 Web 服務選取測試機能。 如此會在「Web 服務瀏覽器」中開啟 Web 服務。 請選取您要測試的作業,輸入必要的資訊,然後按一下執行。結果會顯示在「狀態」窗格中。按下一步
  8. 「Web 服務 Proxy」頁面:如果您選擇要產生 Proxy, 請選取是否要自訂套件至名稱空間的對映。
  9. 「Web 服務用戶端測試」頁面:請利用這個頁面來選取以下選項:
    1. 選取測試機能。您可以在「Web 服務瀏覽器」中測試產生的 Proxy, 也可以產生範例 Web 服務 JSP。
    2. 如果您選擇要透過 JSP 測試 Proxy,您可以選取 JSP 所在的資料夾, 也可以選取會併入 JSP 的方法。
    3. 選取在伺服器上執行測試來自動啟動伺服器。
  10. 「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 服務中的指示來完成這項作業。

重要事項:如果範例不支援您的方法所包含的類型(如:陣列、索引內容和集合), 範例會忽略這些方法,且您會收到警告訊息。