Maven项目管理

maven快速入门

Maven是基于项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建、报告和文档的软件项目管理工具。

maven安装配置

下载好maven后，需要配置环境变量。

设置JAVA_HOME：D:\program files\Java\jdk1.8.0_91, path添加%JAVA_HOME%\bin
新建M2_HOME,指向maven安装目录：D:\app\apache-maven-3.3.9
修改path，添加%M2_HOME%\bin
在命令行中输入mvn -v看看是否输出正确。

maven helloworld案例

maven目录结构结构

src
    -main
        -java
            -package
    -test
        -java
            -package
    -resources

按照上面的目录结构创建目录，package目录先不要创建package。

分别新建

package lx.maven.model;

public class HelloWorld{
    public String sayHello() {
        return "Helo world!";
    }
}

和测试

package lx.maven.model;

import org.junit.*;
import org.junit.Assert.*;

public class HelloWorldTest{
    @Test
    public void testHello() {
        Assert.assertEquals("Hello world!", new HelloWorld().sayHello());
    }
}

这里需要注意的是分别新建包。

然后需要新建pom.xml，保存在项目根目录下。



    4.0.0

    lx.maven
    maven01
    1.0-SNAPSHOT

    
        
            junit
            junit
            4.10

说明：

modelVersion:固定，不管
groupId 项目的包名
artifactId 模块名
version 版本，SNAPSHOT快照版本

编译：mvn compile
运行测试用例：mvn test

运行后我们看到项目更目录下创建了target文件夹，这个文件夹下面又有几个子文件夹，分别是：

classes 生成的类文件字节码
surefire-reports 测试报告

然后运行mvn package进行打包。打好的包在target根目录下。

Maven核心知识

常用的构建命令

之前我们已经学习了以下命令：

mvn -v:查看maven版本
mvn compile: 编译
mvn test: 测试
mvn package:打包

本节主要学习以下两个命令：

mvn clean: 删除target
mvn install: 安装jar包到本地仓库中

我们新建一个项目maven02

package lx.maven02.util;

import lx.maven.model.HelloWorld;

public class Speak{
    public String sayHi() {
        return new HelloWorld().sayHello();
    }
}

package lx.maven02.util;

import org.junit.*;
import org.junit.Assert.*;

public class SpeakTest{
    @Test
    public void testsayHi() {
        Assert.assertEquals("Hello world!", new Speak().sayHi());
    }
}



    4.0.0

    lx.maven02
    maven02-util
    1.0-SNAPSHOT

    
        
            junit
            junit
            4.10

此时运行mvn compile会报错，表示找不到对应的lx.maven.model包。之所以会这样是因为我们需要讲maven01的项目运行mvn install先安装到本地仓库，然后在maven02项目中添加依赖：


    lx.maven
    maven01
    1.0-SNAPSHOT

自动建立目录骨架

之前一直手动创建很麻烦，maven提供了archetype插件，用于创建符合maven规定的目录骨架。

我们先创建一个项目目录maven03，然后在命令行输入：

mvn archetype:generate

然后会让我们选择archetype版本，选择最大的就好了，然后要求我们输入groupId，我们输入lx.maven03，artifactId我们输入maven03-service，version我们输入1.0-SNAPSHOT.然后会要求我们输入包名，不过会根据你之前输入的groupId自动提供一个，我们直接回车就可以了。最后会让我们确认信息，没问题就回车。

还有一种方法是一次性设置所有参数：

mvn archetype:generate -DgroupId=lx.maven03 -DartifactId=maven04-demo -Dversion=1.0SNAPSHOT -Dpackage=lx.maven03.demo

maven中的坐标和仓库

坐标：构件的唯一标识。groupId,artifactId,version构成了坐标的基本要素。

仓库：管理项目依赖，分为两种：

本地仓库
远程仓库：如果本地仓库找不到，会到maven的全球仓库去找。

镜像仓库：打开maven/conf/settings.xml文件，在mirrors节添加：


     maven.oschina.net
     central
     oschina maven mirror
      http://maven.oschina.net/content/groups/public

mirrorOf表示为哪个仓库指定镜像，默认是central，也可以使用*通配符。

