關於這項作業
JAX-RS Web 服務必須位於已啟用 JAX-RS 資料類型的專案中。
程序
- 在 Java EE
視景中,用滑鼠右鍵按一下企業應用程式專案,並選取,以開啟 Web 專案精靈。
- 在名稱欄位中,輸入新 Web 專案的名稱。就本指導教學來說,請使用 JAXRS。
- 在「專案範本」區段中,選取您要使用的 Web 範本類型:就本指導教學來說,請選取 Simple。
| 選項 |
敘述 |
| Dojo 工具箱 |
配置專案,使其具備 Dojo 功能。Dojo 資源可以位於專案本身中、個別專案中,或是可透過 HTTP 存取的遠端位置中。 |
| JavaServer Faces |
讓專案可以使用 JSF 功能來部署。針對 JSP 或 Facelet 提供配置。 |
| REST 服務 |
針對以 JAX-RS 為基礎的「REST 服務」,所配置的專案 |
| 簡式 |
這會建立基本 Web 專案。 |
- 在「程式設計模型」區段中,選取您要使用的程式設計模型:就本指導教學來說,請選取 Java EE。
- 僅用戶端(HTML、JavaScript...)
- Java EE
- OSGi
- 按下一步,以配置新的 Web 專案。
- 在部署頁面上,從可用的配置選項清單中,按一下部署以開啟「部署配置」頁面。
- 在目標執行時期欄位中,選取您先前在指導教學中所安裝的 WebSphere Application Server。
- 在 Web 模組版本欄位中,接受預設值,這會根據您選取的 WebSphere Application Server,自動為您選取。
- 在 EAR 成員資格欄位中,選取新增專案至 EAR,並確定 EAR 專案名稱是 JAXRSEAR。
- 在「部署」區段之下,選取變更特性。在「專案資料類型」頁面上,選取 JAX-RS(REST Web 服務)2.0 版,並按一下確定。
- 從可用的配置選項清單中,按一下 Java 以開啟 Java 配置頁面。
- 在建置路徑上的來源資料夾欄位中,接受 src 預設目錄,或按一下新增資料夾、編輯... 或移除,為原始檔指定資料夾。
- 在預設輸出資料夾:欄位中,指定輸出檔的資料夾,或是接受預設值 (WebContent\WEB-INF\classes)。
重要: 如果您選擇的預設輸出資料夾不是
WebContent\WEB-INF\classes,問題視圖會報告警告:
依預設,會將單一根問題設為警告。如果要變更此設定,請使用「
專案結構驗證器的驗證過濾器」頁面:
- 按一下,然後針對設定,選取 ... 按鈕。
- 在「專案結構驗證器的驗證過濾器」頁面中,指定預設嚴重性層次。可用的嚴重性層次是錯誤、警告和忽略。
- 從可用的配置選項清單中,按一下 REST 服務,開啟「REST 服務配置」頁面。在 JAX-RS 實作程式庫欄位中,選取 IBM WebSphere Application Server v<x> JAX-RS 程式庫。請確定會出現下列值:
- 在 JAX-RS Servlet 名稱:欄位中,確定會出現 JAX-RS Servlet。
- 在 JAX-RS Servlet 類別名稱:欄位中,確定會出現 com.ibm.websphere.jaxrs.server.IBMRestServlet。
- 在 URL 對映型樣:欄位中,確定會出現 /jaxrs/*。
進一步瞭解程式庫: 您所安裝的每一部 WebSphere Application Server 的 JAX-RS 程式庫,都會列在這個下拉方框中。如果您想要使用非 WebSphere 程式庫,可利用「使用者程式庫」喜好設定頁面來匯入該程式庫。如果選取「使用者程式庫」,則可以啟動「使用者程式庫」喜好設定頁面並新增程式庫。建立專案之後,您可以在 頁面中變更程式庫。
- 從可用的配置選項清單中,按一下 Web 模組。在「Web 模組配置」頁面上:
- 在環境定義根目錄欄位中,輸入 Web 專案根目錄的名稱,或接受預設值(這是 Web 專案的名稱)。
- 在內容目錄欄位中,輸入內容目錄的名稱,或接受預設值 (WebContent)。
- 如果您想建立部署描述子,請選取產生 web.xml 部署描述子。您也可以稍後將部署描述子新增至 Web 模組。您需要使用 web.xml,來配置安全限制和其他行為。
- 按一下完成。
結果
該資料類型會新增程式庫、Servlet 資訊,並支援 JAX-RS 註釋處理和 JAX-RS 快速修正程式。
現在,您已備妥開始進行下一個單元:建立和測試 Web 服務。