2.3. 使用 Quickstart 示例
JBoss EAP 提供的快速入门示例是 Maven 项目。
2.3.1. 关于 Maven 复制链接链接已复制到粘贴板!
Apache Maven 是 Java 应用程序开发中使用的分布式构建自动化工具,用于创建、管理和构建软件项目。Maven 使用名为 Project Object Model(POM)文件的标准配置文件来定义项目并管理构建流程。poms 描述模块和组件依赖项,使用 XML 文件描述生成的项目打包和输出的构建顺序和目标。这可确保以正确、一致的方式构建项目。
Maven 使用存储库可实现此目的。Maven 存储库存储 Java 库、插件和其他构建构件。默认公共存储库是 Maven 2 Central Repository,但存储库可以是私有和内部存储库,目标为在开发团队之间共享通用工件。也可从第三方获取存储库。如需更多信息,请参阅 Apache Maven 项目和存储库简介指南。
JBoss EAP 包括一个 Maven 存储库,其中包含 Jakarta EE 开发人员通常用于在 JBoss EAP 上构建应用程序的许多要求。
有关如何在 JBoss EAP 中使用 Maven 的更多信息,请参阅 JBoss EAP 开发指南中的 Maven 与 JBoss EAP 搭配使用。
2.3.2. 通过 Quickstarts 使用 Maven 复制链接链接已复制到粘贴板!
构建应用程序并部署到 JBoss EAP 7 所需的构件和依赖关系托管在公共存储库中。从 JBoss EAP 7 快速入门开始,不再需要配置 Maven settings.xml 文件,以在构建快速入门时使用这些存储库。Maven 存储库现在在 Quickstart 项目 POM 文件中配置。我们提供了这种配置方法,以便更轻松地开始快速入门,但通常不建议用于生产项目,因为它可能会减慢您的构建速度。
红帽 CodeReady Studio 包含 Maven,因此无需单独下载和安装。
如果您计划使用 Maven 命令行来构建和部署应用,您必须首先从 Apache Maven 项目下载 Maven 并使用 Maven 文档中的说明进行安装。
2.3.3. 下载并运行快速入门 复制链接链接已复制到粘贴板!
2.3.3.1. 下载 Quickstarts 复制链接链接已复制到粘贴板!
JBoss EAP 随附一整套快速入门代码示例,旨在帮助用户开始使用各种 Jakarta EE 技术编写应用程序。快速入门可从红帽客户门户下载。
- 在红帽客户门户上登录到 JBoss EAP 下载页面。
- 在 Version 下拉菜单中选择 7.4。
- 在列表中找到 Red Hat JBoss Enterprise Application Platform 7.4.0 Quickstarts 条目,然后单击 Download 以下载包含快速入门的 ZIP 文件。
- 将 ZIP 文件保存到所需的目录中。
- 提取 ZIP 文件。
2.3.3.2. 在 Red Hat CodeReady Studio 中运行 Quickstarts 复制链接链接已复制到粘贴板!
下载 Quickstarts 后,即可将它们导入到红帽 CodeReady Studio 中并部署到 JBoss EAP。
将 Quickstart 导入到 Red Hat CodeReady Studio
每个快速入门都附带了一个 POM 文件,其中包含其项目和配置信息。使用此 POM 文件,轻松将快速入门导入到红帽 CodeReady Studio。
如果您将快速启动项目文件夹导入到 Red Hat CodeReady Studio 中,则 IDE 会生成无效的项目名称和 WAR 归档名称。在开始之前,请确保快速启动项目文件夹位于 IDE 工作区之外。
- 启动 Red Hat CodeReady Studio。
-
选择 File
Import。 选择 Maven
Existing Maven Projects,然后点 Next。 图 2.1. 导入现有 Maven 项目
浏览到所需的快速入门目录(如
helloworld快速启动),然后单击 OK。Projects 列表框填充了所选快速启动项目的pom.xml文件。图 2.2. 选择 Maven Projects
- 点 Finish。
运行 helloworld Quickstart
运行 helloworld 快速入门是一种简单的方式,可以验证 JBoss EAP 服务器是否已正确配置和运行。
- 如果您尚未定义服务器,请将 JBoss EAP 服务器添加到红帽 CodeReady Studio。具体步骤,请参阅 CodeReady Studio 工具入门指南中的通过 IDE 下载、安装和设置 JBoss EAP。
右键点击 Project Explorer 选项卡中的 helloworld 项目,然后选择 Run As
Run on Server。 图 2.3. Run As - 在服务器中运行
*Run on Server* 屏幕截图。" id="uid--r64oh8738" onclick="event.preventDefault()">
*Run on Server* 屏幕截图。" class="modal-img" loading="lazy">
*Run on Server* 屏幕截图。" class="doc-image" loading="lazy">
从服务器列表中选择 JBoss EAP 7.4 服务器,然后点 Next。
图 2.4. 在服务器上运行
helloworld 快速入门已经列出,需要配置在服务器上。点 Finish 以部署快速入门。
图 2.5. 修改服务器上配置的资源
验证结果。
-
在 Server 选项卡中,JBoss EAP 7.4 服务器状态将更改为
Started。 Console 选项卡显示详细说明 JBoss EAP 服务器启动和
helloworld快速启动部署的消息。WFLYUT0021: Registered web context: /helloworld WFLYSRV0010: Deployed "helloworld.war" (runtime-name : "helloworld.war")
WFLYUT0021: Registered web context: /helloworld WFLYSRV0010: Deployed "helloworld.war" (runtime-name : "helloworld.war")Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
helloworld可以通过 http://localhost:8080/helloworld 访问,并显示文本Hello World!。
-
在 Server 选项卡中,JBoss EAP 7.4 服务器状态将更改为
有关 helloworld 快速入门的更多详细信息 ,请参阅 helloworld Quickstart。
运行 bean-validation Quickstart
某些快速入门(如 bean-validation Quickstart)不提供用户界面层,而是提供 Arquillian 测试来演示功能。
-
将
bean-validation快速入门导入到红帽 CodeReady Studio。 - 在 Servers 选项卡中,右键单击服务器,然后选择 Start 以启动 JBoss EAP 服务器。如果您未看到 Servers 选项卡或尚未定义服务器,请将 JBoss EAP 服务器添加到红帽 CodeReady Studio。具体步骤,请参阅 CodeReady Studio 工具入门指南中的通过 IDE 下载、安装和设置 JBoss EAP。
-
右键单击 Project Explorer 选项卡中的
bean-validation项目,然后选择 Run AsMaven Build。 在目标输入字段中输入以下内容,然后点 Run。
clean verify -Parq-remote
clean verify -Parq-remoteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 图 2.6. 编辑配置
验证结果。
Console 标签页显示
bean-validationArquillian 测试的结果:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3.3.3. 从命令行运行 Quickstarts 复制链接链接已复制到粘贴板!
您可以使用 Maven 从命令行轻松构建和部署快速入门。如果您尚未安装 Maven,请参见 Apache Maven 项目以下载和安装它。
快速入门的根目录中提供了一个 README.md 文件,其中包含系统要求、配置 Maven、添加用户和运行快速入门的一般信息。
每个快速入门还包含自己的 README.md 文件,它提供特定的指令和 Maven 命令来运行该快速入门。
从命令行运行 helloworld Quickstart
-
检查 helloworld 快速启动根目录中的
README.md文件。 启动 JBoss EAP 服务器。
EAP_HOME/bin/standalone.sh
$ EAP_HOME/bin/standalone.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 前往 helloworld quickstart 目录。
使用快速启动的
README.md文件中提供的 Maven 命令构建和部署快速入门。mvn clean install wildfly:deploy
$ mvn clean install wildfly:deployCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
helloworld 应用可以通过 http://localhost:8080/helloworld 访问并显示文本
Hello World!。