现在看如何修改仓库位置：
默认情况下，仓库是在用户文件夹下的.m2文件中，我们可以修改settings.xml的settings下的位置：

D:/mavenrepo

然后将settings.xml文件复制到d:/mavenrepo下，这样以后要是修改maven版本就不用再次修改settings.xml.

maven的声明周期和插件

完整的项目构建过程包括：
清理、编译、测试、打包、集成测试、验证、部署
clean\compile\test\package\install
maven声明周期：

clean 清理项目
default 构建项目
site 生成项目站点

对于clean清理项目

pre-clean 执行清理前的工作
clean 清理上一次构建生成的所有文件
post-clean 执行清理后的文件

default构建项目（最核心）
compile test package install都属于default阶段

site生成项目站点

pre-site
site
post-site
site-deploy

现在加入我们要添加插件source，让打包时同时打包源码。我们修改pom.xml，加入：


    
        
            org.apache.maven.plugins
            maven-source-plugin
            3.0.0
            
                
                    package
                    
                        jar-no-fork

说明：

plugin的phase表明阶段
goal表示目标

具体请看apache官方文档。

然后运行mvn clean package看到会生成源码的jar包。

pom.xml常用元素介绍

pom.xml用于项目描述、组织管理、依赖管理和项目信息的管理。下面我们来介绍一下常用元素。



    
    4.0.0
    
    
    
    
    
    0.0.1-SNAPSHOT
    
    jar

    
    hi
    
    
    
    
    
    
    
    
    
    

    
    
        
            junit
            junit
            3.8.1
            
            
            test

依赖范围

之前已经见过junit依赖：


  junit
  junit
  3.8.1
  test

我们平时在开发时，如果要使用某个框架就需要将该框架的jar包添加到项目的classpath中，maven为我们提供了3种classpath，分别是：

编译
测试
运行

所以scope就是用来指定依赖范围的。maven官方文档上说scope有六种取值：

compile:编译，默认的范围，编译测试运行都有效
provided:测试和编译时有效，运行时不会用
runtime:测试和运行时有效
test:测试，只在测试时有效
system:测试和编译时有效,可移植性差，与本机想关联
import：导入的范围，只使用在dependencyManagement中，表示从其他的pom中导入dependency的配置

依赖传递

A依赖B，B依赖C，则就可以说A间接依赖C。

首先，我们在B中引入对C的依赖(C应该mvn compile install).


    junit
    junit
    3.8.1
    
    
    test

有时我们需要指定JDK默认版本，在settings.xml中的profile配置版本。

依赖冲突

短路优先
A->B-C-X(jar)和A->D->X(jar)，则A优先引用D所指向的X。
先声明先优先
如果路径长度相同，则谁先声明，先解析谁。

聚合和继承

先来说聚合。

如果有多个项目，A\B\C，我们想要把他们聚合起来，一起安装，我们新建一个项目D，修改它的pom.xml:


    ../A
    ../B
    ../C

然后运行mvn clean install就能直接安装A/B/C了。

再来说继承。
在父pom中添加：


pom

    
    3.8.1


    
        
            junit
            junit
            ${junit.version}

在子POM中使用：

使用maven构建web项目

我们使用maven创建一个web项目，然后发布到jetty中。

使用IDEA创建一个maven项目，选择maven-archetype-webapp类型，GroupId输入lx.webdemo，artifectId输入webdemo。
在http://mvnrepository.com/ 中添加
我们打开pom.xml，添加Java Servlet API依赖，注意，servlet的f范围是provided：



    4.0.0

    lx.webdemo
    webdemo
    1.0-SNAPSHOT
    war

    
        
            junit
            junit
            4.12
            test
        
        
            javax.servlet
            javax.servlet-api
            3.1.0
            
            provided

然后添加Jetty maven plugin


  4.0.0
  lx.webdemo
  webdemo
  war
  1.0-SNAPSHOT
  webdemo Maven Webapp
  http://maven.apache.org
  
    
      junit
      junit
      3.8.1
      test
    
      
          javax.servlet
          javax.servlet-api
          3.1.0
      
  
  
    webdemo
      
          
              org.eclipse.jetty
              jetty-server
              9.4.0.M0
              
                  
                      package
                      
                          run

然后运行mvn clean package即可。