Maven使用基础

(转)https://my.oschina.net/xiaomaoandhong/blog/104045

基于 约定优于配置（Convention Over Configuration）的原则，无特殊需求，请遵守Maven以下约定：

Maven约定

目录src/main/java	java源码目录
目录src/main/resources	资源文件目录
目录src/test/java	测试java源码目录
目录src/test/resources	测试资源文件目录
目录target	打包输出目录
目录target/classes	编译输出目录
目录target/test-classes	测试编译输出目录
目录target/site	项目site输出目录
目录src/main/webapp	web应用文件目录（当打包为war时），如WEB-INF/web.xml
jar	默认打包格式
*Test.java	Maven只会自动运行符合该命名规则的测试类
%user_home%/.m2	Maven默认的本地仓库目录位置
中央仓库	Maven默认使用远程中央仓库：http://repo1.maven.org/maven2
1.3	Maven Compiler插件默认以1.3编译，因此需要额外配置支持1.5

其上所有的约定都可以在Maven的超级POM(super pom)中找到。由于所有的POM都继承了这个超级POM，因此它的默认配置就被继承了 。Maven3中这个超级POM位于libmaven-model-builder-3.0.4.jarorgapachemavenmodel下

一：编写POM

引用

<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.mycompany.app</groupId> 
  <artifactId>my-app</artifactId> 
  <version>1.0-SNAPSHOT</version> 
  <packaging>jar</packaging> 

  <name>my-app</name> 
  <url>http://maven.apache.org</url> 

  <properties> 
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
  </properties> 

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

1：project是所有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"> 

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

<modelVersion>4.0.0</modelVersion> 

根元素下的第一个子元素modelVersion指定了当前POM模型的版本，对于Maven2及Maven 3来说，它只能是4.0.0。

3：groupId，artifactId和version三行
pom.xml中最重要的是groupId，artifactId和version三行。这三个元素定义了一个项目基本的坐标，在Maven的世界，任何的jar、pom或者war都是以基于这些基本的坐标进行区分的。

3.1：groupId
定义了项目属于哪个组，这个组往往和项目所在的组织或公司存在关联，譬如你的公司是mycom，有一个项目为myapp，那么groupId就应该是com.mycom.myapp。

3.2：artifactId
定义了当前Maven项目在组中唯一的ID，在前面的groupId为com.mycompany.app的例子中，你可能会为不同的子项目（模 块）分配artifactId，如：myapp-util、myapp-domain、myapp-web等等。本例中artifactId 为 my-app

3.3：version
顾名思义，version指定了项目当前的版本。

引用

<version>1.0-SNAPSHOT</version>

SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定的版本。随着项目的发展，version会不断更新，如升级为1.1- SNAPSHOT、1.0、1.1、2.0等等。本书的6.5小节会详细介绍SNAPSHOT，第13章介绍如何使用Maven管理项目版本的升级发布。

4：name元素
声明了一个对于用户更为友好的项目名称，虽然这不是必须的，但我还是推荐为每个POM声明name，以方便信息交流。 

下面不借助于IDE环境的支持，完全以手动配置的方式来说一下Maven的一个入门的小示例

1、创建HelloMaven项目
首先创建一个名为HelloMaven项目的文件夹，在该项目的根目录下建立一个pom.xml文件，该文件是Maven项目的核心， 就像Make的Makefile，Ant的build.xml一样 。POM（Project Object Model，项目对象模型）定义了项目的基本信息，用于描述项目如何构建，声明项目依赖，等等。

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/xsd/maven-4.0.0.xsd">
  <!--
      modelVersion指定当前pom模型的版本，
      对于Maven2及Maven3来说，它只能是4.0.0
  -->
  <modelVersion>4.0.0</modelVersion>
  <!--
      groupId，artifactId和version这三个元素定义了一个项目基本的坐标,
      在Maven的世界，任何的jar、pom或者war都是以基于这些基本的坐标进行区分
  -->
  <!--
    groupId定义了项目属于哪个组，这个组往往和项目所在的组织或公司存在关联
  -->
  <groupId>org.apache.maven</groupId>
  <!--
    artifactId定义了当前Maven项目在组中唯一的ID
  -->
  <artifactId>hellomaven</artifactId>
  <!--
    项目当前版本，SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定的版本
  -->
  <version>1.0-SNAPSHOT</version>

  <name>HelloMaven Project</name>
</project>

2、编写项目的主代码HelloMaven.java
基于Maven的约定，我们在HelloMaven目录下创建 srcmainjavaHelloMaven.java，Maven会自动搜索该srcmainjava目录找到HelloMaven.java

package org.apache.maven.hellomaven;
/**
 *一般来说，项目中Java类的包都应该基于项目的groupId和artifactId
 */
public class HelloMaven {
    public String sayHello() {
        return "Hello Maven";
    }

    public static void main(String[] args) {
        System.out.println(new HelloMaven().sayHello());
    }
}

