Maven【常见知识点速查】

时间:2024-01-18 13:09:38

文章更新时间:2020/04/10

一、为什么使用Maven这样的构建工具【why】

① 一个项目就是一个工程

  如果项目非常庞大,就不适合使用package来划分模块,最好是每一个模块对应一个工程,利于分工协作。借助于maven就可以将一个项目拆分成多个工程

② 项目中使用jar包,需要“复制”、“粘贴”项目的lib中

  同样的jar包重复的出现在不同的项目工程中,你需要做不停的复制粘贴的重复工作。借助于maven,可以将jar包保存在“仓库”中,不管在哪个项目只要使用引用即可就行。

③ jar包需要的时候每次都要自己准备好或到官网下载

  借助于maven我们可以使用统一的规范方式下载jar包,规范

④ jar包版本不一致的风险

  不同的项目在使用jar包的时候,有可能会导致各个项目的jar包版本不一致,导致未执行错误。借助于maven,所有的jar包都放在“仓库”中,所有的项目都使用仓库的一份jar包。

⑤ 一个jar包依赖其他的jar包需要自己手动的加入到项目中

  FileUpload组件->IO组件,commons-fileupload-1.3.jar依赖于commons-io-2.0.1.jar

  极大的浪费了我们导入包的时间成本,也极大的增加了学习成本。借助于maven,它会自动的将依赖的jar包导入进来。

二、maven是什么【what】

① maven是一款服务于java平台的自动化构建工具

  make->Ant->Maven->Gradle

  名字叫法:我们可以叫妹文也可以叫麦文,但是没有叫妈文的。

② 构建

  构建定义:把动态的Web工程经过编译得到的编译结果部署到服务器上的整个过程。

  编译:java源文件[.java]->编译->Classz字节码文件[.class]

  部署:最终在sevlet容器中部署的不是动态web工程,而是编译后的文件

Maven【常见知识点速查】

③ 构建的各个环节

  • 清理clean:将以前编译得到的旧文件class字节码文件删除
  • 编译compile:将java源程序编译成class字节码文件
  • 测试test:自动测试,自动调用junit程序
  • 报告report:测试程序执行的结果
  • 打包package:动态Web工程打War包,java工程打jar包
  • 安装install:Maven特定的概念-----将打包得到的文件复制到“仓库”中的指定位置
  • 部署deploy:将动态Web工程生成的war包复制到Servlet容器下,使其可以运行

三、安装maven

① 当前系统是否配置JAVA_HOME的环境变量

② 下载maven,解压maven放在一个非中文无空格的路径下

③ 配置maven的相关环境变量

  • 在环境变量增加M2_HOME,路径是maven解压后的根目录
  • 在环境变量里的path中增加maven/bin的目录

④ 验证:maven -v 查看maven版本

  看到版本信息,恭喜你已经OK了。

Maven【常见知识点速查】

四、maven项目结构解析

① 创建约定的目录结构(maven工程必须按照约定的目录结构创建)

根目录:工程名
|---src:源码
|---|---main:存放主程序
|---|---|---java:java源码文件
|---|---|---resource:存放框架的配置文件
|---|---test:存放测试程序
|---pom.xml:maven的核心配置文件

② 常用maven命令

  • mvn clean:清理
  • mvn compile:编译主程序
  • mvn test-compile:编译测试程序
  • mvn test:执行测试
  • mvn package:打包
  • mvn install:安装

  详细的maven执行流程戳这里查看~

PS:执行maven命令必须进入到pom.xml的目录中进行执行

仓库的默认位置:c:\Usrs[登录当前系统的用户名].m2\repository

五、仓库和坐标

① pom.xml

  Project Object Model 项目对象模型。它是maven的核心配置文件,所有的构建的配置都在这里设置。

② 坐标

  使用下面的三个向量在仓库中唯一的定位一个maven工程

Maven【常见知识点速查】

③ maven工程的坐标与仓库中路径的关系

