JBoss Tools——使用 Forge 工具开发应用程序

创建新项目

创建 Forge 项目后，可以设置持久性、添加实体和字段并为项目创建脚手架。

要创建新项目，请执行以下操作

按 Ctrl+4 启动 Forge 并打开 JBoss Forge 上下文菜单。
单击项目:新打开创建一个新项目窗口。
在创建一个新项目窗口中
1. 在项目名称字段中，键入项目名称。
2. 在顶级程序包中，键入{com.example}作为顶级程序包。
3. 在项目位置字段中，输入 Forge 项目的目标位置。
4. 在堆栈列表中，单击Java EE 7。
单击完成。

图 1. 创建新 Forge 项目

结果：该项目列在Project Explorer视图中。

设置持久性

设置 JPA 先决条件，在项目中创建persistence.xml文件并在pom.xml中添加必需的依赖。

注意：创建 JPA 实体时，Forge 控制台将自动检测必须设置的任何前提条件，并提示你运行时创建这些前提条件。

要设置持久性，请执行以下操作

按 Ctrl+4 打开 JBoss Forge 上下文菜单。
单击JPA：新实体。该窗口将填充默认值。
单击下一步以继续使用默认值或编辑字段以更改值。
在配置你的连接设置窗口中，确保字段显示适当的值，然后单击下一步。
在创建新 JPA 实体窗口中
1. 在程序包名称字段中，键入程序包名称。
2. 在类型名称字段中，为新实体键入名称。
单击完成。

结果：新实体出现在 JBoss 编辑器中，并以名称列在Project Explorer视图中：{entity_name}.java。

${entity_name}.java Displayed in the JBoss Editor$

图 2. 在 JBoss 编辑器中显示的 {entity_name}.java

向实体添加字段

按 Ctrl+4 打开 JBoss Forge 上下文菜单。
单击JPA：新建字段。
在新建字段窗口中
1. 在目标实体字段中，选择{package_name.model.entity}。
2. 在字段名称字段中，键入FirstName。
单击完成。

图 3. 向实体添加字段
重复步骤 1 至 4 以向实体添加更多字段。

结果：字段已添加到 Customer.java 文件。

创建脚手架

脚手架是由程序使用可用信息（通常是数据库）自动生成的代码，用于生成基本的 CRUD（创建、读取、更新、删除）管理界面。脚手架生成命令用于创建脚手架。

创建脚手架

按 Ctrl+4 打开 JBoss Forge 上下文菜单。
单击脚手架生成。
在脚手架类型列表中，单击Angular JS，然后单击下一步。
如果未将项目配置为使用想要使用的所有技术，Forge 会提示您设置依赖项。单击下一步。
在选择 JPA 实体窗口中
1. 选中目标字段中的复选框。
2. 选中生成 REST 资源复选框。
单击完成。

Select JPA Entities to Create the Scaffold

图 4. 选择要创建脚手架的 JPA 实体

结果：在项目资源管理器视图中创建并列出了实体。

运行和测试应用程序

在此示例中，我们使用 JBoss EAP 服务器来运行应用程序。

运行应用程序

在项目资源管理器视图中，右键单击应用程序，然后单击运行方式>在服务器上运行。或者，也可以从项目资源管理器视图将应用程序拖放到服务器视图中的JBoss EAP {版本}服务器。应用程序在默认浏览器中打开。
单击客户，然后单击创建以创建新客户。
在FirstName和LastName字段中，输入名字和姓氏，然后单击保存。客户已添加到应用程序。

使用搜索客户部分按名字和/或姓氏搜索客户。

创建扩展/加载项

加载项/扩展在 IDE 中运行。向加载项添加了命令和功能后，无需进行进一步的更改，扩展或加载项便可以在其他 IDE 中运行。

创建加载项

