Maven 基本概念

1 依赖

1.1 denpendency包含的元素

名称 作用 备注
groupId 当前Maven项目隶属的实际项目 基本坐标
artifactId 实际项目中的一个Maven项目模块 基本坐标
version 版本号 基本坐标
type 依赖的类型，对应于项目坐标定义的packaging(巨) jar, war, pom，默认是jar
scope 依赖的范围 compile(编译依赖范围), test(测试依赖范围), provided(已提供依赖范围), runtime(运行时依赖范围), system(系统依赖范围), import(导入依赖范围)， 默认是compile
optional 标记依赖是否可选 可选的依赖不能被依赖传递
exclusions 依赖排除 一个exclusions可以包含一个或者多个exclusion子元素，即排除一个或者多个传递性依赖

1.2 依赖范围 scope

名称 compile test runtime 说明
compile √ √ √ 对compile, test, runtime三个阶段都有效
test √ 只在test阶段有效
runtime √ 只在runtime阶段有效
provided √ √ compile和test阶段有效
system √ √ 该依赖和本机系统绑定，所以必须使用systemPath元素显示地指定依赖文件的路径，使用这个依赖范围会造成构建的不可移植性。
import dependencyManagement元素下才有用，该范围的依赖通常指向一个pom，作用是把目标pom中的dependencyManagement配置导入到当前的pom，并且type配置为pom

java程序有三种classpath，分别是compile classpath，test classpath，runtime classpath，如上表不同的依赖范围支持不同的classpath

假设A依赖于B，B依赖于C，我们说A对于B是第一直接依赖，B对于C是第二直接依赖，A对于C是传递性依赖

如下图，最左边一列表示第一直接依赖范围，最上面一行表示第二直接依赖范围，中间交叉单元格表示传递性依赖范围。


依赖范围影响传递性依赖

可以用mvn dependency:tree，可以看到各个依赖的依赖传递以及依赖范围

[INFO] com.sankuai.sjst.crm:crm-common:jar:1.0.0-SNAPSHOT
[INFO] +- org.jmockit:jmockit:jar:1.9:test
[INFO] +- junit:junit:jar:4.12:test
[INFO] |  \- org.hamcrest:hamcrest-core:jar:1.3:test
[INFO] +- org.springframework:spring-test:jar:4.2.6.RELEASE:test
[INFO] |  \- org.springframework:spring-core:jar:4.2.6.RELEASE:compile
[INFO] +- com.fasterxml.jackson.core:jackson-core:jar:2.1.0:compile
[INFO] +- com.fasterxml.jackson.core:jackson-databind:jar:2.1.0:compile
[INFO] +- com.fasterxml.jackson.core:jackson-annotations:jar:2.1.0:compile
[INFO] +- javax.servlet:javax.servlet-api:jar:3.1.0:compile
[INFO] +- org.springframework:spring-context:jar:4.2.6.RELEASE:compile
[INFO] |  +- org.springframework:spring-aop:jar:4.2.6.RELEASE:compile
[INFO] |  |  \- aopalliance:aopalliance:jar:1.0:compile
[INFO] |  +- org.springframework:spring-beans:jar:4.2.6.RELEASE:compile
[INFO] |  \- org.springframework:spring-expression:jar:4.2.6.RELEASE:compile
[INFO] +- org.apache.commons:commons-lang3:jar:3.4:compile
[INFO] +- commons-collections:commons-collections:jar:3.2.2:compile
[INFO] +- commons-io:commons-io:jar:2.3:compile
[INFO] +- com.meituan.inf:xmd-log4j2:jar:1.1.3:compile
[INFO] |  +- com.meituan.inf:xmd-common-log4j2:jar:1.1.2:compile
[INFO] |  |  \- org.slf4j:jcl-over-slf4j:jar:1.7.2:compile
[INFO] |  +- org.slf4j:slf4j-api:jar:1.7.2:compile
[INFO] |  +- org.apache.logging.log4j:log4j-slf4j-impl:jar:2.3:compile
[INFO] |  +- org.apache.logging.log4j:log4j-api:jar:2.3:compile
[INFO] |  +- org.apache.logging.log4j:log4j-core:jar:2.3:compile
[INFO] |  \- org.apache.logging.log4j:log4j-1.2-api:jar:2.3:compile

