< 上一课 | 下一课 >

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

在本课程中,您将了解如何创建服务器和 Web 项目以与 Web Service 配合使用。

创建支持 JAX-WS 的服务器

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

为 Web Service 创建 Web 项目

Web Service 向导可以为 Web Service 创建 Web 项目并为您启用构面,但在本教程中,您将手动创建该项目。
  1. 在 Java EE 透视图中,右键单击企业应用程序项目并选择新建 > Web 项目以打开“Web 项目”向导。
  2. 名称字段中,为新的 Web 项目输入名称。 对于本教程,请使用 jwsAddressBook
  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 V7 或 V8。
    • Web 模块版本字段中,接受缺省值(将根据您选择的 WebSphere Application Server 自动进行选择)。
    • EAR 成员资格字段中,选择将项目添加至 EAR 并确保 EAR 项目名称为 jwsAddressBookEAR
    • 在“部署”部分下面,选择更改功能部件。 在“项目构面”页面上,选择 JAX-RS (REST Web Service) V1.1,然后单击确定
  7. 从可用的配置选项列表中,单击 Java 打开“Java 配置”页面。
    • 构建路径上的源文件夹字段中,接受缺省的 src 目录,或单击添加文件夹编辑...移除为源文件指定文件夹。
    • 缺省输出文件夹:字段中,为输出文件指定文件夹或接受缺省值 (WebContent\WEB-INF\classes)。
      要点: 如果选择一个除 WebContent\WEB-INF\classes 以外的文件夹作为缺省输出文件夹,那么“问题”视图会报告一个警告:
      单一根警告
      单一根问题的缺省值是设置为警告。要更改此设置,请使用“项目结构验证程序的验证过滤器”页面:
      1. 单击窗口 > 首选项 > 验证 > 项目结构验证,然后单击设置...按钮。
      2. 在“项目结构验证程序的验证过滤器”页面上,指定缺省严重性级别。可用的严重性级别为错误警告忽略
  8. 从可用配置选项的列表中,单击 Web 模块。在“Web 模块配置”页面上,执行下列操作:
    • 上下文根字段中,输入 Web 项目根的名称,或接受缺省值(即 Web 项目的名称)。
    • 内容目录字段中,输入内容目录的名称,或接受缺省值 (WebContent)。
    • 如果您想创建部署描述符,那么选择生成 web.xml 部署描述符。您也可以稍后向 Web 模块添加部署描述符。您需要使用 web.xml 来配置安全性约束和其他行为。
  9. 单击完成

为 Web Service 客户机创建 Web 项目

Web Service 向导可以为客户机创建 Web 项目并为您启用构面,但在本教程中,您将手动创建该项目。
  1. 在 Java EE 透视图中,右键单击企业应用程序项目并选择新建 > Web 项目以打开“Web 项目”向导。
  2. 名称字段中,为新的 Web 项目输入名称。 对于本教程,请使用 jwsAddressBookClient
  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 V7 或 V8。
    • Web 模块版本字段中,接受缺省值(将根据您选择的 WebSphere Application Server 自动进行选择)。
    • EAR 成员资格字段中,选择将项目添加至 EAR 并确保 EAR 项目名称为 jwsAddressBookEAR
    • 在“部署”部分下面,选择更改功能部件。 在“项目构面”页面上,选择 JAX-RS (REST Web Service) V1.1,然后单击确定
  7. 从可用的配置选项列表中,单击 Java 打开“Java 配置”页面。
    • 构建路径上的源文件夹字段中,接受缺省的 src 目录,或单击添加文件夹编辑...移除为源文件指定文件夹。
    • 缺省输出文件夹:字段中,为输出文件指定文件夹或接受缺省值 (WebContent\WEB-INF\classes)。
      要点: 如果选择一个除 WebContent\WEB-INF\classes 以外的文件夹作为缺省输出文件夹,那么“问题”视图会报告一个警告:
      单一根警告
      单一根问题的缺省值是设置为警告。要更改此设置,请使用“项目结构验证程序的验证过滤器”页面:
      1. 单击窗口 > 首选项 > 验证 > 项目结构验证,然后单击设置...按钮。
      2. 在“项目结构验证程序的验证过滤器”页面上,指定缺省严重性级别。可用的严重性级别为错误警告忽略
  8. 从可用配置选项的列表中,单击 Web 模块。在“Web 模块配置”页面上,执行下列操作:
    • 上下文根字段中,输入 Web 项目根的名称,或接受缺省值(即 Web 项目的名称)。
    • 内容目录字段中,输入内容目录的名称,或接受缺省值 (WebContent)。
    • 如果您想创建部署描述符,那么选择生成 web.xml 部署描述符。您也可以稍后向 Web 模块添加部署描述符。您需要使用 web.xml 来配置安全性约束和其他行为。
  9. 单击完成

下载地址簿 WSDL 文件

下载必需的 WSDL 文件。

课程要点

现在,您可以开始课程 2:创建 Web Service .

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

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

文件名:jaxwstd_exercise11.html