本文共 18773 字，大约阅读时间需要 62 分钟。

Maven 是每一位Java工程师每天都会接触的工具, 但据我所知其实很多人对Maven理解的并不深, 只把它当做一个依赖管理工具(下载依赖、打包), Maven很多核心的功能反而没用上. 最近重读 Maven实战, 虽然这本书年岁较老(10年出版: 那还是Hudson年代), 但绝大部分还是很值得参考的. 本文讲述Maven的核心原理和概念, 因此还是大纲参考了这本书, 但细节大多参考的Maven的官方文档以及网友释出的博客. 本文主要讲解Maven的:

• 坐标与依赖、
• 仓库、
• 生命周期与插件、
• 模块聚合、
• 模块继承

等概念, 并通过一个开发Maven插件的实例来深入了解Maven的核心机制. 而对于 如何配置Maven、Nexus私服、Jenkins持续集成、Maven测试、构建Web、资源过滤、自定义Archetype 等相对简单、讲解繁琐且网上有大量实践案例的内容没有涉及. 本文的目标是希望读者能够通过本文能对Maven核心原理有个相对深入的理解.

---

坐标与依赖

为了能够自动化地解析任何一个Java构件, Maven必须将它们唯一标识, 这就是依赖管理的底层基础-坐标.

---

坐标

在数学中, 任何一个坐标可以唯一确定一个“点”.

Maven 坐标为Java构件引入了秩序, 任何一个构件都必须明确定义自己的坐标, 坐标元素包括groupId、artifactId、version、packaging、classfier:

   
    org.apache.commons
   
   
    commons-lang3
   
   
    3.4
   
   
    jar
   

---

依赖

Maven最著名的(也是几乎每个人最先接触到的)就是Maven的依赖管理, 它使得我们不必再到开源项目的官网一个个下载开源组件, 然后再一个个放入classpath. 一个依赖声明可以包含如下元素:

       
    
     org.springframework
        
    
     spring-web
        
    
     4.2.7.RELEASE
        
    
     jar
        
    
     compile
        
    
     false
        
            
                 
      
       log4j
                  
      
       log4j
              
         
    
   

• 依赖传递

  Maven依赖传递机制会自动加载我们引入的依赖包的依赖, 而不必去手动指定(好拗口(⊙﹏⊙)b : This allows you to avoid needing to discover and specify the libraries that your own dependencies require, and including them automatically).
  如: 我们的项目依赖了spring-core, 而spring-core又依赖了commons-logging:
  
  有了依赖传递机制, 在项目中添加了spring-core依赖时就不用再去考虑它依赖了什么, 也不用担心引入多余的依赖. Maven会解析各个直接依赖的POM, 将必要的间接依赖以传递性依赖的形式引入到当前目录中(inherits from its parents, or from its dependencies, and so on).
  (依赖调节原则: 1. 路径最近者优先; 2. 第一声明者优先.)
  更多传递依赖信息可参考: .

• 声明一个或者多个项目依赖, 可以包含的元素有:

• 依赖管理
  Maven提供了dependency插件可以对Maven项目依赖查看以及优化, 如$ mvn dependency:tree可以查看当前项目的依赖树, 详见$ mvn dependency:help.

---

Maven 仓库

Maven 中, 任何一个依赖、插件或项目构建的输出, 都可称为构件, 而Maven仓库就是集中存储这些构件的地方.

---

两类仓库

Maven仓库可简单分成两类: 本地仓库与远程仓库. 当Maven根据坐标寻找构件时, 它会首先检索本地仓库, 如果本地存在则直接使用, 否则去远程仓库下载.

• 本地仓库: 默认地址为~/.m2/, 一个构件只有在本地仓库存在之后, 才能由Maven项目使用.
• 远程仓库: 远程仓库又可简单分成两类: 中央仓库和私服.
  • 由于原始的本地仓库是空的, Maven必须至少知道一个远程仓库才能在执行命令时下载需要的构件, 中央仓库就是这样一个默认的远程仓库.

关于仓库的详细配置可参考: 的 Servers、Mirrors、Profiles 等章节.

---

私服

私服是一种特殊的远程仓库, 它设在局域网内, 通过代理广域网上的远程仓库, 供局域网内的Maven用户使用.