1.3 依赖原则

1.路径最近者优先
2.第一声明者优先

2 仓库

maven仓库分类

一个构件只有在本地仓库中才能由其他Maven项目使用，构件可以从远程仓库中下载，也可以将本地项目的构件install到本地的Maven项目中。
settings.xml的<localRepository>：定义本地仓库的地址

2.1依赖查找的顺序

① 在本地仓库中搜索，如果找不到，执行②，如果找到了则执行其他操作。
② 在中央仓库中搜索，如果找不到，并且有一个或多个远程仓库已经设置，则执行步骤 ④，如果找到了则下载到本地仓库中已被将来引用。
③ 如果远程仓库没有被设置，Maven 将简单的停滞处理并抛出错误（无法找到依赖的文件）。
④ 在一个或多个远程仓库中搜索依赖的文件，如果找到则下载到本地仓库已被将来引用，否则 Maven 将停止处理并抛出错误（无法找到依赖的文件）。

2.2 settings.xml 和pom.xml中仓库信息设置

依赖的下载与部署的仓库是在pom.xml文件中的<distributionManagement>和<repository>设置的，通常访问这些仓库是需要认证的，认证信息在settings.xml<server>元素中。
pom.xml

<distributionManagement>
      <repository>
         <id>xxx-nexus-releases</id>
         <name>xxx Nexus Repository</name>
        <url>http://maven.xxx.com/nexus/content/repositories/releases/</url>
        </repository>
        <snapshotRepository>
            <id>xxx-nexus-snapshots</id>
            <name>xxx Nexus Repository</name>
            <url>http://maven.xxx.com/nexus/content/repositories/snapshots/</url>
        </snapshotRepository>
 </distributionManagement>

在settings.xml中<server>元素的id必须与pom.xml中需要认证的<repository>的id完全一致。id将认证信息和仓库联系在一起了。

 <server>
    <id>xxx-nexus-releases</id>
    <username>xxx</username>
    <password>yyyy</password>
 </server>
 <server>
    <id>xxx-nexus-snapshots</id>
    <username>xxx</username>
    <password>yyy</password>
</server>

