一、pom.xml文件
就像项目管理软件 Make 的 MakeFile、Ant 的 build.xml 一样,Maven 项目的核心是 pom.xml。POM( Project Object Model,项目对象模型 ) 定义了项目的基本信息,用于描述项目如何构建,声明项目依赖,等等。
类似的软件还有Gradle。
二、坐标
1、坐标的概念
在 Maven 中坐标是构件的唯一标识,Maven 坐标的元素包括 groupId、artifactId、version、packaging、classifier。上述5个元素中,groupId、artifactId、version 是必须定义的,被简称为“三维坐标”,packaging 是可选的 ( 默认为 jar )。
2、坐标的意义
Maven世界拥有大量构建,我们需要找一个用来唯一标识一个构建的统一规范,即通过三维坐标找到具体的jar包。拥有了统一规范,就可以把查找工作交给机器。
3、坐标的含义
(1)groupId
组织标识,一般为:公司网址的反写+项目名
(2)artifactId
项目名称,一般为:项目名-模块名
(3)version
版本号,形式为0.0.1-SNAPSHOT:
- 第一个 0 表示大版本号,第二个 0 表示分支版本号,第三个 0 表示小版本号
- SNAPSHOT -- 快照版本,ALPHA -- 内侧版本,BETA -- 公测版本,RELEASE -- 稳定版本,GA -- 正式发布
(4)packaging
打包的方式,如:pom,jar,maven-plugin,ejb,war,...
- jar
- war:带有前端页面的前端包
- pom:没有代码,只做依赖管理的pom包
(5)clissifier
用来帮助定义构件输出的一些附属构件。
4、自己项目的坐标
这是一个名为Hello的MavenJava项目,该项目的pom.xml如下图:
其中:
<groupId>cn.tx.maven</groupId>
项目的全球唯一标识符,通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成,如cn.tx.maven生成的相对路径为:/cn/tx/maven。
<artifactId>Hello</artifactId>
构件的标识符,它和groupId一起唯一标识一个构件。也就是说,两个不同的项目不能拥有同样的groupId和artifactId。
<version>0.0.1-SNAPSHOT</version>
项目当前版本,格式为:主版本.次版本.增量版本--限定版本号。
<packaging>jar</packaging>
项目产生的构件类型,例如jar、war、pom等。插件可以创建他们自己的构件类型,所以前面列的不是全部构建类型。
5、第三方项目坐标
自己项目依赖包一般是从本地仓库或者私服中获取。
三、依赖
1、依赖的意义
当编写Java代码时,我们总是需要一些库,例如,做单元测试我们需要JUnit库。对于更大的项目,我们可能需要创建自己的库并在不同的部分使用它的项目。不同的项目需要不同版本的库。 保持项目最新的库JAR文件的正确版本不是一个容易的任务。
每个外部JAR可能还依赖于其他外部JAR文件等。以递归方式下载所有这些外部依赖JAR文件并确保下载正确的版本是一项巨大的任务。
当项目越来越大,我们将需要越来越多的外部依赖。
Maven将下载它们并将它们放在您的本地Maven存储库中。
我们可以在POM文件中的dependencies元素内指定依赖关系。
2、依赖的使用
例如我们的项目需要进行单元测试,则需要使用到junit-4.9.jar包,使用maven引用该依赖的方式如下:
属性说明:
三维坐标:引用依赖包的三维坐标,用来定位该依赖包;
<dependencies> </dependencies> :表示一个包含所有依赖的集合;
<dependency></dependency>:表示一个具体的依赖,可以是本地项目,也可以是第三方依赖;
<scope></scope>: 控制该依赖包在什么情况下会被加到 classpath 中,即该依赖包什么时候生效。
3、第三方依赖的查找方法
我们在不确定所需引用的第三方依赖包的坐标时,通过maven的中央仓库进行查找,网址: https://mvnrepository.com/;
以mybatis举例:
四、依赖范围
Maven项目在开发工程中有三套classpath
- 主代码:main下面的都是主代码在编译的时候的依赖
- 测试代码:test下是测试代码编译的时候的依赖
- 运行时:main代码在运行的时候对包的依赖
依赖范围的使用,通过在引用第三方依赖时的<scope></scope>标签进行设置,例如:
上图的junit,只在测试中使用,则选择test即可,而默认情况为compile。
scope共 6 种,包括:compile、provided、runtime、test、system、import。
- compile:编译依赖范围。默认使用此依赖范围,其下的maven依赖,对于编译,测试,运行classpath都有效。
- test:测试依赖范围。只对测试classpath有效,编译主代码或运行项目时无法使用此依赖。典型例子如junit。
- provided:已提供依赖范围。其对于编译与测试classpath有效,运行时无效。如在web开发时,只有在编译和测试时才用到servlet-api,将其设置为此范围,在运行时servlet-api由web容器提供,无须依赖。并且在打war包时,此范围的依赖不会打在WEB-INF/lib下。
- runtime:运行时依赖范围。与provided相对,运行时classpath有效。典型例子如jdbc(编写是接口规范运行是提供具体实现类需要jar包)。
五、依赖传递和可选依赖
1、依赖传递
应用场景:
第一直接依赖: HelloFriend项目依赖Hello项目
第二直接依赖: MakeFriend项目依赖HelloFriend项目
MakeFriend项目只依赖了HelloFriend,但是也把Hello依赖了进来。
2、依赖范围对传递依赖的影响
传递依赖是会受到依赖范围的影响的,具体来看结果如下:
3、依赖阻断
我们使用
例如我们在HelloFriend项目里面的Hello依赖处添加该配置。
则makeFriend项目里面就不会再引入Hello的依赖
4、可选依赖
如果我们需要在依赖中明确的排除掉某一依赖,则可以使用exclusion属性,排除掉引用的依赖,如图:
六、仓库
1、仓库的概念
在 Maven 的术语中,仓库是一个位置(place)。
Maven 仓库是项目中依赖的第三方库,这个库所在的位置叫做仓库。
在 Maven 中,任何一个依赖、插件或者项目构建的输出,都可以称之为构件。
Maven 仓库能帮助我们管理构件(主要是JAR),它就是放置所有JAR文件(WAR,ZIP,POM等等)的地方。
仓库的类型有:
- 本地(local)
- 中央(central)
- 远程(remote)
2、本地仓库
Maven 的本地仓库,在安装 Maven 后并不会创建,它是在第一次执行 maven 命令的时候才被创建。
运行 Maven 的时候,Maven 所需要的任何构件都是直接从本地仓库获取的。如果本地仓库没有,它会首先尝试从远程仓库下载构件至本地仓库,然后再使用本地仓库的构件。
默认情况下,不管Linux还是 Windows,每个用户在自己的用户目录下都有一个路径名为 .m2/respository/ 的仓库目录
Maven 本地仓库默认被创建在 %USER_HOME% 目录下。要修改默认位置,在 %Maven_HOME%\conf 目录中的 Maven 的 settings.xml 文件中定义另一个路径。
3、中央仓库
Maven 中央仓库是由 Maven 社区提供的仓库,其中包含了大量常用的库。
中央仓库包含了绝大多数流行的开源Java构件,以及源码、作者信息、SCM、信息、许可证信息等。一般来说,简单的Java项目依赖的构件都可以在这里下载到。
中央仓库的关键概念:
- 这个仓库由 Maven 社区管理。
- 不需要配置。
- 需要通过网络才能访问。
4、依赖搜索顺序
七、生命周期
1、生命周期的概念
Maven的生命周期是对所有的构建过程进行抽象和统一。Maven的生命周期是抽象的,这意味着生命周期本身不做任何实际的工作,生命周期只是定义了一系列的阶段,并确定这些阶段的执行顺序。而在执行这些阶段时,实际的工作还是由插件来完成的。这种思想与设计模式中的模板方法非常相似。
Maven有三套相互独立的生命周期:
- Clean
-
- clean生命周期的目的是清理项目
-
- Default
-
- default生命周期的目的是构建项目
-
- site
-
- site生命周期的目的是建立项目站点。
-
2、完整生命周期
八、Maven的插件
九、Maven继承和聚合
1、继承的意义
继承就是避免重复,maven的继承也是这样,它还有一个好处就是让项目更加安全。比如我们在项目开发的过程中,可能多个模块独立开发,但是多个模块可能依赖相同的公共模块,比如说每个模块都需要javaseo-utils,在编译的时候,maven-compiler-plugin插件也要被引入,maven仓库地址以及发布目录都是相同的配置。我们可以使用Maven的继承功能,把公共的配置信息写到父模块中,子模块只要继承了该父模块,也会继承父模块的配置信息。
2、可继承的pom元素
groupId :项目组 ID ,项目坐标的核心元素;
version :项目版本,项目坐标的核心元素;
description :项目的描述信息;
organization :项目的组织信息;
inceptionYear :项目的创始年份;
url :项目的 url 地址
develoers :项目的开发者信息;
contributors :项目的贡献者信息;
distributionManagerment :项目的部署信息;
issueManagement :缺陷跟踪系统信息;
ciManagement :项目的持续继承信息;
scm :项目的版本控制信息;
mailingListserv :项目的邮件列表信息;
properties :自定义的 Maven 属性;
dependencies :项目的依赖配置;
dependencyManagement :醒目的依赖管理配置;
repositories :项目的仓库配置;
build :包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等;
reporting :包括项目的报告输出目录配置、报告插件配置等。
3、IDEA实现Maven的继承
以哈米音乐为例,所有的逻辑都在前台(使用者)、后台(管理员)、公共模块和音频图片模块
首先,创建父工程,父工程中不含任何代码,仅做依赖管理,使得项目能够产生继承和聚合关系,因此父工程的创建是MavenJava就可以,并且目录中仅有pom.xml,打包方式为pom。
在父工程下还有四个模块
(1)公共模块
公共模块只负责操作数据库,因此公共模块的创建为MavenJava
因为公共模块继承了父工程,因此GroupId和Version会继承父工程的逻辑,实现统一,不需要再另写
hami_core的pom.xml如下:
此时,父工程的pom.xml也发生了变化,我们发现多了一个<modules></modules>标签,而这个标签就体现了Maven的聚合
(2)后台模块
后台模块是管理员管理模块,因此后台模块的创建为MavenJavaWeb,创建成功之后,我们可以在后台模块的pom.xml中看到父工程、子项目项目名、打包方式、依赖等信息。
此时,我们发现父工程的pom.xml的<modules></modules>标签中又多了一个<module></module>,这代表后台模块也成功被聚合在了一起。
同时,由于继承关系,我们需要在后台模块的pom.xml中注入对公共模块的依赖,因为后台模块和公共模块已经成功被聚合在父工程里,所以这里我们注入依赖时,就不需要提前对公共模块进行打包,并且在项目最终打包时,只需要在父工程的pom.xml点击install,就可以把项目内的所有模块打包完成。
(3)前台模块
(4)图片服务器
此时,所有模块都已创建完毕,在父工程的pom.xml中所有模块都已被聚合
<dep..ment>的作用:一般在父工程中只做依赖管理,不做应用,而是在子工程中进行实际应用
6、properties属性的使用
通过 properties元素用户可以定义一个或多个 maven 属性,然后在 maven 的其他地方使用 ${属性名称} 的方式引用该属性,这种做法的意义在于消除重复和统一管理。比如,需要在多个地方重复声明同样的 SpringFramework 版本,现在只需要在一个地方声明就可以。