一个 JBoss 项目
Red Hat
主页 / 文档 / 操作方法 / 配置适用于 JBoss EAP 和 JBoss Web Framework Kit 的 IDE

操作方法

配置适用于 JBoss EAP 和 JBoss Web Framework Kit 的 IDE

本文针对需要配置新安装的 IDE 或升级正在使用的 Red Hat JBoss Enterprise Application Platform 或 JBoss Web Framework Kit 的新老用户提供详细信息。

只有在针对使用 JBoss EAP 和 JBoss Web Framework Kit 配置 IDE 后，IDE 才支持使用 JBoss EAP 和 JBoss Web Framework Kit 进行应用程序开发和部署。这一配置对于使用 JBoss Central 中提供的示例 Maven 项目的企业版本至关重要。这些项目旨在部署到 JBoss EAP，并需要 IDE 访问 JBoss EAP 和 JBoss Web Framework Kit Maven 知识库。

提供针对以下任务的说明

  1. 设置 JBoss EAP 其中包含三种方法，以便在 IDE 中使用

  2. 针对 JBoss EAP 和 JBoss Web Framework Kit Maven 知识库配置 Maven

1. 设置 JBoss EAP

要设置在 IDE 中使用 JBoss EAP，必须指导 IDE 到达本地或远程运行时服务器。这将在 IDE 和 JBoss EAP 服务器之间建立通信渠道，以便执行高效的部署和服务器管理工作流。根据你的情况，你可以使用三种方法之一设置 JBoss EAP 服务器

  1. 如果你要安装 IDE 的新实例，可以使用 Red Hat Development Suite 下载、安装和设置 IDE 及 JBoss EAP。

  2. 如果你已经安装了 IDE 但没有安装 JBoss EAP，可以从 IDE 中下载、安装和设置 JBoss EAP。

  3. 如果 IDE 和 JBoss EAP 已安装，可以通过使用运行时检测从 IDE 中设置 JBoss EAP。

A 使用 DevSuite 安装程序下载、安装和设置 IDE 及 JBoss EAP

如果你正在安装 IDE 的新实例，那么可以使用红帽开发套件安装程序来下载、安装和设置 IDE 及 JBoss EAP。安装程序中打包着特定版本的 JBoss EAP。有关通过红帽开发套件安装的组件的详细信息，请参见红帽开发套件安装指南中的 组件详细信息。

如果您想安装不同版本的 JBoss EAP，那么可以从 IDE 内下载（请参见 在 IDE 中下载、安装和设置 JBoss EAP））或单独安装，然后按照 C 中的说明操作，在 IDE 中使用运行时检测来设置 JBoss EAP。

有关安装红帽开发套件的详细说明，请参见 红帽开发套件安装指南。

使用 DevSuite 安装程序下载、安装和设置 IDE 及 JBoss EAP

  1. 登录红帽开发者门户产品下载页面 红帽开发者下载，下载红帽开发套件。请注意，在下一步之前，你必须解压 macOS 安装程序。如果你使用 Safari 浏览器下载，会自动解压缩 macOS 安装程序。

  2. 运行下载的安装文件（在线或捆绑包）。

  3. 在红帽开发套件窗口中，单击下一步继续。

  4. 在目标文件夹窗口的选择安装文件夹字段中，键入你希望安装红帽开发套件的位置，然后单击下一步继续。确认窗口列出了可通过红帽开发套件下载和安装的组件。

    此用例要求你只下载 JBoss Developer Studio 和红帽 JBoss 企业应用程序平台。但是，你可以选择下载通过红帽开发套件提供的任何其他组件或所有组件。

  5. 单击红帽 JBoss Developer Studio和红帽 JBoss 企业应用程序平台复选框，然后单击下一步。

  6. 在帐户窗口中，输入你现有的红帽开发者登录凭证。

  7. 单击下载并安装以继续。下载并安装窗口显示了安装进度。

  8. 在开始使用窗口中，单击打开红帽 JBoss Developer Studio。

  9. 在Eclipse Launcher窗口中，选择要存储项目数据的工作空间位置，然后单击启动。

  10. Searching for runtimes窗口会自动搜寻并检测可用的运行时。

  11. 在表中，单击Red Hat JBoss EAP 7.0，然后单击确定。

    Searching for runtimes Window Listing Red Hat JBoss EAP 7.0
    图 1. 在窗口中搜索运行时，列出 Red Hat JBoss EAP 7.0

    结果：打开“服务器”视图，查看在“已停止”模式中列出的 Red Hat JBoss EAP 7.0 服务器。

