Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

第 3 章 用 JBoss EAP 开发应用程序

3.1. 概述

本指南提供了使用 Red Hat JBoss Developer Studio 和 JBoss EAP 7 quickstart 例程开发应用程序的信息。

Red Hat JBoss Developer Studio 是一个基于 Eclipse 的集成开发环境（IDE），它集成了 JBoss 应用程序开发插件。JBoss Developer Studio 可以使用 JBoss 专有的向导并帮助您部署应用程序至 JBoss EAP 服务器。JBoss EAP 7 提供了许多 Quickstarts 例程来帮助用户使用不同的 Java EE 7 技术编写应用程序。

本指南提供了 JBoss Developer Studio 的基本安装说明。关于完整的安装说明，请参考 Install Red Hat JBoss Developer Studio。

3.2. 设置开发环境

3.2.1. 下载 JBoss Developer Studio

您可以从 Red Hat 客户门户网站下载 JBoss Developer Studio。

  1. 登录 Red Hat 客户门户。
  2. 点击 Downloads。
  3. 在 Product Downloads 列表里，点击 Red Hat JBoss Developer Studio。

  4. 从 Version 下拉菜单里选择想要的版本。

    注意

    我们推荐您使用JBoss Developer Studio 9.1 或更新的版本。

  5. 在表里找到 Red Hat JBoss Developer Studio 9.x.x Stand-alone Installer 条目并点击 Download。
  6. 保存 JAR 文件至预想的目录。

3.2.2. 安装 JBoss Developer Studio

  1. 打开终端出口并进入包含下载的 JAR 文件的目录。

  2. 运行下列命令启动 GUI 安装程序： 

    $ java -jar jboss-devstudio-BUILD_VERSION-installer-standalone.jar
    注意

    或者，您可以双击 JAR 文件来启动安装程序。

  3. 点击 Next 以启动安装过程。
  4. 选择 I accept the terms of this license agreement 并点击 Next。

  5. 调整安装路径并点击 Next。

    注意

    如果安装路径已存在，提示将会出现。请点击 OK 创建这个文件夹。

  6. 选择 JVM，或者保持默认的 JVM，然后点击 Next。
  7. 当被要求选择平台和服务器时点击 Next。
  8. 复核安装细节，然后点击 Next。
  9. 当安装过程完成时点击 Next。
  10. 为 JBoss Developer Studio 配置桌面快捷键并点击 Next。
  11. 点击 Done。

3.2.3. 启动 JBoss Developer Studio

要启动 Red Hat JBoss Developer Studio，您可以双击安装过程中创建的桌面快捷键，或者在命令行启动。遵循下列步骤用命令行启动 JBoss Developer Studio。

  1. 打开终端窗口并进入 Red Hat JBoss Developer Studio 安装目录。

  2. 运行下列命令来启动 Red Hat JBoss Developer Studio： 

    $ ./jbdevstudio
    注意

    对于 Windows 服务器，请使用 jbdevstudio.bat 文件。

3.2.4. 添加 JBoss EAP 服务器到 JBoss Developer Studio

这些说明假定您还没将JBoss EAP 服务器添加至 JBoss Developer Studio。按下列步骤用 Define New Server 向导添加 JBoss EAP 服务器。

  1. 打开 Servers 标签页。

    注意

    如果 Servers 标签页没有显示，请选择 Window → Show View → Servers。

  2. 点击 No servers are available. Click this link to create a new server 链接。

    图 3.1. 添加新的服务器

    The *Servers* tab when no servers are available.

  3. 展开 Red Hat JBoss Middleware 并选择 JBoss Enterprise Application Platform 7.0。输入服务器名称，例如：JBoss EAP 7.0，然后点击 Next。

    图 3.2. 定义新的服务器

    The *Define a New Server* window.

  4. 创建一个服务器适配器来管理服务器的启动和停止。保持默认值并点击 Next。

    图 3.3. 创建新的服务器适配器

    The *Create a New Server Adapter* window.

  5. 输入名称，例如 JBoss EAP 7.0 Runtime。点击 Home Directory 旁的 Browse 并进入您的 JBoss EAP 安装目录。然后点击 Next。

    图 3.4. 添加新的服务器 Runtime 环境

    The *JBoss Runtime* window.
    注意

    某些 Quickstart 要求您用不同的配置集或其他参数来运行服务器。例如，要部署要求 full 配置集的 Quickstart，您必须定义一个新的服务器并在 Configuration file 字段指定 standalone-full.xml 。请确保为新服务器取一个描述性的名字。

  6. 为新的服务器配置现有的项目。因为目前还没有任何项目，所以请点击 Finish。

    图 3.5. 修改新服务器的资源

    The *Add and Remove Resources* window.

