JBoss Tools - Develop Applications Using the Forge Tools

Create a New Project

After you have created a Forge project you can set up persistence, add entities and fields, and create scaffold for the project.

To create a new project:

Press Ctrl+4 to start Forge and open the JBoss Forge context menu.
Click Project:New to open the Create a new project window.
In the Create a new project window:
1. In the Project name field, type a project name.
2. In the Top level package field, type {com.example} as the top package.
3. In the Project location field, enter a target location for the Forge project.
4. In the Stack list, click Java EE 7.
Click Finish.

Figure 1. Create a New Forge Project

Result: The project is listed in the Project Explorer view.

Set Up Persistence

Setting up the JPA prerequisites, creates the persistence.xml file in the project and adds the required dependencies to the pom.xml file.

Note: While creating the JPA entity, the Forge console automatically detects any prerequisites that must be set up and prompts you to create those at runtime.

To set up persistence:

Press Ctrl+4 to open the JBoss Forge context menu.
Click JPA: New Entity. The window is populated with default values.
Click Next to continue using the default values or edit the fields to change the values.
In the Configure your connection settings window, ensure that the fields display the appropriate values and then click Next.
In the Create a new JPA entity window:
1. In the Package Name field, type the package name.
2. In the Type Name field, type a name for the new entity.
Click Finish.

Result: The new entity appears in the JBoss editor and is also listed in the Project Explorer view with the name: {entity_name}.java.

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

Figure 2. {entity_name}.java Displayed in the JBoss Editor

Add Fields to the Entity

To add fields to the entity:

Press Ctrl+4 to open the JBoss Forge context menu.
Click JPA: New Field.
In the Create a new field window:
1. In the Target Entity field, select {package_name.model.entity}.
2. In the Field Name field, type FirstName.
Click Finish.

Figure 3. Add Field to the Entity
Repeat steps 1 through 4 to add more fields to the entity.

Result: The fields are added to the Customer.java file.

Create Scaffold

Scaffolding is automatic code generation by a program, using available information, usually a database to generate a basic CRUD (create, read, update, delete) admin interface. The Scaffold Generate command is used to create the scaffold.

To create the scaffold:

Press Ctrl+4 to open the JBoss Forge context menu.
Click Scaffold Generate.
In the Scaffold Type list, click Angular JS and then click Next.
If your project is not configured to use all the technologies that you want to use, Forge prompts you to set up the dependencies. Click Next.
In the Select JPA entities window:
1. Select the check box in the Targets field.
2. Select the Generate REST resources check box.
Click Finish.

Figure 4. Select JPA Entities to Create the Scaffold

Result: The entities are created and listed in the Project Explorer view.

Run and Test the Application

In this example we use the JBoss EAP server to run the application.

To run the application:

In the Project Explorer view, right-click the application and click Run As > Run on Server. Alternatively, drag and drop the application from the Project Explorer view to the JBoss EAP {version} server in the Servers view. The application opens in the default browser.
Click Customers and then click Create to create a new customer.
In the FirstName and the LastName fields, enter the first and last names and click Save. The customer is added to the application.

Use the Search for Customers section to search for customers by their first and/or last names.

Create Extensions/Add Ons

The add ons/extensions run inside the IDE. After adding commands and features to the add-on, no further changes are required for the extensions or add-ons to run in another IDE.

To create an add-on:

Press Ctrl+4 to open the JBoss Forge context menu.
Click Project:New.
In the Create a new project window:
1. In the Project name field, type a name for the add-on.
2. In the Project type list, click Forge Addon (JAR).
Click Next.
In the Furnace Addon Setup window, Depend on these addons section, Forge automatically selects the prerequisites. Review the dependencies and click Finish.
Press Ctrl+4 to open the Forge context menu.
Select Java: New Class to open the Java: New Class window.
In the Type Name field, type CustomCommand and click Finish. The CustomCommand.java file opens in the JBoss editor.
To change this Java class into a Forge command:
1. Press Ctrl+4 to open the Forge context menu.
2. Select Addon: New UI Command to open the Generates a UICommand implementation window.
3. In the Generates a UICommand implementation window:
  - In the Type Name field, type CustomCommand.
  - In the Command name field, type custom.
4. Click Finish.
  
  Figure 5. Add a Command
  
  The command is listed in the CustomerCommand.java file.
Press Ctrl+4 to open the Forge context menu.
Select Build and Install an Addon to open the Build and install a Forge addon window.
Click Finish to install the add-on into the IDE.

To execute the installed command:

Press Ctrl+4 to open the Forge context menu.
Select custom.

Add parameters to the method in order to add user input to the command. Copy and paste the following command in the CustomCommand.java file:

        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);
          }
         }

To rebuild and install:
1. In the Project Explorer view, click the created add-on.
2. Press Ctrl+4 to open the Forge context menu.
3. Select Build and Install an Addon.
4. Click Finish to install the add-on into the IDE.
5. Press Ctrl+4 to open the Forge context menu.
6. Click JIRA: Setup.

Figure 6. Add-on Listed in the Forge Context Menu

Result: The add-on is created and listed in the Forge context menu.

Did You Know

You can launch the Forge Console by clicking Window Show view Forge Console. The Forge Console view opens in an inactive state.
You can start JBoss Forge by clicking the `Start {JBoss Forge_version} ` button ).
To link the Forge Console output with the open editor, click the Link with Editor button ().

How To:

Develop Applications Using the Forge Tools