当需要下载构件时, Maven客户端先向私服请求, 如果私服不存在该构件, 则从外部的远程仓库下载, 并缓存在私服上, 再为客户提供下载服务. 此外, 一些无法从外部仓库下载到的构建也能从本地上传到私服供大家使用(如公司内部二方包、Oracle的JDBC启动等). 为了节省带宽和时间, 一般在公司内部都会架设一台Maven私服, 但将公司内部项目部署到私服还需要对POM做如下配置:

   
        ...    
            
                 
      
       releases
                  
      
       http://mvn.server.com/nexus/content/repositories/releases/
              
             
                 
      
       snapshots
                  
      
       http://mvn.server.com/nexus/content/repositories/snapshots/
              
         
    
   

• repository表示发布版本构件的仓库, snapshotRepository代表快照版本的仓库.
• id为该远程仓库唯一标识, url表示该仓库地址.

配置正确后, 执行$ mvn clean deploy则可以将项目构建输出的构件部署到对应配置的远程仓库.

注: 往远程仓库部署构件时, 往往需要认证: 需要在settings.xml中创建servers元素, 其id与仓库的id匹配, 详见: .

---

仓库搜索

• 推荐几个可用的Maven仓库搜索服务:
  • MVNrepository:
  • Sonatype Nexus:

---

生命周期与插件

Maven 将所有项目的构建过程统一抽象成一套生命周期: 项目的清理、初始化、编译、测试、打包、集成测试、验证、部署和站点生成 … 几乎所有项目的构建,都能映射到这一组生命周期上. 但生命周期是抽象的(Maven的生命周期本身是不做任何实际工作), 任务执行(如编译源代码)均交由插件完成. 其中每个构建步骤都可以绑定一个或多个插件的目标,而且Maven为大多数构建步骤都编写并绑定了默认插件.当用户有特殊需要的时候, 也可以配置插件定制构建行为, 甚至自己编写插件.

---

生命周期

Maven 拥有三套相互独立的生命周期: clean、default 和 site, 而每个生命周期包含一些phase阶段, 阶段是有顺序的, 并且后面的阶段依赖于前面的阶段. 而三套生命周期相互之间却并没有前后依赖关系, 即调用site周期内的某个phase阶段并不会对clean产生任何影响.

• clean

  clean生命周期的目的是清理项目:
  
  执行如$ mvn clean;

• default

  default生命周期定义了真正构建时所需要执行的所有步骤:
  
  执行如$ mvn clean install;

• site

  site生命周期的目的是建立和发布项目站点: Maven能够基于POM所包含的信息,自动生成一个友好的站点,方便团队交流和发布项目信息
  
  执行命令如$ mvn clean deploy site-deploy;

更多 Maven 生命周期介绍可以参考: 、.

---

插件

生命周期的阶段phase与插件的目标goal相互绑定, 用以完成实际的构建任务. 而对于插件本身, 为了能够复用代码,它往往能够完成多个任务, 这些功能聚集在一个插件里,每个功能就是一个目标.

如:$ mvn compiler:compile: 冒号前是插件前缀, 后面是该插件目标(即: maven-compiler-plugin的compile目标). 而该目标绑定了default生命周期的compile阶段: 因此, 他们的绑定能够实现项目编译的目的.

---

内置绑定

为了能让用户几乎不用任何配置就能使用Maven构建项目, Maven 默认为一些核心的生命周期绑定了插件目标, 当用户通过命令调用生命周期阶段时, 对应的插件目标就会执行相应的逻辑.

• clean生命周期阶段绑定

• default声明周期阶段绑定

注: 上表只列出了打包方式为jar且拥有插件绑定关系的阶段, 其他打包类型生命周期的默认绑定关系可参考: 、.

• site生命周期阶段绑定

---

自定义绑定

除了内置绑定以外, 用户还能够自定义将某个插件目标绑定到生命周期的某个阶段上. 如创建项目的源码包, maven-source-plugin插件的jar-no-fork目标能够将项目的主代码打包成jar文件, 可以将其绑定到verify阶段上:

       
            
                 
      
       org.apache.maven.plugins
                  
      
       maven-source-plugin
                  
      
       3.0.0
                  
                      
                           
        
         attach-sources
                            
        
         verify
                            
         
         
          jar-no-fork
          
                        
                   
              
         
    
   

• executions下每个execution子元素可以用来配置执行一个任务.

关于Maven插件的自定义绑定及其他详细配置可参考: .

---

插件查询

• 在线
  • Maven 官方插件
  • CodeHaus 插件
• maven-help-plugin

mvn help:describe -Dplugin=org.apache.maven.plugins:maven-source-plugin[:3.0.0] [-Ddetail] [-Dgoal=jar-no-fork]

---

聚合与继承

Maven的聚合特性(aggregation)能够使项目的多个模块聚合在一起构建, 而继承特性(inheritance)能够帮助抽取各模块相同的依赖、插件等配置,在简化模块配置的同时, 保持各模块一致.

