< 上一课 | 下一课 >

课程 1:创建服务器和 Web 项目

Web Service 需要存在于已启用 JAX-RS 构面的 Web 项目中。

创建已启用 JAX-RS 的服务器

在创建 Web Service 之前,需要具有已定义并启动 Java 5.0 或更高版本 JVM 支持的服务器。缺省情况下,当您安装 WebSphere Application Server 时就为您创建了服务器。在“服务器”视图中可以看到此服务器。但是,如果要创建新的 WebSphere Application Server,请执行下列操作:
  1. 文件菜单中,选择新建 > 其他 > 服务器 > 服务器 > 下一步
  2. 选择相应版本的 WebSphere Application Server 作为服务器类型。单击下一步
  3. 如果您的工作空间中尚未创建此运行时,则将提示您为服务器选择安装目录。单击下一步
  4. 接受缺省服务器端口和名称。对于本教程,所使用的缺省服务器名称将是 server1。单击完成
  5. 等待服务器启动。服务器启动之后,“控制台”视图将显示已启动服务器 server1 以实现电子商务。如果服务器未自动启动,请在“服务器”视图中选择该服务器,然后单击启动图标:“服务器启动”图标

创建支持 JAX-RS 的 Web 项目

JAX-RS Web Service 需要存在于已启用 JAX-RS 构面的项目中。
  1. 在 Java EE 透视图中,右键单击企业应用程序项目并选择新建 > Web 项目以打开“Web 项目”向导。
  2. 名称字段中,为新的 Web 项目输入名称。 对于本教程,请使用 JAXRS
  3. 在“项目模板”部分中,选择您想使用的 Web 模板的类型: 对于本教程,请选择 Simple
    选项 描述
    Dojo Toolkit 将项目配置为具有 Dojo 功能。Dojo 资源可以位于该项目、单独的项目或可以通过 HTTP 访问的远程位置中。
    JSF 允许通过 JSF 功能部署项目。 为 JSP 或 Facelet 提供配置。
    REST 服务 基于 JAX-RS 为 REST 服务配置的项目
    简单 这可以创建基本的 Web 项目。
  4. 在“编程模型”部分中,选择要使用的编程模型: 对于本教程,请选择 Java EE
    • 仅客户端(HTML 和 JavaScript...)
    • Java EE
    • OSGi
  5. 单击下一步配置新的 Web 项目。
  6. 在“部署”页面上,从可用的配置选项列表中,单击部署打开“部署配置”页面。
    • 目标运行时字段中,选择您在教程中早些时候安装的 WebSphere Application Server。
    • Web 模块版本字段中,接受缺省值,该缺省值将根据您选择的 WebSphere Application Server 自动选择。
    • EAR 成员资格字段中,选择将项目添加至 EAR,并确保 EAR 项目名称为 JAXRSEAR
    • 在“部署”部分下面,选择更改功能部件。 在“项目构面”页面上,选择 JAX-RS (REST Web Service) V1.1,然后单击确定
  7. 从可用的配置选项列表中,单击 Java 打开“Java 配置”页面。
    • 构建路径上的源文件夹字段中,接受缺省的 src 目录,或单击添加文件夹编辑...移除为源文件指定文件夹。
    • 缺省输出文件夹:字段中,为输出文件指定文件夹或接受缺省值 (WebContent\WEB-INF\classes)。
      要点: 如果选择一个除 WebContent\WEB-INF\classes 以外的文件夹作为缺省输出文件夹,那么“问题”视图会报告一个警告:
      单一根警告
      单一根问题的缺省值是设置为警告。要更改此设置,请使用“项目结构验证程序的验证过滤器”页面:
      1. 单击窗口 > 首选项 > 验证 > 项目结构验证,然后单击设置...按钮。
      2. 在“项目结构验证程序的验证过滤器”页面上,指定缺省严重性级别。可用的严重性级别为错误警告忽略
  8. 从可用的配置选项列表中,单击 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 库,那么可以使用“用户库首选项”页面进行导入。如果您选择用户库,那么可以启动“用户库首选项”页面并添加库。创建项目之后,您可以在首选项 > 项目构面 > JAX-RS 页面上更改库。
  9. 从可用配置选项的列表中,单击 Web 模块。在“Web 模块配置”页面上,执行下列操作:
    • 上下文根字段中,输入 Web 项目根的名称,或接受缺省值(即 Web 项目的名称)。
    • 内容目录字段中,输入内容目录的名称,或接受缺省值 (WebContent)。
    • 如果您想创建部署描述符,那么选择生成 web.xml 部署描述符。您也可以稍后向 Web 模块添加部署描述符。您需要使用 web.xml 来配置安全性约束和其他行为。
  10. 单击完成
构面会向添加库、Servlet 信息以及对 JAX-RS 注释处理及 JAX-RS 快速修复的支持。

现在,您可以开始下一个模块:创建和测试 Web Service

< 上一课 | 下一课 >
指示主题类型的图标 教程课程主题
信息中心的条款和条件 | 反馈

时间戳记图标 最近一次更新时间: 2014 年 4 月 17 日

文件名:jaxrs_exercise12.html