JAX-RS Web Service 需要存在于已启用 JAX-RS 构面的项目中。
- 在 Java EE 透视图中,右键单击企业应用程序项目并选择以打开“Web 项目”向导。
- 在名称字段中,为新的 Web 项目输入名称。 对于本教程,请使用 JAXRS。
- 在“项目模板”部分中,选择您想使用的 Web 模板的类型: 对于本教程,请选择 Simple。
选项 |
描述 |
Dojo Toolkit |
将项目配置为具有 Dojo 功能。Dojo 资源可以位于该项目、单独的项目或可以通过 HTTP 访问的远程位置中。 |
JSF |
允许通过 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 Service) V1.1,然后单击确定。
- 从可用的配置选项列表中,单击 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 来配置安全性约束和其他行为。
- 单击完成。