---

模块聚合

随着项目越来越复杂(需要解决的问题越来越多、功能越来越重), 我们更倾向于将一个项目划分几个模块并行开发, 如: 将feedcenter-push项目划分为client、core和web三个模块, 而我们又想一次构建所有模块, 而不是针对各模块分别执行$ mvn命令. 于是就有了Maven的模块聚合 -> 将feedcenter-push作为聚合模块将其他模块聚集到一起构建:

• 聚合POM
  聚合模块POM仅仅是帮助聚合其他模块构建的工具, 本身并无实质内容:

       
    
     4.0.0
        
    
     com.vdian.feedcenter
        
    
     feedcenter-push
        
    
     pom
        
    
     1.0.0.SNAPSHOT
        
            
     
      feedcenter-push-client
             
     
      feedcenter-push-core
             
     
      feedcenter-push-web
         
    
   

• 通过在一个打包方式为pom的Maven项目中声明任意数量的module以实现模块聚合:
  1. packaging: pom, 否则无法聚合构建.
  2. modules: 实现聚合的核心,module值为被聚合模块相对于聚合POM的相对路径, 每个被聚合模块下还各自包含有pom.xml、src/main/java、src/test/java等内容, 离开聚合POM也能够独立构建(注: 模块所处目录最好与其artifactId一致).

Tips: 推荐将聚合POM放在项目目录的最顶层, 其他模块作为聚合模块的子目录.

其他关于聚合与反应堆介绍可参考: .

---

模块继承

在面向对象中, 可以通过类继承实现复用. 在Maven中同样也可以创建POM的父子结构, 通过在父POM中声明一些配置供子POM继承来实现复用与消除重复:

---

1. 父POM

与聚合类似, 父POM的打包方式也是pom, 因此可以继续复用聚合模块的POM(这也是在开发中常用的方式):

       
    
     4.0.0
        
    
     com.vdian.feedcenter
        
    
     feedcenter-push
        
    
     pom
        
    
     1.0.0.SNAPSHOT
        
            
     
      feedcenter-push-client
             
     
      feedcenter-push-core
             
     
      feedcenter-push-web
         
        
            
     
      feedcenter-push
             
     
      ${finalName}.war
             
     
      4.0.6.RELEASE
             
     
      4.12
             
     
      UTF-8
             
     
      exploded/${warName}
         
        
            
                 
                      
       
        org.springframework
                       
       
        spring-core
                       
       
        ${spring.version}
                   
                  
                      
       
        org.springframework
                       
       
        spring-beans
                       
       
        ${spring.version}
                   
                  
                      
       
        org.springframework
                       
       
        spring-context
                       
       
        ${spring.version}
                   
                 
                      
       
        junit
                       
       
        junit
                       
       
        ${junit.version}
                       
       
        test
                   
              
         
        
            
                 
                      
                           
        
         org.apache.maven.plugins
                            
        
         maven-source-plugin
                            
        
         3.0.0
                            
         
          
          
           attach-sources
           
          
           verify
           
           
           
            jar-no-fork
            
           
          
                        
                   
              
         
    
   

• dependencyManagement: 能让子POM继承父POM的配置的同时, 又能够保证子模块的灵活性: 在父POMdependencyManagement元素配置的依赖声明不会实际引入子模块中, 但能够约束子模块dependencies下的依赖的使用(子模块只需配置groupId与artifactId, 见下).
• pluginManagement: 与dependencyManagement类似, 配置的插件不会造成实际插件的调用行为, 只有当子POM中配置了相关plugin元素, 才会影响实际的插件行为.

---

2. 子POM

   
       
            
     
      com.vdian.feedcenter
             
     
      feedcenter-push
             
     
      1.0.0.SNAPSHOT
         
        
    
     4.0.0
        
    
     feedcenter-push-client
        
            
                 
      
       org.springframework
                  
      
       spring-core
              
             
                 
      
       org.springframework
                  
      
       spring-context
              
             
                 
      
       org.springframework
                  
      
       spring-beans
              
             
                 
      
       junit
                  
      
       junit
              
         
        
            
                 
                      
       
        org.apache.maven.plugins
                       
       
        maven-source-plugin
                   
                  
                      
       
        org.apache.maven.plugins
                       
       
        maven-compiler-plugin
                   
              
         
    
   

• 元素继承

  可以看到, 子POM中并未定义模块groupId与version, 这是因为子POM默认会从父POM继承了如下元素:

