一． 概述

开始maven的hello world项目。

二． 编写pom

就像Make的Makefile， Ant的build.xml一样，Maven项目的核心是pom.xml。POM（Project Object Model）定义了项目的基本信息，用于描述项目如何构建，声明项目依赖，等等。

现在先为Hello World项目编写一个最简单的pom.xml。

首先创建一个名为hello-world的文件夹，在该文件夹中新建一个pom.xml的文件，文件内容如下：

<?xml version=”1.0” encoding=”UTF-8”?>  <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.juvenxu.mvnbook</grouId>  <artifactId>hello-world</artifactId>  <version>1.0-SNAPSHOT</version>  <name>Maven Hello World Project</name>
</project>

project 元素是所有pom.xml的根元素，它还声明了一些POM相关的命名空间及xsd元素，虽然这些属性不是必须的，但使用这些属性能够让第三方工具（如IDE中的XML编辑器）帮助我们快速编辑POM。

modelVersion指定了当前POM模型的版本，对于Maven2及Maven3来说，它只能是4.0.0。

groupId，artifactId和version三个元素定义了一个项目基本的坐标，在Maven的世界，任何的jar、pom或者war都是以基于这些基本的坐标进行区分的。groupId定义了项目属于哪个组，这个组往往和项目所在组织或公司关联。如com.googlecode.myapp或 com.mycom.myapp。artifactId定义了当前Maven项目在组中唯一的的ID，如myapp-util或myapp-domain等等。Version是定了项目的当前版本，如1.0-SHNAPSHOT。SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定的版本。

三． 编写主代码

项目主代码和测试代码不同，项目的主代码会被打包到最终的构建中（如jar）。

默认情况下，Maven假设项目主代码位于src/main/java目录。Maven会自动搜寻该目录找到项目主代码。一般来说，项目中Java类的包都应该基于项目的groupId和artifactId，这样更加清晰，更加符合逻辑，也方便搜索。

四． 编译源代码

在项目根目录下运行 mvn clean compile 可以执行项目的清理和编译任务。Maven会先执行clean:clean任务(clean插件的clean目标)，删除target/目录，默认情况下Maven构建的所有输出都在target/目录中；接着执行resources:resources任务；最后执行compiler:compile任务，将项目主代码编译至target/classes目录。

五． 编写测试代码

Maven项目中默认的测试代码目录是src/test/java。要使用Junit，需要在POM中添加相关依赖：

<dependencies>  <dependency>  <groupId>junit</groupId>  <artifactId>junit</artifactId>  <version>4.7</version>  <scope>test</scope>  </dependency>
</dependencies>

有了这段声明，Maven就能自动从中央仓库(http://repo1.maven.org/maven2)下载junit-4.7.jar了。

scope 指定了依赖范围。test表示该依赖只对测试有效（只有测试代码可以import JUnit）。scope默认值是compile表示对主代码和测试代码都有效。

六． 执行测试

mvn clean test 会执行clean:clean、resources:resources、compiler:compile、resources:testResources、compiler:testCompile以及surefire:test。 Maven会在执行test之前执行resources:resources、compiler:compile、resources:testResources以及compiler:testCompile。(项目主资源处理，主代码编译，测试资源处理，测试代码编译等工作)。

Maven的核心插件之一compiler插件默认只支持编译Java1.3，因此我们需要在POM中配置该插件使其支持Java 5。

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

测试代码通过编译之后会在target/test-classes下生成二进制文件。surefire是Maven世界中负责执行测试的插件。

七． 打包和运行

我们可以执行mvn clean package进行打包，如果不指定打包类型，使用默认的jar。jar:jar会将项目主代码的二进制文件夹打成包以artifact-version.jar的命名规范出现在target/输出目录中。

执行mvn clean install将项目输出的jar安装到Maven本地仓库中，在此之前会执行jar:jar，然后再执行install:install。

默认打包生成的jar是不能直接运行的，因为带有main方法的类信息不会添加到manifest中（打开jar文件中的META-INF/MANIFEST.MF文件，将无法看到Main-Class一行）。为了生成可执行的jar包，我们需要借助maven-shade-plugin，在POM中配置如下：

<plugin>  <groupId>org.apache.maven.plugins</groupId>  <artifactId>maven-shade-plugin</artifactId>  <version>1.2.1</version>  <executions>  <execution>  <phase>package</phase>  <goals>  <goal>shade</goal>  </goals>  <configuration>  <transformers>  <transformer implementation=”org.apache.maven.plugins.shade.resource.ManifestResourceTransformer”>            <mainClass>com.juvenxu.mvnbook.helloworld.HelloWorld</mainClass>  </transformer>  </transformers>  </configuration>  </executions>
</plugin>

八． 使用Archetype生成项目骨架

我们称项目的基本目录结构（主代码目录、测试代码目录等）和pom.xml文件内容为项目的骨架。我们可以用mvn archetype:generate来生成项目的骨架。该命令在Maven 2中是不安全的，因为它会自动下载最新的archetype插件版本，可能得到不稳定的SNAPSHOT版。然而在Maven 3中，即使用户没有指定版本，Maven也只会解析最新的稳定版本。Maven 2中建议使用
mvn org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-5:generate 
冒号的分隔格式为：groupId:artifactId:version:goal。 org.apache.maven.plugins是Maven官方插件的groupId。

创建普通java项目：

mvn archetype:create –DgroupId=com.heimar –DartifactId=JavaPro

创建web项目：

mvn archetype:create –DgroupId=com.heimar –DartifactId=WebPro –DarchetypeAtrifactId=mave-archetype=webapp

九． m2eclipse简单使用

1. 导入maven项目

2. 创建maven项目

3. 运行mvn命令