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

第 2 課:建立 Web 服務

在本課程中,您將學習如何從您在前一課中匯入的 WSDL 檔案,建立由上而下 Java™ 通訊錄 Web 服務。

開始之前

在開始之前,您必須先完成第 1 課:建立伺服器和 Web 專案。

關於這項作業

程序

  1. 切換至 Java EE 視景:視窗 > 開啟視景 > 其他 > Java EE。
  2. 在「企業瀏覽器」視圖中,選取您在前一課中匯入的 WSDL 檔案。
  3. 用滑鼠右鍵按一下 WSDL,並選取 Web 服務 > 產生 Java Bean 架構。
  4. 「Web 服務」頁面:選取由上而下 Java Bean Web 服務,作為 Web 服務類型,並確定已設定 AddressBook.wsdl 作為服務定義。選擇下列選項:
    1. 使用滑塊選取您要完成的 Web 服務開發階段。滑塊會設定剩餘精靈頁面上的預設值,但您可以在進行時置換每一個頁面上的預設值。就本指導教學來說,請選取啟動服務。這會建立 Web 服務所有必要的程式碼,將它部署到伺服器,並嘗試啟動伺服器。
    2. 選取伺服器:按一下伺服器鏈結,並確定已選取 WebSphere® 第 8 版伺服器。
    3. 選取執行時期:請確定已選取 IBM® JAX-WS 執行時期。
    4. 選取服務專案:選取您在前一課中建立的 jwsAddressBook 專案。
    5. 選取服務 EAR 專案:選取您在前一課中建立的 jwsAddressBookEAR。
    6. 稍後會建立用戶端,因此,請確定用戶端調節器設為無用戶端。
    按下一步。
  5. WebSphere JAX-WS 由上而下 Web 服務配置頁面:
    • 輸出資料夾:接受預設位置,以便在其中產生 Java 架構:jwsAddressBook/src。
    • 目標套件:接受預設套件名稱
    • 啟用封套樣式:啟用從 WSDL 至 Java 的封套樣式對映。對於實作 document/literal 封套型樣的 WSDL 文件,在 XML 綱目中會宣告一個根元素,並利用它來作為訊息流程的作業封套。要求和回應都有各自的封套元素定義。接受預設值。
    • 啟用 MTOM 支援:如果您選取此勾選框,則會啟用「SOAP 訊息傳輸最佳化機制」,將二進位內容的傳輸最佳化。接受預設值。
    • 要產生的 JAX-WS 程式碼版本:從 WebSphere Application Server 8.0 版起,您可以產生符合 JAX-WS 2.1 標準的程式碼。就本指導教學來說,請選取 2.1。
    • 將 WSDL 複製至專案:選取此項時,會將 WSDL 檔複製到服務專案中。由於您稍後將會建立用戶端,請選取這個勾選框。
    • 產生可序列化 JAXB 類別:在 WebSphere Application Server 7.0 版和更新版本中,當您啟用 Java 6 資料類型,您可以選擇產生會實作 java.io.Serializable 的 JAXB 類別。未實作此介面的類別不會將其任何狀態序列化或解除序列化。在本指導教學中,請勿選取此項。
    • 指定 JAX-WS 或 JAXB 連結檔:這可讓您使用 JAX-WS 或 JAXB 自訂連結檔。在本指導教學中,請勿選取此項。
    • 自訂服務實作類別名稱:這可讓您變更預設埠名稱至服務實作類別名稱的對映。在本指導教學中,請勿選取此項。
    • 產生綱目程式庫:選取此項時,將會在 Java 編譯器中執行「JAX-WS 綱目」,以產生綱目。在本指導教學中,請勿選取這個選項。
    • 產生 Web 服務部署描述子:就 JAX-WS Web 服務而言,部署資訊是由執行時期動態產生;不再需要靜態部署描述子。如果選取這個勾選框,就會產生它們。本指導教學不需要部署描述子。
    按下一步。

結果

產生了 Web 服務的所有必要程式碼

將商業邏輯新增至架構 Bean

關於這項作業

Web 服務精靈產生的架構實作 Bean AddressBookPortImpl.java 不包含任何商業邏輯。它含有 @javax.jws.WebService 註釋,以告知執行時期,它是一項 JAX-WS Web 服務。

為了使通訊錄 Web 服務如預期般運作,您需要在這個 Bean 中新增程式碼。在產生 Web 服務之後,它應會在編輯器中自動開啟,如果沒有開啟,則可在下列找到:jwsAddressBook/Java Resources/src/com.addressbook。

程序

  1. 取代現行 saveAddress 方法:
        public boolean saveAddress(PersonType person) {
            return false;
        }
    換成下列的 static 欄位和方法:
    	private static Hashtable<String,AddressType> addresses = new Hashtable<String,AddressType>();
        public boolean saveAddress(PersonType person) {
        	addresses.put(person.getName(),person.getAddress());
            return true;
        }
  2. 取代現行 findAddress 方法:
        public AddressType findAddress(String name) throws FindAddressFault {
            return null;
        }
    換成下列:
        public AddressType findAddress(String name) throws FindAddressFault {
            return addresses.get(name);
        }
  3. 可能顯示若干錯誤標記。如果要更正這些,請按一下 Ctrl+Shift+o,組織您的匯入項目。選取要匯入 java.util.Hashtable。完成之後,錯誤應會變成灰色。
  4. 儲存已更新的實作 Bean。

使用「通用服務用戶端」來測試 Web 服務

關於這項作業

「通用服務用戶端」可讓您直接測試 Web 服務,而不需建置用戶端。您可以選取要測試的作業,輸入必要的資訊,結果會顯示在「狀態」窗格中。

程序

  1. 選取產生的 WSDL 檔案 jwsAddressBook/WebContent/WEB-INF/wsdl/AddressBook.wsdl,按一下滑鼠右鍵選取 Web 服務 > 使用「通用服務用戶端」來測試。 或者,您可以在「服務」視圖中,在專案的「服務」節點或 JAX-WS Web 服務節點之下,選取該服務,然後從該處啟動「通用服務用戶端」。
  2. 選取 SaveAddress 作業。
  3. 在每一個欄位中輸入值,並按一下呼叫。
  4. 選取 FindAddress 作業。
  5. 輸入您在呼叫 saveAddress 作業時所選擇的名稱,並按一下呼叫。
  6. 使用這個名稱所儲存的資訊會顯示在「狀態」窗格中。

課程回顧

現在,您已備妥開始進行第 3 課:建立 Web 服務用戶端。

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

File name: jaxwstd_exercise12.html