Servers 标签页里列出了 JBoss EAP 7.0 服务器。

图 3.6. 服务器列表

The *Servers* tab when the `JBoss EAP 7.0` server is listed.

3.3. 使用 Quickstart 例程

JBoss EAP 里包含的 Quickstart 例程是 Maven 项目。

3.3.1. 关于 Maven

Maven 是一个在 Java 开发中创建、构建和管理软件项目的分布式自动构建工具。Maven 使用标准的配置文件（Project Object Model 或称为 POM）来定义项目和管理构建过程。POM 使用 XML 文件描述了模块和组件的依赖关系、构建顺序和结果项目软件包的目标及输出。这确保了项目以正确和统一的方式进行构建。

Maven 是通过资料库实现这一点的。Maven 资料库保存 Java 库、插件和其他的构建构件。默认的公共资料库是 Maven 2 Central Repository，但资料库可以是机构私有和内部的，在开发团队间共享公用的构件。资料库也可来自第三方。更多信息请参考 Apache Maven 项目和 Introduction to Repositories 。

JBoss EAP 附带的 Maven 资料库包含了 Java EE 开发人员构建 JBoss EAP 应用程序所常用的内容。

关于在 JBoss EAP 里使用 Maven 的更多信息，请参考《JBoss EAP 开发指南》里的『Using Maven with JBoss EAP』章节。

3.3.2. 在 Quickstarts 里使用 Maven

构建和部署应用程序到 JBoss EAP 7 的构件和依赖关系存放在公用资料库。从 JBoss EAP 7 开始，构建 quickstarts 不再需要配置 settings.xml 来使用这些资料库。现在是通过 Quickstart 项目的 POM 文件来配置 Maven 资料库。这种方式让 Quickstart 更易于使用，然而，我们通常不建议将其用于产品项目，因为这会拖慢构建过程。

Red Hat JBoss Developer Studio 包含了 Maven，所以不需要单独下载和安装它。我们推荐您使用 JBoss Developer Studio version 9.1 或更新的版本。

如果您计划用 Maven 命令行来构建和部署应用程序，您必须先从 Apache Maven 项目下载 Maven 并根据 Maven 文档里的说明安装它。

3.3.3. 下载和运行 Quickstarts

3.3.3.1. 下载 Quickstarts

JBoss EAP 带有详尽的 quickstart 示例代码以帮助用户开始用不同的 Java EE 7 技术编写应用程序。您可以从 Red Hat 客户门户网站下载 Quickstarts 例程。

  1. 登录 Red Hat 客户门户。
  2. 点击 Downloads。
  3. 在 Product Downloads 列表里，点击 Red Hat JBoss Enterprise Application Platform。
  4. 从 Version 下拉菜单里选择想要的版本。
  5. 在表里找到 Red Hat JBoss Enterprise Application Platform 7.0.0 Quickstarts 条目并点击 Download。
  6. 将 ZIP 保存到想要的位置。
  7. 解压 ZIP 归档文件。

3.3.3.2. 在 Red Hat JBoss Developer Studio 里运行 Quickstarts

在下载了 Quickstarts 例程后，它们可以导入到 JBoss Developer Studio 并部署至 JBoss EAP。

将 Quickstarts 导入至 JBoss Developer Studio

每个 Quickstart 都附带一个 POM（Project Object Model）文件，它包含这个 Quickstart 的项目和配置信息。用这个 POM 文件，您可以轻松地将 Quickstart 导入到 Red Hat JBoss Developer Studio 里。

重要

