Importing a Maven Project in NetBeans

This tutorial explains how to import an existing Maven project into Apache NetBeans and how to associate Maven goals to IDE actions. This is useful, for example, when using the Jetty Maven plugin that allows you to quickly deploy and run a Java web application using this popular server.

Maven is a project management tool that goes beyond dependency management. See  Learning Maven Concepts for more.

Download an Existing Maven Project

This tutorial uses a Maven archetype that generates a Java web application with a preconfigured Jetty Maven Plugin in it:

mvn -B archetype:generate -DarchetypeGroupId=com.vaadin -DarchetypeArtifactId=vaadin-archetype-application -DarchetypeVersion=LATEST -DgroupId=org.test -DartifactId=webapp -Dversion=1.0-SNAPSHOT

If you prefer, you can generate a ZIP file with this project at https://vaadin.com/start/latest or https://start.vaadin.com. Make sure you select the Plain Java Servlet option before downloading the project.

The project should include a directory with a Maven project in it:

You need Node.js installed on your computer to compile the example application.

Import the Project

1. In NetBeans, select File > Open Project….
2. Select the directory corresponding to the Maven project, and click Open Project to complete the process:

Running Maven Goals

NetBeans has excellent integration with Maven. You can run common commands such as mvn clean or mvn jetty:run without having to leave the IDE.

When you select the project in the Projects view, NetBeans shows common Maven goals inside the Navigator view:

You can execute any of these goals by double-clicking them. For example, you can double-click the jetty run goal to run the web application implemented in the project you imported.

To stop the server, click the stop button in the Output view:

Binding Maven Goals to IDE Actions

Since using the jetty:run goal could be a frequent task during the development of a Java web application, you might prefer to bind this Maven goal to an IDE action.

Let’s associate the Run project action to the jetty:run Maven goal.

1. Right-click the project in the Projects view and select Properties.
2. In the Project Properties window, select Actions in the Categories tree.
3. Select the Run project option in the Actions list.
4. Type jetty:run in Execute Goals.
5. Click OK: If you are using Spring Boot, use the spring-boot:run goal.

Now, you can deploy and run the web application by clicking the run icon in the toolbar:

You can repeat the process to bind the jetty:run goal to the Debug project IDE action as well.

If you use the Vaadin project used in the tutorial, you can invoke the web application at http://localhost:8080.

That’s it. Now, you can use NetBeans to develop your Maven application! Happy coding!

Further Reading

My Experiences With Maven in IntelliJ IDEA and NetBeans IDE

[DZone Refcard] Essential NetBeans Platform