B. 在 IDE 中下载、安装和设置 JBoss EAP

如果已安装 IDE，则可以从 IDE 中下载、安装和设置 JBoss EAP。使用此选项，可以选择支持的各种 JBoss EAP 版本；有关支持的 JBoss EAP 版本的详细信息，请参阅https://access.redhat.com/site/articles/427493。

在 IDE 中下载、安装和设置 JBoss EAP

  1. 启动 IDE。

  2. 单击“窗口”>“首选项”，展开“JBoss 工具”，然后单击“JBoss 运行时检测”。

  3. 在“路径”窗格中，单击“下载”。

  4. 在“下载运行时”窗口中的“下载运行时”表中，选择要下载的 JBoss EAP 版本，然后单击“下一步”。

    对于 JBoss EAP 6.1.x 及更高版本，请继续执行此处给出的步骤。对于 JBoss EAP 6.0.x 及更早版本，请按照屏幕上的指示从 Red Hat 客户门户中下载 JBoss EAP，并在安装 JBoss EAP 后继续使用运行时检测在 IDE 中设置 JBoss EAP。
    Download Runtimes Window Listing Available JBoss EAP Versions
    图 2. 列出可用 JBoss EAP 版本的下载运行时窗口

  5. 在“JBoss.org 凭证”窗口的“域”字段中，输入“jboss.org”，然后单击“用户名”字段旁边的“添加”。请注意，如果您没有 JBoss.org 帐户，则必须单击链接进行注册。

  6. 在“添加凭证”窗口的“用户名”字段中，键入您的用户名，在“密码”字段中，键入密码，然后单击“确定”。

  7. 在“下载运行时”窗口中，单击“下一步”。

  8. 在“JBoss.org 条款和条件”窗口中，阅读条款和条件，从“请选择使用国家/地区”列表中选择您的使用国家/地区，然后单击“立即接受”。如果您之前已在 IDE 或通过 jboss.org 网站接受了条款和条件，则会跳过该窗口。

  9. 单击“下一步”。

  10. 阅读“通用公共许可证”，单击“我接受许可协议的条款”，然后单击“下一步”。

  11. 对于“安装文件夹”字段，单击“浏览”，选择安装 JBoss EAP 的位置，然后单击“完成”。

  12. 单击“应用”和“确定”关闭“首选项”窗口。下载和安装将会开始，可能需要一段时间才能完成。

结果：服务器将以“已停止”模式在“服务器”视图中列出。

C. 在 IDE 中使用运行时检测设置 JBoss EAP

如果您已经安装了 IDE 和 JBoss EAP，您可以使用运行时检测在 IDE 中设置 JBoss EAP。运行时检测功能会自动识别在本地系统上已安装的 JBoss EAP 实例，并生成相应的默认服务器设置，以便在 IDE 中使用。此功能使得快速启动默认 JBoss EAP 服务器变得非常简单。

每个 IDE 版本都支持特定的 JBoss EAP 版本；有关受支持的 JBoss EAP 版本的详细信息，请参阅 https://access.redhat.com/site/articles/427493。

要使用运行时检测在 IDE 中设置 JBoss EAP，请

  1. 启动 IDE。

  2. 单击窗口>首选项，展开JBoss Tools，然后选择JBoss 运行时检测。

  3. 单击添加。

  4. 导航至path/to/jboss-eap，然后单击确定。JBoss Server Tools 将递归扫描路径，查找已安装的服务器，并显示找到的服务器列表。

  5. 确保选中jboss-eap-version复选框，其中 version 表示 JBoss EAP 版本，然后单击确定。

    Selecting a Runtime
    图 3. 选择运行时

  6. 单击应用并单击确定以关闭首选项窗口。

结果：服务器已在服务器视图中以已停止模式列出。

