前言:
如今兄弟们对“apacheivymaven”大概比较注重,小伙伴们都需要了解一些“apacheivymaven”的相关资讯。那么小编同时在网上汇集了一些有关“apacheivymaven””的相关资讯,希望咱们能喜欢,我们一起来了解一下吧!Maven是我们在做Java开发过程中经常用到的一个辅助工具。本篇博客是我学习Maven的一个记录博客,学习过程主要参考《Maven实战》这本书。同时也参考了Maven的官方文档。
1. Maven简介#1.1 什么是Maven#
Maven是一个开源的Java项目构建、依赖管理和项目信息管理工具。
1.2 何为构建#
所谓构建是指项目编译、运行单元测试、生成项目文档、打包和项目部署等一系列操作。
1.3 Maven的优点#
Maven是一个优秀的构建工具:帮我们规范了项目的构建过程,我们不在需要像以前那样自己编写不通用的项目构建脚本,大大降低自写脚本出错的效率,同时也规范了团队项目的标准化。只需执行一些简单的Maven命令就可以实现项目构建工作。另外,Maven还提供了很多现成插件来完成各种构建任务,不需要我们自己去写脚本。
Maven抽象了一个完整的项目构建的生命周期模型,这个模型吸取了其他构建工具的优点,总结了大量项目的实际需求。如果遵循这个模型,可以避免很多不必要的错误。Maven已经提供了大量成熟的Maven插件来完成它抽象的这套生命周期模型,如果我们的项目有特殊的构建需求,可以通过实现自己的构建插件来完成项目特殊的构建需求。
统一的依赖管理(中央仓库)。
Maven还可以管理如下信息:项目描述、开发者列表、版本控制系统地址、许可证和缺陷管理系统地址等。
1.3 同类技术对比#
在Maven之前,Make和Ant也是两个比较流行的项目构建工具。但是使用这两个工具,针对每个项目我们必须自己编写项目构建脚本,而且这个两个工具都没有依赖管理的功能(Ant依赖于Lvy进行依赖管理),所以这两个工具逐渐成为过去式,Maven成为了Java世界中项目构建的标准。(Gradle也是一款不错的项目构建工具)
2. Maven安装配置#2.1 windows环境安装#
step1:安装JDK,配置JAVA_HOME,添加到path; step2:下载Maven安装包,解压到指定目录; step3:将Maven的安装目录添加到path; step3:使用mvn -v校验是否安装成功。
配置M2_HOME 和 MAVEN_HOME两个环境变量(指代Maven的安装目录,到bin那层目录)
通常需要设置MAVEN_OPTS的值为-Xms128m -Xmx512m,因为Java默认的最大可用内存往往不能够满足Maven运行的需要,比如在项目较大时,使用Maven生成项目站点需要占用大量的内存,如果没有该配置,则很容易得到java.lang.OutOfMemeoryError异常。因此,一开始就配置该环境变量是推荐的做法。
2.2 Linux环境安装#
安装方式和上述类似
2.3 .m2目录#
安装完Maven后,一般会在用户的主目录下有一个.m2目录。这个下面会有一个仓库目录,默认情况下,缓存下来的Jar包会存放在这个目录下。我们可以在这个目录下添加settings.xml文件配置仓库目录。注意这个settings文件只对当前用户生效。M2_HOME/config下的settings文件对所有用户生效。推荐使用用户范围的settings。
2.4 配置Http代理#
有时候公司为了安全起见,内部网络不能直接访问外部互联网。但是提供了代理服务器进行外部网络访问,这是想要让Maven访问到外部的Maven中心仓库需要配置代理。
<settings> ... <proxies> <proxy> <id>optional</id> <active>true</active> <protocol>http</protocol> <host>10.47.22.247</host> <port>80</port> <username>xx</username> <password>xx</pawwword> <nonProxyHosts>some.host.com|*.google.com</nonProxyHosts> </proxy> </proxies> ... </settings>
proxies下面可以配置多个代理,默认情况下第一个被激活的代理生效。如果代理服务器需要认证,那我们还需要提供用户名密码。标签用来指定访问哪个地址时不需要经过这个代理。
2.5 Maven安装最佳实践#2.5.1 配置MAVEN_OPTS#
通常需要设置MAVEN_OPTS的值为-Xms128m -Xmx512m,因为Java默认的最大可用内存往往不能够满足Maven运行的需要,比如在项目较大时,使用Maven生成项目站点需要占用大量的内存,如果没有该配置,则很容易得到java.lang.OutOfMemeoryError异常。因此,一开始就配置该环境变量是推荐的做法。
2.5.2 配置用户范围的settings.xml#
我们可以配置M2_HOME/conf/settings.xml,也可以配置~/.m2/settings.xml。前者会对所有用户生效,后者只会对当前用户生效。推荐配置用户范围内的setting,这样不会影响其他用户的配置,在升级Maven时也不需要重新配置。当然,如果你需要做全局配置,就需要配置做全局配置。
3. Maven坐标和依赖#3.1 Maven坐标#
在Maven中,坐标可以理解为一个依赖的唯一标识。Maven的坐标元素包括groupId、artifactId、version、packaging、classfier。只要我们提供正确的坐标元素,Maven就能找到对应的构件,首先去你的本地仓库查找,没有的话再去远程仓库下载。如果没有配置远程仓库,会默认从中央仓库地址()下载构件,该中央仓库包含了世界上大部分流行的开源项目构件,但不一定所有构件都有。下面介绍下坐标中每个标签的含义:
groupId:定义当前Maven项目的隶属的实际项目。比如xx公司xx团队的xx项目,xx项目下又包含几个模块项目。这时groupId我们就可以命名为com.xxCompany.xxTeam.xxProject,子项目的名字可以通过artifactId来指定;artifactId:定义实际项目中的一个Maven模块(子项目)的名字。一般推荐用项目的名称作为前缀。比如我们整个大项目的名称是xxProject,这个子模块的名称是core。那artifactId可以设置为xxProject-core。version:项目的版本packaging:项目打包方式(jar、war、pom等)默认的是jar。classifier:用来定义javadoc和源代码source等构件,这个元素不能直接定义。
邮件测试时我们可以考虑使用GreenMail这个类库
3.2 dependeny标签的内容#
dependeny标签下面可以有下面的标签:
groupId、artifactId和version这几个标签来定位具体的依赖;type这个标签对用maven坐标中的packaging属性,一般不需要指定,默认是jar;scope:见3.3节详解;optional:值是true或false,可选依赖不会被传递;exclusions:排除传递依赖。3.3 scope属性详解#
Maven环境下有三种classpath,分别是编译classpath、测试classpa和运行classpath。scope属性和这三种classpath有关。scope的值可以是下面几种:
compile:如果将一个依赖的scope属相设置为compile(默认就是compile),那么这个依赖对于三种classpath都有效;test:编译测试classpath有效,这种Jar包不会被打包进最终的项目;provide:对于编译和测试有效,运行时无效。说明在项目运行时这个依赖会被提供,就不需要我们打进项目了。典型的就是Servlet-api(这个依赖在运行时会由web容器提供)runtime:典型的应用就是JDBC的驱动实现(就是这个依赖的Jar只在项目运行是才会用到)system:依赖的Jar包在本地(不建议使用这个属性)
<dependency> <groupId>org.xx.xx</groupId> <artifactId>xx-web</artifactId> <scope>system</scope> <systemPath>{java.home}/lib/xx.jar</systemPath></dependency>import:该属性只会在dependenceManagement属性中生效。用来导入类型为pom的依赖,典型的应用看Springboot。
Scope
编译classpath
测试classpath
运行时classpath
列子
compile
Y
Y
Y
Spring-core
test
-
Y
-
junit
provide
Y
Y
-
servlet-api
runtime
-
Y
Y
jdbc驱动实现
system
Y
Y
-
3.4 传递依赖#
Maven的依赖是具有传递性的,比如A->B,B->C,那么A间接的依赖于C,这就是依赖的传递性,其中A对于B是第一直接依赖,B对于C是第二直接依赖,C为A的传递性依赖。这里还有一个依赖scope的问题。如果A->B的scope是compile,B->C的scope也是compile,那么A->C的scope也是compile。
表格:传递依赖
compile
test
provided
runtime
compile
compile
-
-
runtime
test
test
-
-
test
provided
provided
-
provided
provided
runtime
runtime
-
-
runtime
上表中最左边一列表示A->B的第一直接依赖,最上面一行表示B->C的第二直接依赖,表格中的内容表示A->C的依赖内容。举个列子,当A->B的直接依赖范围是test,B->C的第二直接依赖是compile,那么A->C的依赖范围是test。
3.5 依赖调解#
下面我们来思考这样一个问题,如果A->B->C->X(1.0),A->D-X(2.0),即A间接依赖X,我们可以看到有两条路径都依赖X,那么maven将会选择哪个版本的X?maven当中有一套自己的规则,我们来说明一下,maven传递性依赖的一些规则以及如何排除依赖冲突。
Maven里面对于传递性依赖有以下几个规则:
最短路径原则:如果A对于依赖路径中有两个相同的jar包,那么选择路径短的那个包,路径最近者优先,上述会选X(2.0)。第一声明优先原则:如果A对于依赖路径中有两个相同的jar包,路径长度也相同,那么依赖写在前面的优先。例如:A->B->F(1.0),A->C->F(2.0),会选F(1.0)。可选依赖不会被传递,如A->B,B->C,B->D,A对B直接依赖,B对C和D是可选依赖,那么在A中不会引入C和D。可选依赖通过optional元素配置,true表示可选。如果要在A项目中使用C或者D则需要显式地声明C或者D依赖。3.6 依赖排除#
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>3.2.8</version> <exclusions> <exclusion> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> </exclusion> </exclusions></dependency4. Maven仓库#
Maven的仓库分为本地仓库和远程仓库。Maven在寻找依赖的时候会先从本地仓库寻找,本地没有的话会从远程仓库去下载到本地然后再使用。
4.1 仓库的分类#4.1.1 本地仓库#
本地仓库需要我们在settings.xml配置文件中配置。注意,默认情况下.m2目录下是没有这文件的,需要我们自己配置。所有的依赖都会被缓存到本地仓库,本地没有的话回去远程仓库拿。
<localRepository>D:\software\maven\Repository</localRepository>4.1.2 远程仓库#
远程仓库有好几种分类:Maven的中央仓库、Nexus搭建的私有服务器(如果Nexus上没有相应的依赖,Nexus会自动从外部的仓库下载)和JBoss、谷歌的中央仓库等。一般我们只配置一个远程仓库。如果中央仓库中没有相应的依赖,就会报错。下面是Maven配置的默认的远程仓库,这个仓库中包含了绝大多数的依赖构建,如果我们没做其他配置,Maven就会从这个仓库中下载依赖。
<repositories> <repository> <id>central</id> <name>Central Repository</name> <url>;/url> <layout>default</layout> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories>
Maven还允许用户配置私有服务器。如果我们将远程仓库配置成我们自己搭建的私有服务器,那么Maven每次都会从私有服务器上去请求依赖,如果私服上不存在我们需要的依赖,私服会先从外部仓库下载依赖然后缓存到服务器上再提供给我们。另外私服也允许我们自己上传依赖。架设Maven私服有如下优点:
节省公司外网贷款;因为依赖会被缓存到私服上,所以依赖的下载速度会很快;方便上传团队内部的依赖,统一管理,共享。4.2 远程仓库的配置#
Maven已经默认为我们配置了一个远程仓库,在maven安装目录下的:/lib/maven-model-builder-${version}.jar中我们可以找到这个配置。
<repositories> <repository> <id>central</id> <name>Central Repository</name> <url>;/url> <layout>default</layout> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories>
这里我们只要知道,中央仓库的id为central,远程url地址为,它关闭了snapshot版本构件下载的支持。
当然我们也可以自己在pom中配置repository,有可能你依赖的一个jar在central中找不到,它只存在于某个特定的公共仓库,这样你也不得不添加那个远程仓库的配置。
<project> ... <repositories> <repository> <id>maven-net-cn</id> <name>Maven China Mirror</name> <url>;/url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>maven-net-cn</id> <name>Maven China Mirror</name> <url>;/url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> ... </project>
我们先看一下的配置,你可以在它下面添加多个 ,每个都有它唯一的ID,一个描述性的name,以及最重要的,远程仓库的url。此外,true告诉Maven可以从这个仓库下载releases版本的构件,而false告诉Maven不要从这个仓库下载snapshot版本的构件。禁止从公共仓库下载snapshot构件是推荐的做法,因为这些构件不稳定,且不受你控制,你应该避免使用。当然,如果你想使用局域网内组织内部的仓库,你可以激活snapshot的支持。
这边整理下Maven查询仓库的顺序:
先查询本地仓库,如果本地仓库中没有,进入第二步;查询Maven给central仓库配置镜像,如果配置了镜像就去镜像查,如果没有,就去中央仓库查;查询Maven有没给你自己配置的仓库指定镜像,如果配置了镜像就去镜像查,否则就从你自己配置的仓库查。4.2.1 远程仓库的认证#
大部分公共的远程仓库无须认证就可以直接访问,但我们在平时的开发中往往会架设自己的Maven远程仓库,出于安全方面的考虑,我们需要提供认证信息才能访问这样的远程仓库。配置认证信息和配置远程仓库不同,远程仓库可以直接在pom.xml中配置,但是认证信息必须配置在settings.xml文件中。这是因为pom往往是被提交到代码仓库中供所有成员访问的,而settings.xml一般只存在于本机。因此,在settings.xml中配置认证信息更为安全。
<servers> <server> <id>releases</id> <username>pub_mvn_deploy</username> <password>mvn.Deploy</password> </server> </servers>
上面代码我们配置了一个id为releases的远程仓库认证信息。Maven使用settings.xml文件中的servers元素及其子元素server配置仓库认证信息。认证用户名为admin,认证密码为admin123。这里的关键是id元素,settings.xml中server元素的id必须与pom.xml中需要认证的repository元素的id完全一致。正是这个id将认证信息与仓库配置联系在了一起。
4.2.2 部署构建到远程仓库#
<distributionManagement> <repository> <id>releases</id> <name>public</name> <url>;/url> </repository> <snapshotRepository> <id>snapshots</id> <name>Snapshots</name> <url>;/url> </snapshotRepository> </distributionManagement>
distributionManagement包含repository和snapshotRepository子元素,前者表示发布版本(稳定版本)构件的仓库,后者表示快照版本(开发测试版本)的仓库。这两个元素都需要配置id、name和url,id为远程仓库的唯一标识,name是为了方便人阅读,关键的url表示该仓库的地址。往远程仓库部署构件的时候,往往需要认证,配置认证的方式同上。
配置正确后,运行命令mvn clean deploy,Maven就会将项目构建输出的构件部署到配置对应的远程仓库,如果项目当前的版本是快照版本,则部署到快照版本的仓库地址,否则就部署到发布版本的仓库地址。
4.3 快照版本#
在Maven世界中版本分为发布版本和快照版本。1.0.0、1.3-alpha-4和2.0这种版本是稳定的发布版本。2.1-SNAPSHOT或者2.1--20091214-13这种版本是快照版本。
如果我们依赖一个版本为快照的依赖,这种情况下我们我们每次build的时候都会从远程仓库拉取这个依赖的最新版本。(远程仓库会给这个依赖维护一个时间戳,所以Maven能知道最新的版本)
release(最新发布版本)、latest(最新版本)、snapshot这三种版本都是上面的策略。在我们平时使用时不建议使用release和latest版本,因为这些版本更新比较频繁,你的项目依赖了这些版本的Jar包,今天还能编译通过,明天可能就编译不过了。推荐使用稳定发布版本。
<repository> <releases> <enabled></enabled> </releases> <snapshots> <enabled></enabled> </snapshots> </repository>4.4 从仓库解析依赖的机制#
。。。待完成
4.5 镜像#
如果仓库X可以提供仓库Y存储的所有内容,那么就可以认为X是Y的一个镜像。关于镜像的一个更为常见的用法是结合私服。由于私服可以代理任何外部的公共仓库(包括中央仓库),因此,对于组织内部的Maven用户来说,使用一个私服地址就等于使用了所有需要的外部仓库,这可以将配置集中到私服,从而简化Maven本身的配置。在这种情况下,任何需要的构件都可以从私服获得,私服就是所有仓库的镜像。这时,可以配置这样的一个镜像:
<mirrors> <mirror> <!--This sends everything else to /public --> <id>nexus</id> <mirrorOf>*</mirrorOf> <url>;/url> </mirror> </mirrors>
mirrorOf标签可以有多种配置方式:
<!-- 匹配所有仓库 --><mirrorOf>*</mirrorOf><!-- 匹配仓库rep1和rep2 --><mirrorOf>rep1,rep2</mirrorOf><!-- 匹配rep1之外的所有 --><mirrorOf>*,!rep1</mirrorOf><!-- 匹配不在本机上的远程仓库 --><mirrorOf>external:*</mirrorOf>5. Maven生命周期和插件#
在Maven中,我们需要掌握的重要概念有坐标、依赖、仓库、生命周期、插件。这个章节我们讲解生命周期和插件的主题。
Maven通过对大量项目构建过程的总结,抽象出了一套高度完善的项目构建的生命周期。整个生命周期包含项目的清理、初始化、编译、测试、打包、集成测试、验证、部署、站点生成等几乎所有的过程。Maven的整个生命周期是抽象的,这意味着整个生命周期本身不会干任何事情。在Maven项目的整个构建过程中,实际的构建任务都是由Maven插件完成的。Maven本身内置了很多插件,所以我们在项目进行编译、测试、打包的过程是没有感觉到。比如编译就是通过maven-compile-plugin实现的、测试是通过maven-surefire-plugin实现的。
5.1 生命周期详解#
Maven拥有3套独立的生命周期:clean周期、default周期和site生命周期。clean周期的主要作用是清理项目,default周期的作用是构建项目,site周期的作用是生成项目站点。每个生命周期都若干个阶段,比如使用mvn clean命令,就是调用了clean生命周期的clean阶段。
5.1.1 clean生命周期#
Clean生命周期一共包含了三个阶段:
pre-clean:执行一些需要在clean之前完成的工作。clean:移除所有上一次构建生成的文件。post-clean:执行一些需要在clean之后立刻完成的工作。
mvn clean中的clean就是上面的clean,在一个生命周期中,运行某个阶段的时候,它之前的所有阶段都会被运行,也就是说,mvn clean等同于 mvn pre-clean clean,如果我们运行 mvn post-clean,那么 pre-clean、clean 都会被运行。这是Maven很重要的一个规则,可以大大简化命令行的输入。但是执行clean生命周期的某个阶段,不会触发其他生命周期的阶段,因为Maven的每个生命周期都是相互独立的。
5.1.2 site生命周期#
下面看一下Site生命周期的各个阶段:
pre-site:执行一些需要在生成站点文档之前完成的工作。site:生成项目的站点文档。post-site:执行一些需要在生成站点文档之后完成的工作,并且为部署做准备。site-deploy:将生成的站点文档部署到特定的服务器上。
这里经常用到的是site阶段和site-deploy阶段,用以生成和发布Maven站点,这可是Maven相当强大的功能,Manager比较喜欢,文档及统计数据自动生成,很好看。
5.1.3 default生命周期#
最后,来看一下Maven的最重要的default生命周期,绝大部分工作都发生在这个生命周期中,这里我只解释一些比较重要和常用的阶段:
validateinitializegenerate-sourcesprocess-sources:处理项目主资源文件,一般来说,是对src/main/resources目录的内容进行变量替换等工作后,复制到项目输出的主classpath目录中;generate-resourcesprocess-resourcescompile 编译项目的源代码,一般来说,是编译src/main/java目录下的Java文件至项目输出的主classpath目录中。process-classesgenerate-test-sourcesprocess-test-sources:处理项目测试资源文件,一般来说,是对src/test/resources目录的内容进行变量替换等工作后,复制到项目输出的测试classpath目录中。generate-test-resourcesprocess-test-resourcestest-compile:编译项目的测试源代码,一般来说,是编译src/test/java目录下的Java文件至项目输出的测试classpath目录中。process-test-classestest:使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署。prepare-packagepackage:接受编译好的代码,打包成可发布的格式,如 JAR 。pre-integration-testintegration-testpost-integration-testverifyinstall:将包安装至本地仓库,以让其它项目依赖。deploy:将最终的包复制到远程的仓库,以让其它开发人员与Maven项目使用。
基本上,根据名称我们就能猜出每个阶段的用途,关于阶段的详细解释以及其她阶段的解释,请参考 。
5.1.4 命令行和生命周期#
mvn clean install site-deploy5.2 插件详解#
这边先理解一个重要的概念:插件目标(goal)。每个插件的单个功能就可以理解为是一个插件的目标。举个例子,maven-dependency-plugin这个插件可以分析项目的依赖树、可以分析潜在无用的依赖,这一个个功能我们就可以理解为插件的goal。
5.2.1 默认插件绑定#
Maven生命周期的某个阶段会和插件的某个goal绑定来完成某个特定的任务。Maven已经在生命周期的某个阶段默认绑定了一些goal,让用户可以直接使用。
表格:clean生命周期绑定的插件
生命周期阶段
插件目标
pre-clean
-
clean
maven-clean-plugin:clean
post-clean
-
表格:site生命周期绑定的插件目标
生命周期阶段
插件目标
pre-site
-
site
maven-site-plugin:site
post-site
-
site-deploy
maven-site-plugin:deploy
表格:default生命周期绑定的插件目标
生命周期阶段
插件目标
执行的任务
process-resources
maven-resources-plugin:resources
复制主资源文件到主输出目录
compile
maven-compiler-plugin:compile
编译主代码到主输出目录
process-test-resources
maven-resources-plugin:testResources
-
test-compile
maven-compiler-plugin:testCompile
-
test
maven-surefire-plugin:test
执行测试用例
package
maven-jar-plugin:jar
项目打包(如果打成war包的话会绑定其他插件)
install
maven-install-plugin:install
安装到本地仓库
deploy
maven-deploy-plugin
项目部署
上表只是列出了拥有插件绑定关系的阶段,default生命周期还有很多其他阶段,默认他们没有绑定任何插件,因此这些阶段没有任何实际行为。
除了默认的打包类型jar之外,常见的打包类型还有war、pom、maven-plugin和ear等。
5.2.2 自定义插件绑定#
除了内置的绑定之外,用户还能自己选择将某个插件的目标绑定到生命周期的某个阶段上。这种自定义的绑定方式能让Maven执行更多功能。下面是一个插件配置的列子:
<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-source-plugin</artifactId> <version>2.1.2</version> <executions> <execution> <goals> <goal>jar-no-fork</goal> </goals> <phase>package</phase> </execution> </executions> </plugin> </plugins> </build>
在上面的列子中我们将>maven-source-plugin插件的jar-no-fork目标绑定到了default周期的package阶段。所以在执行到package阶段的时候jar-no-fork会被调用。有时候我们会发现我们没配置任何phase,插件的目标也能被调用。这是因为插件已经为目标默认绑定到生命周期的某个阶段上了。使用下面的命令可以查看某个目标绑定到了哪个阶段上
mvn help:describe -Dplugin=org.apache.maven.plugins:maven-dependency-plugin -Ddetail mvn help:describe -Dplugin=dependency -Ddetail
插件仓库和依赖的仓库不是公用的,需要我们另外配置。
<pluginRepositories> <pluginRepository> <id>central</id> <url>;/url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </pluginRepository> </pluginRepositories>6. Maven聚合和继承#6.1 聚合#
聚合最主要的表现形式是使用modle标签来管理多个子模块的构建:
<modules> <module>spring-boot-quickstart</module> <module>spring-boot-web</module> </modules>6.2 继承#
如果多个模块出现相同的依赖包,这样在pom.xml文件的内容出现了冗余、重复的内容,解决这个问题其实使用Maven的继承机制即可,就像Java的继承一样,父类就像一个模板,子类继承自父类,那么有些通用的方法、变量都不必在子类中再重复声明了。Maven的继承机制类似,在一个父级别的Maven的pom文件中定义了相关的常量、依赖、插件等等配置后,实际项目模块可以继承此父项目 的pom文件,重复的项不必显示的再声明一遍了,相当于父Maven项目就是个模板,等着其他子模块去继承。不过父Maven项目要高度抽象,高度提取公共的部分(交集),做到一处声明,多处使用。
可继承的POM元素:
groupId和version是可以被继承的,那么还有哪些POM元素可以被继承呢?以下是一个完整的列表,并附带了简单的说明:
groupId:项目组 ID,项目坐标的核心元素;version:项目版本,项目坐标的核心元素;description:项目的描述信息;organization:项目的组织信息;inceptionYear:项目的创始年份;url:项目的 url 地址;develoers:项目的开发者信息;contributors:项目的贡献者信息;distributionManagerment:项目的部署信息;issueManagement:缺陷跟踪系统信息;ciManagement:项目的持续继承信息;scm:项目的版本控制信息;mailingListserv:项目的邮件列表信息;properties:自定义的 Maven 属性;dependencies:项目的依赖配置;dependencyManagement:醒目的依赖管理配置;repositories:项目的仓库配置;build:包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等;reporting:包括项目的报告输出目录配置、报告插件配置等。
聚合 VS 继承
虽然聚合通常伴随着父POM的继承关系,但是这两者不是必须同时存在的,从上面两者的介绍可以看出来,这两者的都有不同的作用,他们的作用不依赖于另一个的配置。
父POM是为了抽取统一的配置信息和依赖版本控制,方便子POM直接引用,简化子POM的配置。聚合(多模块)则是为了方便一组项目进行统一的操作而作为一个大的整体,所以要真正根据这两者不同的作用来使用,不必为了聚合而继承同一个父POM,也不比为了继承父POM而设计成多模块。
6.3 插件管理#
和依赖管理(dependencyManagement)的理念相同,我们可以在父pom中配置插件管理。这样子模块就可以继承父模块的插件。
<build> <pluginManagement> <plugins> </plugins> </pluginManagement> </build>7. Nexus创建私服#
私服是一种特殊的Maven远程仓库。Nexus分为免费版和专业版。安装包分为附带web容器的Bundle版本,和不带web容器的war包版本。
7.1 Nexus仓库类型#
仓库有四种类型:
group(仓库组) :没有实际的内容,就是将若干个其他仓库组合成一个组,在这种类型的仓库中下载依赖的时候,Maven会从这个组中包含的仓库依次轮询,知道下载到依赖为止;hosted(宿主) :建在Nexus一台机器上的本地Maven仓库;proxy(代理) :是一个代理,代理了其他远程仓库,比如Maven的central仓库;virtual(虚拟):兼容Maven1 版本的jar或者插件。
每个仓库的格式为maven2或者maven1。此外,仓库还有一个属性为Policy(策略),表示该仓库为发布(Release)版本仓库还是快照(Snapshot)版本仓库。最后两列的值为仓库的状态和路径。
Maven Central:该仓库代理Maven中央仓库,其策略为Release,因此只会下载和缓存中央仓库中的发布版本构件。Releases:这是一个策略为Release的宿主类型仓库,用来部署组织内部的发布版本构件。Snapshots:这是一个策略为Snapshot的宿主类型仓库,用来部署组织内部的快照版本构件。3rd party:这是一个策略为Release的宿主类型仓库,用来部署无法从公共仓库获得的第三方发布版本构件。Apache Snapshots:这是一个策略为Snapshot的代理仓库,用来代理Apache Maven仓库的快照版本构件。Codehaus Snapshots:这是一个策略为Snapshot的代理仓库,用来代理Codehaus Maven仓库的快照版本构件。Google Code:这是一个策略为Release的代理仓库,用来代理Google Code Maven仓库的发布版本构件。java.net-Maven 2:这是一个策略为Release的代理仓库,用来代理java.net Maven仓库的发布版本构件。Public Repositories:该仓库组将上述所有策略为Release的仓库聚合并通过一致的地址提供服务。Public Snapshot Repositories:该仓库组将上述所有策略为Snapshot的仓库聚合并通过一致的地址提供服务。7.2 配置Nexus仓库#在POM中配置仓库
<project> <repositories> <repository> <id>maven-net-cn</id> <name>Maven China Mirror</name> <url>;/url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>maven-net-cn</id> <name>Maven China Mirror</name> <url>;/url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </project>
这种配置方式只会对当前项目生效,如果想对所有项目生效,可以在settings文件中配置。
在Settings.xml中配置
<settings> ... <profiles> <profile> <id>Nexus</id> <!-- repositories and pluginRepositories here--> </profile> </profiles> <activeProfiles> <activeProfile>Nexus</activeProfile> </activeProfiles> ... </settings>使用镜像
如果你的地理位置附近有一个速度更快的central镜像,或者你想覆盖central仓库配置,或者你想为所有POM使用唯一的一个远程仓库(这个远程仓库代理的所有必要的其它仓库)
<settings> ... <mirrors> <mirror> <id>maven-net-cn</id> <name>Maven China Mirror</name> <url>;/url> <mirrorOf>*</mirrorOf> </mirror> </mirrors> ... </settings>7.3 部署构建到Nexus#
...
8. Maven测试#
Maven的测试插件会自动执行src/test/java/下面的
**/Test*.java;**/*Test.java;**/*TestCase.java
以上形式的类。
8.1 跳过测试#
mvn clean install -DskipTests<properties> <skipTests>true</skipTests></properties>8.2 指定运行某个测试用例#
mvn test -Dtest=Random1Test,Random2Testmvn test -Dtest=Random*Test8.3 排除测试#
<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>3.0.0-M3</version> <configuration> <includes> <include>**/*Tests.java</include> </includes> <excludes> <exclude>**/TestCircle.java</exclude> <exclude>**/TestSquare.java</exclude> </excludes> </configuration> </plugin> </plugins> </build>9. 持续集成#
Hudson+Maven+git版本控制-->持续集成
10. 构建Web项目#
使用Cargo可以进行远程Web应用部署...
11. Maven版本管理#
Maven的版本管理一般会遵循:
<主版本>.<次版本>.<增量版本>-<里程碑版本>主版本号:表示项目架构有重大的变更;次版本号:较大范围的功能增加和变化,以及Bug修复,但总体项目架构没什么变化;增量版本:一般表示重大Bug修复,例如1.4.0发布后发现一个重大Bug,发现一个重大Bug修复后发布1.4.1;里程碑版本:SNAPSHOT-->alpha-->beta-->release-->GASNAPSHOT:正在开发中的版本
Alpha: 内部测试的版本(项目组内部测试)
Beta:用户下载下来测试使用
Release: 用户使用下来没什么问题就可以发布Release版本
GA:稳定版本
11.1 GPG签名#使用GPG签名来校验依赖包有没被第三方恶意篡改
12. 灵活的构建#12.1 Maven属性#
Maven中有6中基本属性:
内置属性
主要有两个常用内置属性——表示项目根目录,即包含.文件的目录;basedir表示项目根目录,即包含pom.xml文件的目录;{version}表示项目版本。POM属性
pom中对应元素的值,例如${project.artifactId}对应了元素的值,常用的POM属性包括:${project.build.sourceDirectory}:项目的主源码目录,默认为src/main/java/;${project.build.testSourceDirectory}:项目的测试源码目录,默认为/src/test/java/;${project.build.directory}:项目构建输出目录,默认为target/;${project.build.outputDirectory}:项目主代码编译输出目录,默认为target/classes/;${project.build.testOutputDirectory}:项目测试代码编译输出目录,默认为target/testclasses/;${project.groupId}:项目的groupId;${project.artifactId}:项目的artifactId;.:项目的,于project.version:项目的version,于{version}等价;..:项目打包输出文件的名称,默认为project.build.finalName:项目打包输出文件的名称,默认为{project.artifactId}${project.version}.自定义属性
在pom中元素下自定义的Maven属性。Settings属性
与POM属性同理。如${settings.localRepository}指向用户本地仓库的地址。Java系统属性
所有Java系统属性都可以使用Maven属性引用,例如${user.home}指向了用户目录。可以通过命令行mvn help:system查看所有的Java系统属性环境变量属性
所有环境变量都可以使用以env.开头的Maven属性引用。例如${env.JAVA_HOME}指代了JAVA_HOME环境变量的值。也可以通过命令行mvn help:system查看所有环境变量。12.2 资源过滤#
<build> <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> <excludes> <exclude>**/config/*.*</exclude> </excludes> </resource> <resource> <directory>src/main/resources/config</directory> <filtering>true</filtering> <includes> <include>application-${profiles.active}.yml</include> </includes> </resource> </resources> </build>12.3 Maven profile#12.3.1 针对不同环境profile#
<project> ... <profiles> <profile> <id>dev</id> <properties> <profiles.active>dev</profiles.active> </properties> <activation> <!-- **这边可以配置各种激活条件** -- > <property> <name></name> <value></value> </property> <file> <exists></exists> </file> <os> ... </os> <jdk> ... </jdk> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <id>stg</id> <properties> <profiles.active>stg</profiles.active> </properties> </profile> <profile> <id>prod</id> <properties> <profiles.active>prod</profiles.active> </properties> </profile> </profiles> ... </project>12.3.2 激活profile#命令行激活mvn clean install -Pdevsettings文件显示激活
如果你希望某个profile一直处于激活状态,可以直接在settings文件中配置:
<profiles> <profile> <id>nexus</id> <repositories> <repository> <id>central</id> <url>;/url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>central</id> <url>;/url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <!--make the profile active all the time --> <activeProfile>nexus</activeProfile> </activeProfiles12.3.3 Web项目打包#
...
13. 项目站点生成#
...后续完成...
14. 编写Mavem插件#
...后续完成...
附录#A. 常用命令#
下面我们总结下Maven中常用的命令。
mvn help:system 调用help这个插件,打印出jvm的系统属性和操作系统的环境变量mvn help:describe -Dplugin=org.apache.maven.plugins:maven-dependency-plugin -Ddetailmvn archetype:generate 这个命令可以帮助我们生成一个Maven项目的骨架
|--Pom.xml |--src |--main |--java |--resource |--test |--java |--resourcemvn dependency:listmvn denpedency:treemvn dependency:analyze 可以分析当前项目依赖的问题mvn clean install -DskipTestsmvn clean deploy 编译打包并发布到远程仓库mvn clean install siteB. POM文件总结#
元素名称 简 介 <project> POM的xml根元素 <parent> 声明继承 <modules> 声明聚合 <groupId> 坐标元素之一 <artifactId> 坐标元素之一 <version> 坐标元素之一 <packaging> 坐标元素之一,默认值jar <name> 名称 <description> 描述 <organization> 所属组织 <licenses><license> 许可证 <mailingLists><mailingList> 邮件列表 <developers><developer> 开发者 <contributors><contributor> 贡献者 <issueManagement> 问题追踪系统 <ciManagement> 持续集成系统 <scm> 版本控制系统 <prerequisites><maven> 要求Maven最低版本,默认值为2.0 <build><sourceDirectory> 主源码目录 <build><scriptSourceDirectory> 脚本源码目录 <build><testSourceDirectory> 测试源码目录 <build><outputDirectory> 主源码输出目录 <build><testOutputDirectory> 测试源码输出目录 <build><resources><resource> 主资源目录 <build><testResources><testResource> 测试资源目录 <build><finalName> 输出主构件的名称 <build><directory> 输出目录 <build><filters><filter> 通过properties文件定义资源过滤属性 <build><extensions><extension> 扩展Maven的核心 <build><pluginManagement> 插件管理 <build><plugins><plugin> 插件 <profiles><profile> POM Profile <distributionManagement><repository> 发布版本部署仓库 <distributionManagement> <snapshotRepository> 快照版本部署仓库 <distributionManagement> <site> 站点部署 <repositories><repository> 仓库 <pluginRepositories><pluginRepository> 插件仓库 <dependencies><dependency> 依赖 <dependencyManagement> 依赖管理 <properties> Maven属性 <reporting><plugins> 报告插件C. settings文件例子#
<settings><localRepository>D:\software\maven\Repository</localRepository><proxies><proxy> <id>optional</id> <active>true</active> <protocol>http</protocol> <host>10.47.22.247</host> <port>80</port> <nonProxyHosts>some.host.com</nonProxyHosts></proxy></proxies><servers><server> <id>releases</id> <username>pub_mvn_deploy</username> <password>mvn.Deploy</password></server><server> <id>snapshots</id> <username>pub_mvn_deploy</username> <password>mvn.Deploy</password></server><server> <id>nexus</id> <username>pub_mvn_deploy</username> <password>mvn.Deploy</password></server></servers><mirrors><mirror> <id>nexus</id> <mirrorOf>*</mirrorOf> <url>;/url></mirror></mirrors><profiles><profile> <id>nexus</id> <repositories> <repository> <id>central</id> <url>;/url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>central</id> <url>;/url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories></profile><!-- if you want to be able to switch to the defaultprofile profile put this in the active profile --><profile> <id>defaultprofile</id> <repositories> <repository> <id>maven.default</id> <name>default maven repository</name> <url>;/url> <snapshots> <enabled>true</enabled> </snapshots> </repository> <repository> <id>maven.snapshot</id> <name>Maven snapshot repository</name> <url>;/url> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories></profile></profiles><activeProfiles><!--make the profile active all the time --><activeProfile>nexus</activeProfile></activeProfiles></settings>D. settings文件元素参考表#
1,<settings>,settings.xml文档的根元素2,<localRepository>,本地仓库3,<interactiveMode>,Maven是否与用户交互,默认值true4,<offline>,离线模式,默认值false5,<pluginGroups> <pluginGroup>,插件组6,<servers> <server>,下载与部署仓库的认证信息7,<mirrors> <mirror>,仓库镜像8,<proxies> <proxy>,代理9,<profiles> <profile>,Settings Profile10,<activeProfiles> <activeProfile>,激活ProfileE. 常用插件总结#
插件名称 用途 来源maven-clean-plugin 清理项目 Apachemaven-compiler-plugin 编译项目 Apachemaven-deploy-plugin 部署项目 Apachemaven-install-plugin 安装项目 Apachemaven-resources-plugin 处理资源文件 Apachemaven-site-plugin 生成站点 Apachemaven-surefire-plugin 执行测试 Apachemaven-jar-plugin 构建jar项目 Apachemaven-war-plugin 构建war项目 Apachemaven-shade-plugin 构建包含依赖的jar包 Apachemaven-changelog-plugin 生成版本控制变更报告 Apachemaven-checkstyle-plugin 生成CheckStyle报告 Apachemaven-javadoc-plugin 生成javadoc文档 Apachemaven-jxr-plugin 生成源码交叉引用文档 Apachemaven-pmd-plugin 生成pmd报告 Apachemaven-project-info-reports-plugin 生成项目信息报告 Apachemaven-surefire-report-plugin 生成单元测试报告 Apachemaven-antrun-plugin 调用Ant任务 Apachemaven-archetype-plugin 基于Archetype生成项目骨架 Apachemaven-assembly-plugin 构建自定义格式的分发包 Apachemaven-dependency-plugin 依赖分析及控制 Apachemaven-enforcer-plugin 定义规则并强制要求项目遵守 Apachemaven-pgp-plugin 为项目构件生成pgp签名 Apachemaven-help-plugin 获取项目及Maven环境的信息 Apachemaven-invoker-plugin 自动运行Maven项目构建并验证 Apachemaven-release-plugin 自动化项目版本发布 Apachemaven-scm-plugin 集成版本控制系统 Apachemaven-source-plugin 生成源码包 Apachemaven-eclipse-plugin 生成eclipse项目环境配置 Apachebuild-helper-maven-plugin 包含各种支持构建生命周期的目标 Codehausexec-maven-plugin 运行系统程序或者java程序 Codehausjboss-maven-plugin 启动、停止jboss、部署项目 Codehausproperties-maven-plugin 从properties文件读写Maven属性 Codehaussql-maven-plugin 运行sql脚本 Codehaustomcat-maven-plugin 启动、停止tomcat、部署项目 Codehausversions-maven-plugin 自动化批量更新pom版本 Codehauscargo-maven-plugin 启动/停止/配置各类web容器自动化部署web项目 Cargojetty-maven-plugin 集成jetty容器、实现快速开发测试 Eclipsemave-gae-plugin 集成google app engine Googlecodemaven-license-plugin 自动化添加许可证证明至源码文件 Googlecodemaven-andmid-plugin 构建Android项目 GooglecodeF. 超级POM#
这个POM会被每个POM继承。它的定义在model-builder.jar这个包下面。我们解压就可以看到。
G. 图片工具#
这个网站提供了一个不错的制图工具,有时间可以研究下。
H. 参考书籍#《Maven实战》《Maven权威指南》I. Maven和gradle的对比# (Maven官网)
标签: #apacheivymaven