Maven【常见知识点速查】

  PS:maven坐标和仓库对应的映射关系:[artifactId]-[version].jar

  例:ZHBF-USER-0.0.1-SNAPSHOT.jar

④ 仓库 仓库的分类:

1、本地仓库:

  当前电脑上的仓库,默认路径为:c:\Usrs[登录当前系统的用户名].m2\repository

2、远程仓库:

  • 私服:搭建在局域网中,一般公司都会有私服,私服一般使用nexus来搭建。具体搭建过程可以查询其他资料
  • *仓库:架设在Internet上,像刚才的springframework就是在*仓库上

六、依赖

① maven解析依赖信息时会到本地仓库中取查找被依赖的jar包

  • 对于本地仓库中没有的会去*仓库去查找maven坐标来获取jar包,获取到jar之后会下载到本地仓库
  • 对于*仓库也找不到依赖的jar包的时候,就会编译失败了

② 如果依赖的是自己或者团队开发的maven工程,需要先使用install命令把被依赖的maven工程的jar包导入到本地仓库中

  举例:现在我再创建第二个maven工程HelloFriend,其中用到了第一个Hello工程里类的sayHello(String name)方法。我们在给HelloFriend项目使用 mvn compile命令进行编译的时候,会提示缺少依赖Hello的jar包。怎么办呢?

  到第一个maven工程中执行 mvn install后,你再去看一下本地仓库,你会发现有了Hello项目的jar包。一旦本地仓库有了依赖的maven工程的jar包后,你再到HelloFriend项目中使用 mvn compile命令的时候,可以成功编译

③ 依赖范围

Maven【常见知识点速查】

scope就是依赖的范围

  • compile,默认值,适用于所有阶段(开发、测试、部署、运行),本jar会一直存在所有阶段。
  • provided,只在开发、测试阶段使用,目的是不让Servlet容器和你本地仓库的jar包冲突 。如servlet.jar。
  • runtime,只在运行时使用,如JDBC驱动,适用运行和测试阶段。
  • test,只在测试时使用,用于编译和运行测试代码。不会随项目发布。
  • system,类似provided,需要显式提供包含依赖的jar,Maven不会在Repository中查找它。

七、生命周期

  Maven有三套相互独立的生命周期,请注意这里说的是“三套”,而且“相互独立”,初学者容易将Maven的生命周期看成一个整体,其实不然。这三套生命周期分别是:

① Clean Lifecycle 在进行真正的构建之前进行一些清理工作。

  Clean生命周期一共包含了三个阶段:

  • pre-clean 执行一些需要在clean之前完成的工作
  • clean 移除所有上一次构建生成的文件
  • post-clean 执行一些需要在clean之后立刻完成的工作

② Default Lifecycle 构建的核心部分,编译,测试,打包,部署等等。

  • validate
  • generate-sources
  • process-sources
  • generate-resources
  • process-resources 复制并处理资源文件,至目标目录,准备打包
  • compile 编译项目的源代码
  • process-classes
  • generate-test-sources
  • process-test-sources
  • generate-test-resources
  • process-test-resources 复制并处理资源文件,至目标测试目录
  • test-compile 编译测试源代码
  • process-test-classes
  • test 使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署
  • prepare-package package 接受编译好的代码,打包成可发布的格式,如 JAR
  • pre-integration-test
  • integration-test
  • post-integration-test
  • verify
  • install 将包安装至本地仓库,以让其它项目依赖。
  • deploy 将最终的包复制到远程的仓库,以让其它开发人员与项目共享

那我们在Hello的项目中执行 mvn install 命令,通过日志看看中间经历了什么?

Maven【常见知识点速查】

通过日志我们发现,其实执行mvn install,其中已经执行了compile 和 test 。

总结:不论你要执行生命周期的哪一个阶段,maven都是从这个生命周期的开始执行

插件:每个阶段都有插件(plugin),看上面标红的。插件的职责就是执行它对应的命令。

