第三章 Maven 使用入门

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

 

2.  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。

 

3.  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意为快照，说明该项目还处于开发中，是不稳定的版本。

 

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

 

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

 

6.  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表示对主代码和测试代码都有效。

 

7.  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。(项目主资源处理，主代码编译，测试资源处理，测试代码编译等工作)

 

8.  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>

 

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

 

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

 

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

 

12.  执行test之前会先执行compile， 执行package之前会先执行test，执行install之前会先执行package。

 

13.  为了生成可执行的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>

 

14.  我们称项目的基本目录结构（主代码目录、测试代码目录等）和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。