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

第 1 課:建立伺服器和 Web 專案

在本課程中,您將學習如何建立伺服器和 Web 專案,以搭配 Web 服務使用。

建立啟用 JAX-WS 的伺服器

關於這項作業

建立 Web 服務之前,您必須確定已定義和啟動 WebSphere® Application Server 8.0 版和更新版本的伺服器。依預設,在安裝 WebSphere Application Server 時,會為您建立一部伺服器。您可以在「伺服器」視圖中看到這部伺服器。不過,如果您想建立新的伺服器,請執行下列動作:

程序

  1. 從檔案功能表中,選取新建 > 其他 > 伺服器 > 伺服器 > 下一步。
  2. 選取 WebSphere Application Server 8.0 版,作為伺服器類型。按下一步。
  3. 如果您的工作區中尚未建立這個執行時期,系統會提示您選取伺服器的安裝目錄。按下一步。
  4. 接受預設伺服器埠和名稱。在這個指導教學中,所用的預設伺服器名稱是 server1。按一下完成。
  5. 等待伺服器啟動。在啟動之後,「主控台」視圖會顯示伺服器 server1 開啟以進行電子商業。如果伺服器未自動啟動,請在「伺服器」視圖中選取它,再按一下啟動圖示:伺服器啟動圖示。

建立 Web 服務的 Web 專案

關於這項作業

Web 服務精靈可為您建立 Web 服務的 Web 專案,並啟用資料類型,不過,在本指導教學中,您將手動建立專案。

程序

  1. 在 Java EE 視景中,用滑鼠右鍵按一下企業應用程式專案,並選取新建 > Web 專案,以開啟 Web 專案精靈。
  2. 在名稱欄位中,輸入新 Web 專案的名稱。就本指導教學來說,請使用 jwsAddressBook。
  3. 在「專案範本」區段中,選取您要使用的 Web 範本類型:就本指導教學來說,請選取 Simple。
    選項 敘述
    Dojo 工具箱 配置專案,使其具備 Dojo 功能。Dojo 資源可以位於專案本身中、個別專案中,或是可透過 HTTP 存取的遠端位置中。
    JavaServer Faces 讓專案可以使用 JSF 功能來部署。針對 JSP 或 Facelet 提供配置。
    REST 服務 針對以 JAX-RS 為基礎的「REST 服務」,所配置的專案
    簡式 這會建立基本 Web 專案。
  4. 在「程式設計模型」區段中,選取您要使用的程式設計模型:就本指導教學來說,請選取 Java EE。
    • 僅用戶端(HTML、JavaScript...)
    • Java EE
    • OSGi
  5. 按下一步,以配置新的 Web 專案。
  6. 在部署頁面上,從可用的配置選項清單中,按一下部署以開啟「部署配置」頁面。
    • 在目標執行時期欄位中,選取您在先前指導教學中所安裝的 WebSphere Application Server 第 7 版或第 8 版。
    • 在 Web 模組版本欄位中,接受預設值 (這會根據您選取的 WebSphere Application Server,自動為您選取)。
    • 在 EAR 成員資格欄位中,選取新增專案至 EAR,並確定 EAR 專案名稱是 jwsAddressBookEAR。
    • 在「部署」區段之下,選取變更特性。在「專案資料類型」頁面上,選取 JAX-RS(REST Web 服務)1.1 版,並按一下確定。
  7. 從可用的配置選項清單中,按一下 Java 以開啟 Java 配置頁面。
    • 在建置路徑上的來源資料夾欄位中,接受 src 預設目錄,或按一下新增資料夾、編輯... 或移除,為原始檔指定資料夾。
    • 在預設輸出資料夾:欄位中,指定輸出檔的資料夾,或是接受預設值 (WebContent\WEB-INF\classes)。
      重要: 如果您選擇的預設輸出資料夾不是 WebContent\WEB-INF\classes,問題視圖會報告警告:
      單一根警告
      依預設,會將單一根問題設為警告。如果要變更此設定,請使用「專案結構驗證器的驗證過濾器」頁面:
      1. 按一下視窗 > 喜好設定 > 驗證 > 專案結構驗證,然後針對設定,選取 ... 按鈕。
      2. 在「專案結構驗證器的驗證過濾器」頁面中,指定預設嚴重性層次。可用的嚴重性層次是錯誤、警告和忽略。
  8. 從可用的配置選項清單中,按一下 Web 模組。在「Web 模組配置」頁面上:
    • 在環境定義根目錄欄位中,輸入 Web 專案根目錄的名稱,或接受預設值(這是 Web 專案的名稱)。
    • 在內容目錄欄位中,輸入內容目錄的名稱,或接受預設值 (WebContent)。
    • 如果您想建立部署描述子,請選取產生 web.xml 部署描述子。您也可以稍後將部署描述子新增至 Web 模組。您需要使用 web.xml,來配置安全限制和其他行為。
  9. 按一下完成。