③ Site Lifecycle 生成项目报告,站点,发布站点。

  • pre-site 执行一些需要在生成站点文档之前完成的工作
  • site 生成项目的站点文档
  • post-site 执行一些需要在生成站点文档之后完成的工作,并且为部署做准备
  • site-deploy 将生成的站点文档部署到特定的服务器上

八、maven工程的依赖特性

① 依赖的传递性

Maven【常见知识点速查】

项目结构:WebMavenDemo项目依赖JavaMavenService1 JavaMavenService1项目依赖JavaMavenService2

PS:pom.xml文件配置好依赖关系后,必须首先mvn install后,依赖的jar包才能使用。

  • WebMavenDemo的pom.xml文件想能编译通过,JavaMavenService1必须mvn install
  • JavaMavenService的pom.xml文件想能编译通过,JavaMavenService2必须mvn install

传递性:

Maven【常见知识点速查】

在Eclipse中,为JavaMavenService2中增加了一个spring-core.jar包后,会惊喜的发现依赖的两个项目都自动的增加了这个jar包,这就是依赖的传递性。

PS:非compile范围的依赖是不能传递的

② 依赖版本的原则:

1、路径最短者优先原则

Maven【常见知识点速查】

    Service2的log4j的版本是1.2.7版本,Service1排除了此包的依赖,自己加了一个Log4j的1.2.9的版本,那么WebMavenDemo项目遵守路径最短优先原则,Log4j的版本和Sercive1的版本一致。

2、路径相同先声明优先原则

Maven【常见知识点速查】

  这种场景依赖关系发生了变化,WebMavenDemo项目依赖Sercive1和Service2,它俩是同一个路径,那么谁在WebMavenDemo的pom.xml中先声明的依赖就用谁的版本。

③ 统一管理依赖的版本:

Maven【常见知识点速查】

  为了统一管理版本号,可以使用properties标签,里面可以自定义版本的标签名。在使用的地方使用${自定义标签名}

九、maven配置profile【一键切换环境信息】

  正式开发过程中,我们一个项目可能会存在多个环境的配置信息,比如dev(开发环境)、test(测试环境)、prod(生产环境)等等,那么如果每次配置我们都要重新修改文件后再打包,这样就很麻烦,我们可以借助maven的profile来对环境信息进行配置

1、配置前的准备

Maven【常见知识点速查】

    如上图,假设我们现在有3个环境,分别是dev、prod、test三个环境,数据库配置不一样,那么我们可以先在resources下新建一个文件夹,用于存放不同环境的个性化配置

Maven【常见知识点速查】

2、pom文件引入环境依赖打包插件

Maven【常见知识点速查】

<!--maven环境依赖打包插件-->
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<!-- 配置资源文件中的变量分隔符(标识符),这里配置了两种变量分隔符 -->
<delimiters>
<delimiter>${*}</delimiter> <!-- 以${}为分隔符,例如 ${spring.datasource.url} -->
<delimiter>$[*]</delimiter> <!-- 以$[]为分隔符,例如 $[spring.datasource.url] -->
</delimiters>
</configuration>
</plugin>

3、pom文件配置需要替换的文件信息

Maven【常见知识点速查】

PS:这里需要注意的一点是,图中的${active.profile}要和下一步配置的active.profile对应上才可以实现替换。

4、配置Maven Profiles的多个环境变量信息

Maven【常见知识点速查】

Maven【常见知识点速查】

<!--实现多环境配置打包-->
<profiles>
<!--开发环境-->
<profile>
<id>dev</id>
<properties>
<active.profile>dev</active.profile>
</properties>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
</profile>
<!--测试环境-->
<profile>
<id>test</id>
<properties>
<active.profile>test</active.profile>
</properties>
</profile>
<!--生产环境-->
<profile>
<id>prod</id>
<properties>
<active.profile>prod</active.profile>
</properties>
</profile>
</profiles>

5、修改主配置文件

Maven【常见知识点速查】

6、查看打包效果

  我们以test环境为例:

Maven【常见知识点速查】

Maven【常见知识点速查】