MAVEN简介之——pom.xml

maven构建的生命周期

maven是围绕着构建生命周期这个核心概念为基础的。maven里有3个内嵌的构建生命周期,default,cleansite
default是处理你项目部署的;clean生命周期是清楚你项目的;site生命周期是生成你的项目文档的。

default生命周期由一下的阶段组成:

  • validate:验证项目正确性和所有需要的信息是否正确;
  • compile:编译项目源代码;
  • test:用单元测试框架测试编译后的代码,测试阶段不需要代码打包和部署;
  • package:把编译后的代码按照发行版本的格式打包,例如:jar;
  • verify:检验集成测试的结果,确保质量可以接受;
  • install:安装包到本地仓库,为本地的其他项目依赖使用;
  • deploy:把最终的包复制到远程仓库,为其他的项目和开发者共享。

default生命周期按照上面的顺序执行。

使用下面的命令构建项目并发布到本地仓库:

mvn install

上面的命令在执行install之前,将执行默认的生命周期(validate, compile, package等)。你只需要调用最后一个执行的命令即可。

下面的命令可以清除本地构建并重新打包发布到远程仓库:

mvn clean deploy

每一个构建阶段都是由插件目标组成的,一个插件目标代表着一个特殊的工作。它可以被绑定到多个构建阶段中,如果插件目标没有绑定到构建阶段中,
可以直接使用命令去执行。它们执行的顺序取决于命令的顺序。例如:

mvn clean dependency:copy-dependencies package

上例中,先执行clean,再执行dependency:copy-dependencies,最后执行package

pom文件

pom是Project Object Model的缩写。它包含了项目的信息和详细配置。

super pom是maven的默认pom,所有的pom都继承super pom。super pom中的配置在你的pom中是有效的。

你能创建的最小pom的格式如下:

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <version>1</version>
</project>

每一个pom都需要配置groupId, artifactId, 和 version。它代表这一个工件,工件的名称格式如下:<groupId>:<artifactId>:<version>
上例中由于没有指定打包的类型,将使用super pom的默认配置,所以它的类型是jar。由于仓库也没有指定,将使用super pom中配置的仓库,
我们可以看到super pom中配置了http://repo.maven.apache.org/maven2

super pom是项目继承的一个例子,你也可以在项目中指定自己的父pom,例子如下:

.
 |-- my-module
 |   `-- pom.xml
 `-- pom.xml

我们沿用上面的例子,项目的结构如上图所示,根目录下的pom是com.mycompany.app:my-app:1的pom,my-module/pom.xml是com.mycompany.app:my-module:1的pom。
my-module的pom如下:

<project>
  <parent>
    <groupId>com.mycompany.app</groupId>
    <artifactId>my-app</artifactId>
    <version>1</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-module</artifactId>
  <version>1</version>
</project>

它指定了父pom为my-app,并且指定自己的groupId,artifactId,version。如果你想要groupId,version沿用父pom的,可以将其省略掉,如下:

<project>
  <parent>
    <groupId>com.mycompany.app</groupId>
    <artifactId>my-app</artifactId>
    <version>1</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <artifactId>my-module</artifactId>
</project>

上面的例子中,父pom的位置在module的上一级目录,如果父pom不在上一级目录,该如何配置呢?

.
 |-- my-module
 |   `-- pom.xml
 `-- parent
     `-- pom.xml

我们可以指定<relativePath>元素,如下:

<project>
  <parent>
    <groupId>com.mycompany.app</groupId>
    <artifactId>my-app</artifactId>
    <version>1</version>
    <relativePath>../parent/pom.xml</relativePath>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <artifactId>my-module</artifactId>
</project>

推荐使用相对路径指定父pom。

项目集合与项目的继承非常像,不同点在于它在父pom中指定模块,为了配置项目集合,你需要做两点:

  1. 父pom的packaging改为pom
  2. 在父pom中指定它的模块。

如果目录结构为:

.
 |-- my-module
 |   `-- pom.xml
 `-- pom.xml

父pom的配置如下:

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <version>1</version>
  <packaging>pom</packaging>
 
  <modules>
    <module>my-module</module>
  </modules>
</project>

如果目录结构为:

.
 |-- my-module
 |   `-- pom.xml
 `-- parent
     `-- pom.xml

