建立 JAX-RS Web 服務
開始之前
- WebSphere® Application Server 7.0 版或 8.0 版,選取以安裝 Feature Pack for Web 2.0 AND MOBILE 及 WebSphere Application Server 開發工具
如果選擇部署至 WebSphere Application Server 之外的伺服器,則無法使用 IBM® JAX-RS 程式庫,必須透過「專案資料類型 > JAX-RS」喜好設定頁面,安裝並配置您自己的 JAX-RS 程式庫。
如需在 WebSphere Application Server 上使用 JAX-RS Web 服務的詳細資訊,請參閱:WebSphere Application Server 資訊中心
建立啟用 JAX-RS 的 Web 專案
關於這項作業
[WebSphere Application Server 傳統版] WebSphere Application Server 傳統版第 9 版支援 JAX-RS 1.1 和 2.0。您在專案中使用的 JAX-RS 版本, 必須符合您在 WebSphere Application Server 傳統版第 9 版安裝架構中使用的 JAX-RS 版本。如果這些版本不符合, 在您將專案部署到伺服器時,工具會顯示警告。如果您建立 JAX-RS 專案時,沒有指定資料類型層次, 依預設,工具會使用 JAX-RS 2.0。
com.ibm.ws.jaxrs.jar
com.ibm.ws.prereq.jaxrs.jar
javax.j2ee.jaxrs.jar
com.ibm.ws.jaxrs20.jar
com.ibm.ws.prereq.jaxrs20.jar
javax.ws.rs-api-2.0.jar
程序
建立 JAX-RS Web 服務
程序
- 在 Web 專案中,建立套件(用滑鼠右鍵按一下 ,然後選取)。將 Web 服務的類別匯入套件中。
- 開啟 WebContent/WEB-INF/web.xml。在「設計」視圖中,選取 Servlet JAX-RS Servlet,然後按一下新增,並將「起始設定」參數新增至 JAX-RS Servlet,名稱及值欄位則保留空白。儲存 web.xml,並忽略可能顯示的任何錯誤。
- 在「標記」視圖中,選取關於 param-name 的 web.xml 錯誤,按一下滑鼠右鍵選取「快速修正程式」。瀏覽至應用程式並選取。
- 將包含 JAX-RS 專案的 EAR 新增至伺服器,然後啟動伺服器。
結果
每個 Web 應用程式都必須有環境定義根目錄,才能成功部署 Web 應用程式。在應用程式組合或應用程式部署期間,應用程式部署描述子中會定義每一個 Web 模組的環境定義根目錄。環境定義根目錄會結合 WAR 檔中已定義的 Servlet 對映,編寫完整的 URL,供使用者輸入以存取 Servlet。 每一個已部署的 Web 應用程式的環境定義根目錄在伺服器上都必須是唯一的。環境定義根目錄也可以是空的。
比方說,如果 Web 應用程式使用 sample/application/ 作為環境定義根目錄,則 Web 應用程式要求 URL 的開頭為 http://<hostname>:<port>/sample/application/。Servlet 的 URL 型樣會附加到 Web 應用程式的環境定義根目錄之後。比方說,如果環境定義根目錄是 sample/application/,且 Servlet URL 對映是 rest/api/*,則 JAX-RS Web 應用程式的基本 URI 是 http://<hostname>:<port>/sample/application/rest/api。
編輯 JAX-RS 專案
- 程式庫類型
- JAX-RS Servlet 名稱
- JAX-RS Servlet 類別名稱
- URL 對映型樣