How to Create a Simple Maven Project in Eclipse

In this article, we will show you how to create a simple maven project in Eclipse IDE.
We can also create a simple maven project using the command line, check out the same at Create a Simple Maven Project using Command-Line.

Tools and technologies used

• Eclipse Neon
• Maven – 3.5.3
• JDK – 1.8

Let’s create step by step a simple maven project in Eclipse IDE.

Step-1

• Open Eclipse

• Click on File -> New -> Maven Project

Step-2

Click on Checkbox for both

• Create a simple project
• Use default Workspace location
• Click on next button 

Step-3

Provide GroupId and ArtifactId in next screen.

• GroupId: com.favtuts.maven-demo
• Artifact Id: maven-demo-project
• Name: maven-demo-project
• Description: Simple Maven Demo Project

Step-4

And you are all set. You should see a new Project in Eclipse with below structure.

Step-5

As you can see in the maven project structure, the default java compiler version ( i.e. source and target setting ) is 1.5. To change the default settings, add the following snippet to pom.xml.

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.6.0</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

After changes in pom.xml file, update the maven project. To update maven project right click on maven-project → Maven → Update Project.

Step-6

Add some dependencies to pom.xml file. Here we are adding junit dependency to pom.xml.

<project
    xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.favtuts.maven-demo</groupId>
    <artifactId>maven-demo-project</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <description>Simple Maven Demo Project</description>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.6.0</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Let’s test our created project by creating a simple JUnit test.

Step-7

Create a package, named as com.favtuts.simpleproject, under src/test/java folder. Now create a class AppTest.java under src/test/java package and write the following code in it.

package com.favtuts.simpleproject;

import org.junit.Assert;
import org.junit.Test;

public class AppTest {
    @Test
    public void test() {
        Assert.assertEquals("Hello Maven", new String("Hello Maven"));
    }
}

Step-8

Run your first maven project. Right click on AppTest.java → Run as → JUnit Test.

Download Source Code

$ git clone https://github.com/favtuts/java-maven-tutorials.git
$ cd maven-eclipse-simple-project
$ mvn test

References

• Create a Simple Maven Project using Command Line