2. 为 JBoss EAP 和 JBoss Web Framework Kit Maven 存储库配置 Maven

要在 IDE 内工作时将 Maven 配置为使用 JBoss EAP 和 JBoss Web Framework Kit Maven 存储库，您必须确保 IDE 知道 Maven 配置settings.xml文件的位置，并且该文件包含用于 JBoss EAP 和 JBoss Web Framework Kit Maven 存储库的必要配置文件。这样可确保在从 IDE 内调用 Maven 来构建 Maven 项目时，Maven 知道到哪里查找项目相关性。

指定 Maven settings.xml 文件位置

如果您有多个 Maven settings.xml文件，或正在使用共享的settings.xml文件，则此文件可能不在 IDE 预期的默认位置。在这种情况下，您必须告知 IDE 该文件的位置。

要指定 Maven settings.xml文件位置，请

  1. 启动 IDE。

  2. 单击窗口>首选项，展开Maven，然后单击用户设置。

  3. 对于用户设置字段，单击浏览并找到settings.xml文件。

  4. 单击更新设置。

  5. 单击应用，然后单击确定。

使用 JBoss EAP 和 JBoss Web Framework Kit Maven 存储库

你可以从红帽客户门户下载 JBoss EAP 和 JBoss Web Framework 工具包 Maven 存储库，或使用位于 https://maven.repository.redhat.com/ga 的在线 Maven 存储库。

使用离线 Maven 存储库

如果你以前没有使用过这些版本的 JBoss EAP 和 JBoss Web Framework 工具包，则必须配置你的 Maven settings.xml 文件，以使用关联的产品 Maven 存储库。你可以在文本编辑器中手动编辑你的 settings.xml 文件，或使用 JBoss Developer Studio Maven 集成功能来自动检测 JBoss 存储库并适当地编辑你的 settings.xml 文件。

JBoss EAP 和 JBoss Web Framework 工具包 Maven 存储库必须已经从红帽客户门户获取，并位于你可以访问的系统上。

要使用 IDE 指定 JBoss EAP 和 JBoss Web Framework 工具包 Maven 存储库位置

  1. 启动 IDE。

  2. 单击窗口 > 首选项，展开JBoss 工具，然后单击JBoss Maven 集成。

  3. 单击配置 Maven 存储库。

  4. 单击添加存储库。

  5. 单击识别 JBoss Maven 企业存储库。

  6. 导航到 path/to/jboss-eap-maven-repository 并单击确定。JBoss Maven 工具将递归扫描路径，寻找 Maven 存储库。

  7. 根据需要修改ID和名称字段中的信息，确保勾选“默认情况下处于活动状态”复选框，然后单击**确定**。

    Details of the Selected Maven Repository
    图 4. 所选 Maven 存储库的详细信息

  8. 单击添加存储库。

  9. 单击识别 JBoss Maven 企业存储库。

  10. 导航到 path/to/jboss-wfk-maven-repository 并单击确定。JBoss Maven 工具将递归扫描路径，寻找 Maven 存储库。

  11. 根据需要修改ID和名称字段中的信息，确保勾选“默认情况下处于活动状态”复选框，然后单击**确定**。

  12. 单击完成，在出现提示询问你是否确定要更新 Maven 配置文件时，单击是。如果指定的配置文件不存在，JBoss Maven Tools 将创建它。

  13. 单击应用并单击确定以关闭首选项窗口。

使用在线 Maven 存储库

将在线存储库添加到 IDE，将 https://maven.repository.redhat.com/ga添加到你的 settings.xml 中，它将处理所有依赖关系。

要使用在线 Maven 存储库

  1. 启动 IDE。

  2. 单击窗口 > 首选项，展开JBoss 工具，然后单击JBoss Maven 集成。

  3. 单击配置 Maven 存储库。

  4. 单击添加存储库。

  5. 在配置文件 ID下拉列表中，选择redhat-ga-repository。

    Add a Maven Repository
    图 5. 添加 Maven 存储库

  6. 单击确定。

  7. 在配置 Maven 存储库窗口中，单击完成。

  8. 单击应用，然后单击确定以关闭首选项窗口。

返回顶部