按 Ctrl+4 打开 JBoss Forge 上下文菜单。
单击项目：新建。
在创建一个新项目窗口中
1. 在项目名称字段中，键入加载项的名称。
2. 在项目类型列表中，单击Forge 加载项 (JAR)。
单击下一步。
在炉子附件设置窗口的依据这些附件部分中，Forge 会自动选择先决条件。检查依赖项，然后单击完成。
按 Ctrl+4 打开 Forge 上下文菜单。
选择Java: 新类以打开Java: 新类窗口。
在类型名称字段中，键入CustomCommand，然后单击完成。CustomCommand.java 文件随即在 JBoss 编辑器中打开。
若要将该 Java 类更改为 Forge 命令
1. 按 Ctrl+4 打开 Forge 上下文菜单。
2. 选择附件: 新 UI 命令以打开生成 UICommand 实现窗口。
3. 在生成 UICommand 实现窗口中
  - 在类型名称字段中，键入CustomCommand。
  - 在命令名称字段中，键入custom。
4. 单击完成。
  
  图 5. 添加命令
  
  该命令会列在 CustomerCommand.java 文件中。
按 Ctrl+4 打开 Forge 上下文菜单。
选择编译并安装附件以打开编译并安装 Forge 附件窗口。
单击完成将附件安装到 IDE 中。

若要执行已安装的命令

按 Ctrl+4 打开 Forge 上下文菜单。
选择 custom。

向该方法添加参数，以便将用户输入添加到命令中。将以下命令复制并粘贴到 CustomCommand.java 文件中

        package org.jboss.forge.addon.commands;

        import org.jboss.forge.addon.configuration.Configuration;
        import org.jboss.forge.addon.resource.URLResource;
        import org.jboss.forge.addon.ui.command.AbstractUICommand;
        import org.jboss.forge.addon.ui.context.UIBuilder;
        import org.jboss.forge.addon.ui.context.UIContext;
        import org.jboss.forge.addon.ui.context.UIExecutionContext;
        import org.jboss.forge.addon.ui.input.UIInput;
        import org.jboss.forge.addon.ui.metadata.UICommandMetadata;
        import org.jboss.forge.addon.ui.metadata.WithAttributes;
        import org.jboss.forge.addon.ui.util.Metadata;
        import org.jboss.forge.addon.ui.util.Categories;
        import org.jboss.forge.addon.ui.result.Result;
        import org.jboss.forge.addon.ui.result.Results;

        import java.lang.Override;
        import java.lang.Exception;

        import javax.inject.Inject;

        public class JIRASetupCommand extends AbstractUICommand
        {
               @Inject
               @WithAttributes(label = "JIRA URL", required = true)
                private UIInput<URLResource> url;

        @Inject
        private Configuration config;

        @Override
        public UICommandMetadata getMetadata(UIContext context)
        {

             return Metadata.forCommand(getClass())
                    .name("JIRA: Setup")
                    .description("Setup the JIRA Addon")
                    .category(Categories.create("JIRA", "Setup"));
        }

        @Override
        public void initializeUI(UIBuilder builder) throws Exception

        {
              builder.add(url);
        }

         @Override
         public Result execute(UIExecutionContext context)
         {
               String targetUrl = url.getValue().getFullyQualifiedName();
               Configuration subset = config.subset("jira");
               subset.setProperty("url", targetUrl);
               return Results.success("JIRA URL set to: "+targetUrl);
          }
         }

若要重新编译并安装
1. 在项目资源管理器视图中，单击已创建的附件。
2. 按 Ctrl+4 打开 Forge 上下文菜单。
3. 选择编译并安装附件。
4. 单击完成将附件安装到 IDE 中。
5. 按 Ctrl+4 打开 Forge 上下文菜单。
6. 单击JIRA: 设置。

图 6. Forge 上下文菜单中列出的附件

结果：创建附件，并将其列在 Forge 上下文菜单中。

您知道吗

您可以通过点击窗口 显示视图 Forge 控制台 来启动 Forge 控制台。Forge 控制台视图以非活动状态打开。
您可以通过点击 `启动 {JBoss Forge_version} ` 按钮 ).
来启动 JBoss Forge。
若要将 Forge 控制台输出与打开的编辑器相链接，请单击使用编辑器链接按钮 ().

操作指南

使用 Forge 工具开发应用程序

创建新项目

设置持久性

向实体添加字段

创建脚手架

运行和测试应用程序

创建扩展/加载项

您知道吗