Hello Maven

Main Learning's

• Download and install Maven
• Set up the required Maven System Variables
• Verify that the Maven is properly installed
• Create, Compile and package a HelloMaven project

Versions used:

• OS: Windows XP V1.6
• JDK version 1.6.0_3
• Maven version 2.0.8

Assumptions:

 

 

The JDK is properly installed

Tutorial Steps:

1. Go to the Maven download page at: http://maven.apache.org/download.html

    

2. Download maven binary distribution file – e.g. apache-maven-2.0.8-bin.zip

    

3. Unzip and install maven (e.g. C:\Program Files\Apache Software Foundation\apache-maven-2.0.8)

    

4. Set the MAVEN_HOME environment variable to the directory where you installed Maven.

    

   1. On Windows: Systems Properties/ Advanced/ Environment Variables / System Variables/ New
   2. 
   3. 

       

5. Add the Maven bin directory to your path.
   1. 
   2. 

       

6. Make sure the jdk is properly installed  – Maven uses Java, therefore the JDK must be properly installed.

    

7. Make sure maven is working.

    

   1. Open a command prompt and execute mvn  –help
   2. 

       

8. Create a folder for your hello world maven project – e.g. C:\codebase\sample\hellomaven

    

9. on the hellomaven/ folder, execute the following command:

    

   • mvn archetype:create -DarchetypeGroupId=org.apache.maven.archetypes -DgroupId=com.mypackage -DartifactId=my-hellomaven

      

10. You should get the results as depicted in the following picture
    1. 

        

11. A package structure and files have been created for your project:
    1. 

        

12. A directory named my-hellomaven has been created for the new project, and this directory contains a file named pom.xml, that should look like this:

    1.  <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/maven-v4_0_0.xsd">

        

           <modelVersion>4.0.0</modelVersion>

        

           <groupId>com.mypackage</groupId>

        

           <artifactId>my-hellomaven</artifactId>

        

           <packaging>jar</packaging>

        

           <version>1.0-SNAPSHOT</version>

        

           <name>my-hellomaven</name>

        

           <url>http://maven.apache.org</url>

        

           <dependencies>

        

             <dependency>

        

               <groupId>junit</groupId>

        

               <artifactId>junit</artifactId>

        

               <version>3.8.1</version>

        

               <scope>test</scope>

        

             </dependency>

        

           </dependencies>

        

         </project> 

        

        

13. Compile your project

     

    1. From the my-hellomaven folder, execute the following command:

        

    • mvn compile
    • 

       

14. Now try running your project tests by executing:

     

    • mvn test
    • 

       

15. For creating a jar file, execute
    • mvn package
    • 

       

16. Check out the generated contents at my-hellomaven/target folder.
    1. 

        

17. Generating Integrated Development Environment (IDE) Project files

            To generate the files needed for an IntelliJ IDEA Project setup, you only need to execute the main plugin goal, which is idea:idea like so:

		mvn idea:idea

             Similarly, To generate the files needed for an Eclipse Project setup, you only need to execute the main plugin goal, which is eclipse:eclipse like so:

		mvn eclipse:eclipse