在导入到 Red Hat JBoss Developer Studio 时，如果您的 Quickstart 项目文件夹位于 IDE 工作区里，IDE 会生成一个无效的项目名及 WAR 归档名。在开始导入之前，请确定您的 Quickstart 项目文件夹在 IDE 工作区之外。

  1. 启动 JBoss Developer Studio。
  2. 选择 File → Import。

  3. 选择 Maven → Existing Maven Projects，然后点击 Next。

    图 3.7. 导入现有的 Maven 项目

    The *Import* window.

  4. 浏览要操作的 Quickstart 目录（例如 helloworld quickstart），然后点击 OK。 Projects 列表框将用所选的 Quickstart 项目的 pom.xml 文件填充。

    图 3.8. 选择 Maven 项目

    The *Maven Projects* selection window.
  5. 点击 Finish。

运行 helloworld Quickstart

运行 helloworld quickstart 是检验 JBoss EAP 服务器是否配置和运行正常的简易方法。

  1. 如果您还没有定义服务器，请参考 add the JBoss EAP server to JBoss Developer Studio。

  2. 右击 Project Explorer 标签页里的 jboss-helloworld 项目并选择 Run As → Run on Server。

    图 3.9. Run As - Run on Server

    The *Run As* -> *Run on Server* screen capture.

  3. 从服务器列表选择 JBoss EAP 7.0 并点击 Next。

    图 3.10. 在服务器上运行

    The *Run on Server* window.

  4. jboss-helloworld quickstart 已经列出在服务器进行配置。点击 Finish 部署这个 Quickstart。

    图 3.11. 修改服务器上配置的资源

    The *Add and Remove Resources* window.

  5. 检验结果。

    • 在 Server 标签页里，JBoss EAP 7.0 服务器的状态已改为 Started。

    • Console 标签页显示了详述 JBoss EAP 服务器启动和 helloworld quickstart 部署的信息。 

      WFLYUT0021: Registered web context: /jboss-helloworld
WFLYSRV0010: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
    • helloworld 应用程序可通过 http://localhost:8080/jboss-helloworld 访问，它会显示文本 Hello World!。

运行 bean-validation Quickstart

某些 Quickstarts 例程，如 bean-validation，不会提供用户界面层而是用 Arquillian 测试来演示功能。

  1. 导入 bean-validation quickstart 至 JBoss Developer Studio。
  2. 在 Servers 标签页，右击服务器并选择 Start 以启动 JBoss EAP 服务器。如果您没有看到 Servers 标签页或还没有定义服务器，请添加 JBoss EAP 服务器至 Red Hat JBoss Developer Studio。
  3. 右击 Project Explorer 标签页里的 jboss-bean-validation 项目并选择Run As → Maven Build。

  4. 在 Goals 字段输入下列内容并点击 Run。 

    clean test -Parq-wildfly-remote

    图 3.12. 编辑配置

    The *Edit Configuration* window.

  5. 检验结果。

    Console 标签页显示了 bean-validation Arquillian 测试的结果： 

    -------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec

Results :

Tests run: 5, Failures: 0, Errors: 0, Skipped: 0

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

3.3.3.3. 用命令行运行 Quickstarts

您可以轻易地从命令行用 Maven 构建和部署 Quickstarts。如果您还没有安装 Maven，请参考 Apache Maven 项目来下载并安装它。

Quickstarts 的根目录提供了一个 README.md 文件，它包含关于系统要求、配置 Maven、添加用户和运行 Quickstarts 的普通信息。

每个 Quickstart 也包含自己的 README.md 文件，它提供运行这个 Quickstart 的专门的说明及 Maven 命令。

从命令行运行 helloworld Quickstart

  1. 复查 helloworld quickstart 根目录里的 README.md 文件。

  2. 启动 JBoss EAP 服务器。 

    $ EAP_HOME/bin/standalone.sh
  3. 进入 helloworld quickstart 目录。

  4. 用 README.md 文件里提供的 Maven 命令构建和部署 Quickstart。 

    mvn clean install wildfly:deploy
  5. helloworld 应用程序可通过 http://localhost:8080/jboss-helloworld 访问并显示文本 Hello World!。