pom.xml中设置了两个仓库，一个是release版本的仓库，一个是snapshots，如果release仓库Deployment Policy是“Disable
Redeploy”，那么release版本是不允许覆盖的。
所以当同样的release版本号二次发布的时候会报错，错误提示类似“Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy (default-deploy) on project crm-onlinepay-client: Failed to deploy artifacts: Could not transfer artifact com.xxx.yyy:crm-onlinepay-client:jar:1.0.1 from/to xxx-nexus-releases (http://maven.xxx.com/nexus/content/repositories/releases/): Failed to transfer file: http://maven.xxx.com/nexus/content/repositories/releases/com/xxx/yyy/crm-onlinepay-client/1.0.1/crm-onlinepay-client-1.0.1.jar. Return code is: 400, ReasonPhrase: Bad Request. -> [Help 1]”

Maven2部署构件到Nexus时出现的Failed to transfer file错误 @周路敏

3 Maven模块的聚合与继承

<modules> 声明聚合 为了快速构建项目
<parent>声明继承 为了消除重复配置
我的onlinepay项目结构

crm-onlinepay

最外面层的pom.xml是聚合pom，他的packaging方式必须是pom

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
         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>
    <parent>
        <groupId>com.xxx.yyyy.crm</groupId>
        <artifactId>crm-parent</artifactId>
        <version>1.0.4</version>
    </parent>

    <groupId>com.xxx.yyyy</groupId>
    <artifactId>crm-onlinepay</artifactId>
    <version>1.0.1</version>
    <packaging>pom</packaging>
    <name>${project.artifactId}</name>

    <properties>
        <project-client.version>1.0.1</project-client.version>
        <project-web.version>1.0.1</project-web.version>
    </properties>

    <distributionManagement>
        <repository>
            <id>xxxx-nexus-releases</id>
            <name>xxxx Nexus Repository</name>
            <url>http://maven.xxx.com/nexus/content/repositories/releases/</url>
        </repository>
        <snapshotRepository>
            <id>xxxx-nexus-snapshots</id>
            <name>xxx Nexus Repository</name>
            <url>http://maven.xxx.com/nexus/content/repositories/snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

    <modules>
        <module>crm-onlinepay-client</module>
        <module>crm-onlinepay-web</module>
    </modules>
</project>

onlinepay-client的pom

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.xxx.yyyy</groupId>
        <artifactId>crm-onlinepay</artifactId>
        <version>1.0.1</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>crm-onlinepay-client</artifactId>
    <version>${project-client.version}</version>
    <packaging>jar</packaging>
    <name>${project.artifactId}</name>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.sankuai.sjst.crm</groupId>
            <artifactId>crm-common</artifactId>
            <version>1.0.0</version>
        </dependency>
    </dependencies>

    <build>
        <finalName>${project.artifactId}-${project.version}</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-archetype-plugin</artifactId>
                <version>2.2</version>
            </plugin>

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>2.4</version>
                <configuration>
                    <attach>true</attach>
                </configuration>
                <executions>
                    <execution>
                        <phase>compile</phase>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>

    </build>
</project>

onlinepay-web的pom

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.xxx.yyyy</groupId>
        <artifactId>crm-onlinepay</artifactId>
        <version>1.0.1</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>crm-onlinepay-web</artifactId>
    <packaging>war</packaging>
    <name>${project.artifactId}</name>
    <version>${project-web.version}</version>
.....
</project>
聚合和继承

3.3 反应堆

所有模块组成的一个构建结构是反应堆，反应堆的顺序与模块间的继承关系和声明顺序有关，如果模块间不存在继承关系，则反应堆的构建顺序是声明顺序，如果存在继承关系，则首先构建父模块。
crm-onlinepay-client和crm-onlinepay-web是子模块，crm-onlinepay是父模块


项目反应堆构建顺序

剪裁反应堆
-am, --alse-make 同时构建依赖于所列模块的模块
-amd, -alse-make-dependents 同时构建依赖于所列模块的模块
-pl, --projects <arg> 构建指定的模块，模块间用逗号分隔
-rf, -resume-from <arg> 从指定的模块恢复反应堆，也就是说从哪里开始构建

3.4 pom中可继承的元素

Maven继承的目的是为了消除重复，所以pom中大量的元素是可以被继承的。

groupId:项目组ID,项目坐标的核心元素
version: 项目版本, 项目坐标的核心元素
description: 项目的描述信息
organization: 项目的组织信息
inceptionYear: 项目的创始年份
url: 项目的URL地址
developers: 项目开发者信息
contributors: 项目的贡献者信息
distributionManagement: 项目的部署配置
issueManagement: 项目的缺陷跟踪系统信息
ciManagement: 项目的持续集成系统信息
scm: 项目的系统信息
mailingLists: 项目的邮件列表信息
properties: 自定义的maven属性
dependencies: 项目的依赖配置
dependencyManagement: 项目的依赖管理配置
repositories: 项目的仓库配置
build: 包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等
reporting: 包括项目的报告输出目录配置、报告插件配置等

所以crm-onlinepay项目会继承crm-parent里面的依赖等信息

4 灵活的构建

Maven提供属性，资源过滤和profile三种方式进行灵活的构建

4.1Maven属性

1.内置属性
${basedir}表示项目根目录，${version}表示项目版本
2.POM属性
(使用pom属性可以引用到pom.xml文件对应元素的值)
${project.build.directory}表示主源码路径;
${project.build.sourceEncoding}表示主源码的编码格式;
${project.build.sourceDirectory}表示主源码路径;
${project.build.finalName}表示输出文件名称;
${project.version}表示项目版本,与${version}相同;
3.自定义属性
在pom.xml文件的<properties>标签下定义的Maven属性
4.settings.xml文件属性
(与pom属性同理,用户使用以settings.开头的属性引用settings.xml文件中的XML元素值)
${settings.localRepository}表示本地仓库的地址;
5.Java系统属性
(所有的Java系统属性都可以使用Maven属性引用)
使用mvn help:system命令可查看所有的Java系统属性;
System.getProperties()可得到所有的Java属性;
${user.home}表示用户目录;
6.环境变量属性
(所有的环境变量都可以用以env.开头的Maven属性引用)
使用mvn help:system命令可查看所有环境变量;
${env.JAVA_HOME}表示JAVA_HOME环境变量的值;

4.2 资源过滤

maven-resources-plugin的默认行为是将项目主资源文件复制到主代码编译输出目录中，将测试资源文件复制到测试代码编译输出目录中，如果开启了资源过滤，那么可以读取资源目录下的文件内容，即解析资源文件中的maven属性。
如果是web资源，则是通过maven-resources-plugin处理。

4.3 profile

可以根据环境不同选择不同的资源配置，<activeByDefault>表示默认激活的环境配置资源。

<profiles>
    <profile>
        <id>local</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <conf-dir>local</conf-dir>
        </properties>
    </profile>
    <profile>
        <id>dev</id>
        <properties>
            <conf-dir>dev</conf-dir>
        </properties>
    </profile>
    <profile>
        <id>beta</id>
        <properties>
            <conf-dir>beta</conf-dir>
        </properties>
        </profile>
    <profile>
        <id>miniflow</id>
        <properties>
            <conf-dir>miniflow</conf-dir>
        </properties>
    </profile>
    <profile>
        <id>test</id>
        <properties>
            <conf-dir>test</conf-dir>
        </properties>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <conf-dir>prod</conf-dir>
        </properties>
    </profile>
    <profile>
        <id>staging</id>
        <properties>
            <conf-dir>staging</conf-dir>
        </properties>
    </profile>
</profiles>
profiles

可以通过命令行参数 -P 加上profile的id来激活profile，多个id之间用逗号分隔。

settings.xml文件中也会有profile的配置，如果一个settings.xml中的profile被激活，它的值会覆盖任何其它定义在pom.xml中带有相同id的profile。
maven全局配置文件settings.xml详解 @静默空虚

5 超级POM

Maven约定大约配置，在$MAVEN_HONE/lib/maven-model-builder-x.x.x.jar中的org/apache/maven/model/pom-4.0.0.xml路径下存在超级pom。每个Maven项目都会继承这个超级pom，类似java中的object类，
超级pom声明了仓库等信息。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 213,186评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,858评论 3赞 387
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 158,620评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,888评论 1赞 285
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 66,009评论 6赞 385
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,149评论 1赞 291
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,204评论 3赞 412
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,956评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,385评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,698评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,863评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,544评论 4赞 335
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,185评论 3赞 317
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,899评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,141评论 1赞 267
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,684评论 2赞 362
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,750评论 2赞 351

推荐阅读更多精彩内容

  • Spring Cloud
    Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具（例如配置管理，服务发现，断路器，智...
    卡卡罗2017阅读 134,642评论 18赞 139
  • Spring boot参考指南
    Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,788评论 6赞 342
  • maven---6仓库
    |-1-更新内容[6.从仓库解析依赖的机制（重要）] 1Maven仓库作用 仓库用来存储所有项目使用到构件，在ma...
    zlcook阅读 6,041评论 0赞 25
  • @Maven POM 详解
    前言什么是 POMQuick Overview POM 常用元素 pom.xml 完整注释 参考 0 前言 什么是...
    seyvoue阅读 12,586评论 1赞 36
  • Maven详解（配置文件，生命周期，常用命令）
    当前，JVM生态圈主要的三大构建工具： Apache Ant(带着Ivy) Maven Gradle 对于刚开始接...
    清枫_小天阅读 5,785评论 1赞 13