父pom结构如下:

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <version>1</version>
  <packaging>pom</packaging>
 
  <modules>
    <module>../my-module</module>
  </modules>
</project>

profile

profile是环境配置,它配置了不同的环境下,项目中使用的值。profile可以定义的位置:

  • 每个项目:pom文件;
  • 每个用户:%USER_HOME%/.m2/settings.xml中;
  • 全局配置:${maven.home}/conf/settings.xml中。

要使profile被触发,通常是在maven打包编译时指定profile-id。例如:

mvn clean install -P profile-1,profile-2

上面的例子将触发两个profile:profile-1profile-2

还有就是通过settings文件触发,例如:

<settings>
  ...
  <activeProfiles>
    <activeProfile>profile-1</activeProfile>
  </activeProfiles>
  ...
</settings>

一般情况下,这两种方式就够用了,还有其他的方式这里不做过多介绍。

配置profile的地方通常有两个:settings和pom。settings因为时所有项目共同依赖的,所以在这里配置profile的元素时有限制的,可配置的元素
只能是:<repositories><pluginRepositories><properties>。而在pom中可以配置所有的元素。

依赖机制

传递依赖

传递依赖的意思是,你依赖的包需要的依赖是不需要指定的,它们会自动的包含进来。maven会读取你依赖包中的项目文件,通过项目文件找到依赖包所需要的依赖包。
当发生循环依赖的时候,会产生问题。

由于传递依赖,项目依赖包的图会非常的巨大。正是因为这个原因,依赖的传递机制加入了额外的特性。

  • 依赖调解——当依赖的多个版本同时出现时,决定哪个版本被使用。当前的maven版本使用的是“最近原则”。举例说明,比如,
    A->B->C->D 2.0,并且A->E->D 1.0。最后,D1.0将被使用,因为D1.0离A是最近的。你可以在A中强制指定依赖D2.0。
    在距离相同的情况下,最先被声明的那个依赖被使用。
  • 依赖管理——在项目中可以直接指定依赖的版本,如上例所示。
  • 依赖范围——下面会详细介绍
  • 排除依赖——如果A->B->C,在项目A中可以通过exclusion元素排除掉C。
  • 选择依赖——如果项目Y->Z,项目Y可以配置Z为可选依赖(通过optional),当项目X->Y时,X仅依赖Y,而不依赖Z,如果X想要依赖Z,必须指定依赖。

依赖范围有6个可选项

  • compile:默认的依赖范围,它的依赖在项目的类路径下都是可用的。这些依赖将传播到依赖的工程。
  • provided:非常像compile,标志着你希望JDK或者容器在运行时提供依赖。例如,你在构建web项目时,Servlet API和Java EE API的范围设置成provided,
    因为在运行时,容器提供了这些类。
  • runtime:标志着这个依赖在编译期是不需要的,在运行期需要。
  • test:标志着应用的正常使用是不需要这个依赖的,仅仅在测试时需要。
  • system:这个与provided相似,除了那些你必须显示提供的,包含它的jar。这个工件时可用的,不会在仓库中寻找。
  • import:这个范围仅支持在依赖类型是pom,且在<dependencyManagement>元素中。它将被<dependencyManagement>中的具体的依赖所取代。

今天就先介绍到这里,如有疑问,欢迎在评论区留言。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 196,264评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,549评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,389评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,616评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,461评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,351评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,776评论 3 387
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,414评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,722评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,760评论 2 314
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,537评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,381评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,787评论 3 300
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,030评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,304评论 1 252
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,734评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,943评论 2 336

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,517评论 18 139
  • 简介 概述 Maven 是一个项目管理和整合工具 Maven 为开发者提供了一套完整的构建生命周期框架 Maven...
    闽越布衣阅读 4,256评论 6 39
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,680评论 6 342
  • 前言什么是 POMQuick Overview POM 常用元素 pom.xml 完整注释 参考 0 前言 什么是...
    seyvoue阅读 12,551评论 1 36
  • 文/沐小木 昨天有学弟和我聊天,提到了寒假电子厂打工这件事,我才恍然记起,距离去年的寒假过去了整整一年。 一些低年...
    小迎喝饱了阅读 3,115评论 0 4