创建 JAX-RS Web Service
开始之前
- WebSphere® Application Server V7.0 或 V8.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 Service 的详细信息,请参阅:WebSphere Application Server 信息中心
创建支持 JAX-RS 的 Web 项目
关于此任务
[WebSphere Application Server 传统版] WebSphere Application Server V9 传统版支持 JAX-RS 1.1 和 2.0.项目中使用的 JAX-RS 的版本必须与 WebSphere Application Server V9 传统版的安装中使用的 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 Service
过程
- 在您的 Web 项目中,创建软件包(右键单击 ,然后选择)。将 Web Service 的类导入到软件包中。
- 打开 WebContent/WEB-INF/web.xml。在“设计”视图中,选择 Servlet JAX-RS Servlet,然后单击添加并将初始化参数添加到 JAX-RS servlet,将名称和值字段留空。保存 web.xml 并忽略可能显示的任何错误。
- 在“标记”视图中,选择有关参数名的 web.xml 错误,右键单击并选择“快速修复”。浏览至应用程序并选择。
- 将包含 JAX-RS 项目的 EAR 添加到服务器并启动服务器。
结果
要使 Web 应用程序能够成功部署,每个 Web 应用程序都必须具有上下文根。在应用程序组装或应用程序部署期间,将在应用程序部署描述符中为每个 Web 模块定义上下文根。上下文根与 WAR 文件中定义的 Servlet 映射共同组成用户访问该 Servlet 时需要输入的完整 URL。每个已部署 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 映射模式