• groupId、version
• dependencies
• developers and contributors
• plugin lists (including reports)
• plugin executions with matching ids
• plugin configuration
• resources
  因此所有的springframework都省去了version、junit还省去了scope, 而且插件还省去了executions与configuration配置, 因为完整的声明已经包含在父POM中.

• 优势: 当依赖、插件的版本、配置等信息在父POM中声明之后, 子模块在使用时就无须声明这些信息, 也就不会出现多个子模块使用的依赖版本不一致的情况, 也就降低了依赖冲突的几率. 另外如果子模块不显式声明依赖与插件的使用, 即使已经在父POM的dependencyManagement、pluginManagement中配置了, 也不会产生实际的效果.

• 推荐: 模块继承与模块聚合同时进行,这意味着, 你可以为你的所有模块指定一个父工程, 同时父工程中可以指定其余的Maven模块作为它的聚合模块. 但需要遵循以下三条规则:

• 在所有子POM中指定它们的父POM;
• 将父POM的packaging值设为pom;
• 在父POM中指定子模块/子POM的目录.

注: parent元素内还包含一个relativePath元素, 用于指定父POM的相对路径, 默认../pom.xml.

---

超级pom-约定优先于配置

任何一个Maven项目都隐式地继承自超级POM, 因此超级POM的大量配置都会被所有的Maven项目继承, 这些配置也成为了Maven所提倡的约定.

   
     
    
     4.0.0
      
      
        
           
      
       central
            
      
       Central Repository
            
      
       https://repo.maven.apache.org/maven2
            
      
       default
            
              
       
        false
             
          
       
      
        
           
      
       central
            
      
       Central Repository
            
      
       https://repo.maven.apache.org/maven2
            
      
       default
            
              
       
        false
             
            
              
       
        never
             
          
       
      
      
        
     
      ${project.basedir}/target
         
     
      ${project.build.directory}/classes
         
     
      ${project.artifactId}-${project.version}
         
     
      ${project.build.directory}/test-classes
         
     
      ${project.basedir}/src/main/java
         
     
      ${project.basedir}/src/main/scripts
         
     
      ${project.basedir}/src/test/java
         
           
              
       
        ${project.basedir}/src/main/resources
             
          
         
           
              
       
        ${project.basedir}/src/test/resources
             
          
         
         
           
            
            
              
                 
        
         maven-antrun-plugin
                  
        
         1.3
                
               
                 
        
         maven-assembly-plugin
                  
        
         2.2-beta-5
                
               
                 
        
         maven-dependency-plugin
                  
        
         2.8
                
               
                 
        
         maven-release-plugin
                  
        
         2.3.2
                
             
          
       
      
      
        
     
      ${project.build.directory}/site
       
      
      
        
         
           
      
       release-profile
            
              
                 
        
         performRelease
                  
        
         true
                
             
            
              
                 
         
         
          true
          
         
          maven-source-plugin
          
          
           
           
            attach-sources
            
            
            
             jar
             
            
           
          
                  
         
         
          true
          
         
          maven-javadoc-plugin
          
          
           
           
            attach-javadocs
            
            
            
             jar
             
            
           
          
                  
         
         
          true
          
         
          maven-deploy-plugin
          
          
          
           true
           
          
                
             
          
       
    
   
   

附: Maven继承与组合的其他信息还可参考: .

---

Maven Plugin 开发

几乎100%的场景都不用我们自己开发Maven插件, 但理解插件开发可以使我们更加深入的理解Maven. 下面我们实际开发一个用于统计代码行数的插件 lc-maven-plugin.

---

1. 创建plugin项目

mvn archetype:generate     -DgroupId=com.fq.plugins -DartifactId=lc-maven-plugin -Dversion=0.0.1-SNAPSHOT    -DarchetypeArtifactId=maven-archetype-plugin     -DinteractiveMode=false     -DarchetypeCatalog=internal

使用maven-archetype-plugin Archetype可以快速创建一个Maven插件项目(关于Maven Archetype可参考 、[注: 该文档介绍的是Archetype 1.x编写, 2.x内附链接]).

• pom.xml
  插件本身也是Maven项目, 特殊之处在于packaging方式为maven-plugin:

       
    
     4.0.0
        
    
     com.fq.plugins
        
    
     lc-maven-plugins
        
    
     maven-plugin
        
    
     0.0.1-SNAPSHOT
        
            
                 
      
       com.google.guava
                  
      
       guava
                  
      
       19.0
              
             
                 
      
       org.apache.maven
                  
      
       maven-plugin-api
                  
      
       3.3.3
              
             
                 
      
       org.apache.maven.plugin-tools
                  
      
       maven-plugin-annotations
                  
      
       3.3
              
         
    
   