建立 Web 服務用戶端的 Web 專案

關於這項作業

Web 服務精靈可為您建立用戶端的 Web 專案,並啟用資料類型,不過,在本指導教學中,您將手動建立專案。

程序

  1. 在 Java EE 視景中,用滑鼠右鍵按一下企業應用程式專案,並選取新建 > Web 專案,以開啟 Web 專案精靈。
  2. 在名稱欄位中,輸入新 Web 專案的名稱。就本指導教學來說,請使用 jwsAddressBookClient。
  3. 在「專案範本」區段中,選取您要使用的 Web 範本類型:就本指導教學來說,請選取 Simple。
    選項 敘述
    Dojo 工具箱 配置專案,使其具備 Dojo 功能。Dojo 資源可以位於專案本身中、個別專案中,或是可透過 HTTP 存取的遠端位置中。
    JavaServer Faces 讓專案可以使用 JSF 功能來部署。針對 JSP 或 Facelet 提供配置。
    REST 服務 針對以 JAX-RS 為基礎的「REST 服務」,所配置的專案
    簡式 這會建立基本 Web 專案。
  4. 在「程式設計模型」區段中,選取您要使用的程式設計模型:就本指導教學來說,請選取 Java EE。
    • 僅用戶端(HTML、JavaScript...)
    • Java EE
    • OSGi
  5. 按下一步,以配置新的 Web 專案。
  6. 在部署頁面上,從可用的配置選項清單中,按一下部署以開啟「部署配置」頁面。
    • 在目標執行時期欄位中,選取您在先前指導教學中所安裝的 WebSphere Application Server 第 7 版或第 8 版。
    • 在 Web 模組版本欄位中,接受預設值 (這會根據您選取的 WebSphere Application Server,自動為您選取)。
    • 在 EAR 成員資格欄位中,選取新增專案至 EAR,並確定 EAR 專案名稱是 jwsAddressBookEAR。
    • 在「部署」區段之下,選取變更特性。在「專案資料類型」頁面上,選取 JAX-RS(REST Web 服務)1.1 版,並按一下確定。
  7. 從可用的配置選項清單中,按一下 Java 以開啟 Java 配置頁面。
    • 在建置路徑上的來源資料夾欄位中,接受 src 預設目錄,或按一下新增資料夾、編輯... 或移除,為原始檔指定資料夾。
    • 在預設輸出資料夾:欄位中,指定輸出檔的資料夾,或是接受預設值 (WebContent\WEB-INF\classes)。
      重要: 如果您選擇的預設輸出資料夾不是 WebContent\WEB-INF\classes,問題視圖會報告警告:
      單一根警告
      依預設,會將單一根問題設為警告。如果要變更此設定,請使用「專案結構驗證器的驗證過濾器」頁面:
      1. 按一下視窗 > 喜好設定 > 驗證 > 專案結構驗證,然後針對設定,選取 ... 按鈕。
      2. 在「專案結構驗證器的驗證過濾器」頁面中,指定預設嚴重性層次。可用的嚴重性層次是錯誤、警告和忽略。
  8. 從可用的配置選項清單中,按一下 Web 模組。在「Web 模組配置」頁面上:
    • 在環境定義根目錄欄位中,輸入 Web 專案根目錄的名稱,或接受預設值(這是 Web 專案的名稱)。
    • 在內容目錄欄位中,輸入內容目錄的名稱,或接受預設值 (WebContent)。
    • 如果您想建立部署描述子,請選取產生 web.xml 部署描述子。您也可以稍後將部署描述子新增至 Web 模組。您需要使用 web.xml,來配置安全限制和其他行為。
  9. 按一下完成。

下載通訊錄 WSDL 檔

關於這項作業

下載必要的 WSDL 檔。

課程回顧

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

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

File name: jaxwstd_exercise11.html