3、编译
新开一个cmd窗口，在项目根目录下使用Maven命令 mvn clean compile编译该源文件HelloMaven.java，clean告诉Maven清理输出目录target/，compile告诉Maven编译项目主代码

编译成功之后这时我们发现根目录下除了src和pom.xml，还多了个target目录， 默认情况下Maven构建的所有输出都在target目录中 ，项目的主代码位于target/classes。


查看target目录


4、测试
遵照上面Maven的约定，测试代码目录是src/test/java。因此，在编写测试用例之前，我们先创建该目录。

在HelloMavensrc estjava下编写测试类HelloMavenTest.java

package org.apache.maven.hellomaven;
import static org.junit.Assert.assertEquals;
import org.junit.Test;

public class HelloMavenTest    
{    
    @Test
    public void testSayHello()     
    {    
        HelloMaven hellomaven = new HelloMaven();    
        String result = hellomaven.sayHello();    
        assertEquals("Hello Maven", result );     
    }    
}

JUnit是事实上的单元测试标准。要使用JUnit，我们首先需要为HelloMaven项目添加一个JUnit依赖，修改项目的POM文件，添加junit依赖

<dependencies>
      <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>4.7</version>
          <!--
            依赖范围为test 则表示该依赖只对测试有效
          -->
          <scope>test</scope>
      </dependency>
  </dependencies>

前面说到groupId、artifactId和version是任何一个Maven项目最基本的坐标，JUnit也不例外，有了这段声明，Maven就能够自动从其中央仓库下载junit-4.7.jar到本地仓库。

调用Maven执行测试，运行 mvn clean test  

测试代码通过编译之后在target/test-classes下生成了二进制文件，紧接着surefire:test 任务运行测试，surefire 是Maven世界中负责执行测试的插件，这里它运行测试用例HelloMavenTest，并且输出测试报告，显示一共运行了多少测试，失败了多少，出错 了多少，跳过了多少。

5、打包
HelloMaven的POM中没有指定打包类型，使用 默认打包类型jar，简单地执行命令 mvn clean package进行打包

类似地，Maven会在打包之前执行编译、测试等操作。该jar文件hellomaven-1.0-SNAPSHOT.jar同样位于target输出目录中

我们可以复制这个jar到其它项目的classpath路径下从而使用HelloMaven类，但是要 让其他的Maven项目直接引用这个jar，还需要一个安装的步骤：mvn clean install，将这个jar文件安装到本地仓库中，就如前面的junit一样，只有被下载到本地仓库之后才能被其它Maven项目所引用。



已经接触了如下的Maven命令：
mvn clean compile、mvn clean test、mvn clean package、mvn clean install
执行test 之前是会先执行compile的，执行package之前是会先执行test 的，而类似地，install 之前会执
行package。

6、运行
默认打包生成的jar是不能够直接运行的，如：

因为带有main方法的类信息不会添加到manifest中
(
我们可以打开jar文件中的 META-INF/MANIFEST.MF 文件，将无法看到Main-Class一行

如：

Manifest-Version: 1.0
Archiver-Version: Plexus Archiver
Created-By: Apache Maven
Built-By: yanghong.zhou
Build-Jdk: 1.6.0_10-rc2

为了生成可执行的jar 文件，我们需要借助maven-shade-plugin，配置该插件如下：

<build>
    <plugins>
      <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>
                      org.apache.maven.hellomaven.HelloMaven
                    </mainClass>    
                  </transformer>    
                </transformers>    
              </configuration>    
            </execution>    
        </executions>    
      </plugin> 
    </plugins>
  </build>

现在执行 mvn clean package:
待构建完成之后打 开target/目录 ，我们可以看到
hellomaven-1.0-SNAPSHOT.jar 和original-hellomaven-1.0-SNAPSHOT.jar，前者是带有Main-Class信息的可运行jar，后者是原始的jar，打开 hellomaven-1.0-SNAPSHOT.jar 的META-INF/MANIFEST.MF，可以看到它包含这样一行信息： Main-Class: org.apache.maven.hellomaven.HelloMaven


run:

附录:

Dependency Scope

在POM 4中，<dependency>中还引入了<scope>，它主要管理依赖的部署。目前<scope>可以使用5个值：

• compile，缺省值，适用于所有阶段，会随着项目一起发布。
• provided，类似compile，期望JDK、容器或使用者会提供这个依赖。如servlet.jar。
• runtime，只在运行时使用，如JDBC驱动，适用运行和测试阶段。
• test，只在测试时使用，用于编译和运行测试代码。不会随项目发布。
• system，类似provided，需要显式提供包含依赖的jar，Maven不会在Repository中查找它。 

如下代码：

<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.sitinspring</groupId>
  <artifactId>Maevn3ndPart</artifactId>
  <packaging>jar</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>Maevn3ndPart</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>jdom</groupId>
      <artifactId>jdom</artifactId>
      <version>1.0</version>
      <scope>compile</scope>
    </dependency>
  </dependencies>
</project>