maven-plugin 打包方式能控制Maven为其在生命周期阶段绑定插件处理的相关目标.

---

2. 编写目标Mojo

What is a Mojo? A mojo is a M aven plain O ld J ava O bject. Each mojo is an executable goal in Maven, and a plugin is a distribution of one or more related mojos.

/** * @author jifang * @since 16/10/9 上午11:33. */@Mojo(name = "lc", defaultPhase = LifecyclePhase.VERIFY)public class LCMavenMojo extends AbstractMojo {
       private static final List
   
     DEFAULT_FILES = Arrays.asList("java", "xml", "properties");    @Parameter(defaultValue = "${project.basedir}", readonly = true)    private File baseDir;    @Parameter(defaultValue = "${project.build.sourceDirectory}", readonly = true)    private File srcDir;    @Parameter(defaultValue = "${project.build.testSourceDirectory}", readonly = true)    private File testSrcDir;    @Parameter(defaultValue = "${project.build.resources}", readonly = true)    private List
    
      resources;    @Parameter(defaultValue = "${project.build.testResources}", readonly = true)    private List
     
       testResources;    @Parameter(property = "lc.file.includes")    private Set
      
        includes = new HashSet<>();    private Log logger = getLog();    @Override    public void execute() throws MojoExecutionException, MojoFailureException {        if (includes.isEmpty()) {            logger.debug("includes/lc.file.includes is empty!");            includes.addAll(DEFAULT_FILES);        }        logger.info("includes: " + includes);        try {            long lines = 0;            lines += countDir(srcDir);            lines += countDir(testSrcDir);            for (Resource resource : resources) {                lines += countDir(new File(resource.getDirectory()));            }            for (Resource resource : testResources) {                lines += countDir(new File(resource.getDirectory()));            }            logger.info("total lines: " + lines);        } catch (IOException e) {            logger.error("error: ", e);            throw new MojoFailureException("execute failure: ", e);        }    }    private LineProcessor
       
         lp = new LineProcessor
        
         () { private long line = 0; @Override public boolean processLine(String fileLine) throws IOException { if (!Strings.isNullOrEmpty(fileLine)) { ++this.line; } return true; } @Override public Long getResult() { long result = line; this.line = 0; return result; } }; private long countDir(File directory) throws IOException { long lines = 0; if (directory.exists()) { Set
         
           files = new HashSet<>(); collectFiles(files, directory); for (File file : files) { lines += CharStreams.readLines(new FileReader(file), lp); } String path = directory.getAbsolutePath().substring(baseDir.getAbsolutePath().length()); logger.info("path: " + path + ", file count: " + files.size() + ", total line: " + lines); logger.info("\t-> files: " + files.toString()); } return lines; } private void collectFiles(Set
          
            files, File file) { if (file.isFile()) { String fileName = file.getName(); int index = fileName.lastIndexOf("."); if (index != -1 && includes.contains(fileName.substring(index + 1))) { files.add(file); } } else { File[] subFiles = file.listFiles(); for (int i = 0; subFiles != null && i < subFiles.length; ++i) { collectFiles(files, subFiles[i]); } } }}
          
         
        
       
      
     
    
   

• @Parameter: 配置点, 提供Mojo的可配置参数. 大部分Maven插件及其目标都是可配置的, 通过配置点, 用户可以自定义插件行为:

       
    
     com.fq.plugins
        
    
     lc-maven-plugins
        
    
     0.0.1-SNAPSHOT
        
            
                 
      
       lc
                  
      
       verify
                  
                      
       
        lc
                   
                  
                      
                           
        
         java
                            
        
         lua
                            
        
         json
                            
        
         xml
                            
        
         properties
                        
                   
              
         
    
   

• execute(): 实际插件功能;
• 异常: execute()方法可以抛出以下两种异常:
  • MojoExecutionException: Maven执行目标遇到该异常会显示 BUILD FAILURE 错误信息, 表示在运行期间发生了预期的错误;
  • MojoFailureException: 表示运行期间遇到了未预期的错误, 显示 BUILD ERROR 信息.

---

3. 测试&执行

通过mvn clean install将插件安装到仓库后, 就可将其配置到实际Maven项目中, 用于统计项目代码了:

$ mvn com.fq.plugins:lc-maven-plugins:0.0.1-SNAPSHOT:lc [-Dlc.file.includes=js,lua] [-X]

注: 其他关于Maven Plugin开发可参考:、.

---

转载地址：http://jfhpi.baihongyu.com/