关于Maven的配置与学习

时间:2023-01-01 03:14:24

1. 简介

官方说法:Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information.

个人译文:Apache Maven是一款软件项目管理及综合工具。基于项目对象模型这个概念,Maven能够从一个中心信息块管理项目的构建,报告和文档。

个人对于Maven的直观感受就是工程项目被生命化了,从一个项目的初始到开发结束,它都在帮助开发者做后援工作,相当于助长剂。对于我来说主要的是项目依赖问题,不用自己去拷jar包确实是方便许多。

2. Windows下安装和配置

某些IDE已经是集成了Maven了(例如:idea),但是这里还是说一下怎么从官网下载并且配置环境变量

2.1 下载Maven

Maven官网:https://maven.apache.org/

进入官网后可以点击Download下拉可见有多个下载链接。如果不是特殊爱好/用途,下载头两个压缩包其中一个解压就可以。

2.2 配置Maven

解压后进入我的电脑(右击)->属性->高级系统设置->环境变量,进入后点击新建..,变量名为M2_HOME,变量值为自己解压后Maven的位置,我这里为C:\tool\apache-maven-3.5.0

经过上面的配置变量已经有了,但是还需要配置Windows系统变量,这样才找的到Maven的路径(在cmd模式下使用mvn命令),这里只需要将%M2_HOME%\bin;加入到Path的最前端就可以了,如下图:

关于Maven的配置与学习

通过以上的配置在cmd下键入mvn -version出来一大串信息,包括Maven路径、版本等信息就说明配置成功

2.3 配置Maven镜像和本地仓库

本地仓库会从把从别的地方的jar包下载后本地保存,相当于一个缓存,如果说不配置它默认会下载至${user.home}/.m2/repository,如果需要配置到一个特定的目录只需要进入Maven的解压目录/conf/setting.xml文件,使用编辑器打开,然后修改里面的配置<localRepository>C:/...../localRepository</localRepository>

在使用Maven管理依赖时,它可能会去别的仓库下载jar包,有可能网速会受到限制,所以使用镜像下载是一个比较好的选择,这里我使用了阿里的镜像。

setting.xml,我们可以看到下方有<mirrors></mirrors>这一个项,这里只需要向里面添加代码

<mirror>
<id>alimaven</id>
<mirrorOf>central</mirrorOf>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
</mirror>

3. Maven仓库

关于Maven的仓库这里可以简单的理解为存放jar包的地方,一个云盘。

但是,关于存放的位置还是有略微的区别,有远近之分,近的看来有本地仓库私服远的有*仓库其他私人仓库

  • 本地仓库:通过本地存储依赖包,在项目构建需要时直接提供
  • 私服:由个人/组织搭建,在局域网上的服务器运行,由该服务器提供依赖包
  • *仓库:Maven依赖包的主要来源
  • 其他私人仓库:需要使用的依赖包在他人服务器而不在在*仓库没有的情况下,需要自己配置远程的仓库,它在*仓库找不到下会去该仓库查找,其配置如下:
<repositories>
<repository>
<id>companyname.lib1</id>
<url>http://download.companyname.org/maven2/lib1</url>
</repository>
</repositories>

按照个人理解,画了一个图,如下:

关于Maven的配置与学习

4. Maven的生命周期

4.1 clean周期

周期阶段 具体描述
pre-clean 执行一些清理前需要完成的工作
clean 清理上一次构建生成的文件
post-clean 执行一些清理后需要完成的工作

在每一个周期有相应的Maven命令,比如,在重新构建项目需要把前面的清除,则可以在当前项目目录下cmd模式输入mvn clean || mvn post-clean

4.2 default周期

在default周期中包含了很多个阶段,其中这里列出比较常用的

周期阶段 具体描述
compile 编译该项目的源代码
test 运行测试使用合适的单元测试框架
package 提取编译后的代码,并在其分发格式打包,如JAR,WAR或EAR文件
install 将包安装到本地存储库,它可以用作当地其他项目的依赖
deploy 复制最终的包到远程仓库与其他开发者和项目共享

关于install,可以使用mvn install命令将我们自己的项目添加/安装到我们的本地仓库,比如,我们在多模块开发时,因为项目的依赖有些模块是完全相同的,所以我们可以建立一个父工程,让其他相关的模块继承该父工程。父工程的打包方式是pom,这里在子工程中编译项目时就会遇到父工程依赖不存在的一些错误,这时就需要使用上述的命令mvn install将我们的项目安装到本地仓库。对于Maven工程,自己写的库需要打成jar包让其他项目依赖,也可以使用该命令

4.3 site周期

siet生命周期能够生成一些网页信息(基于POM所包含的信息)

周期阶段 具体描述
pre-site 执行一些在生成项目站点之前需要完成的工作
site 生成项目站点文档
post-site 执行一些在生成项目站点之后需要完成的工作
site-deploy 将生成的项目站点发布到服务器上

当我使用之前博客上的Spring Boot会员系统测试site命令时 执行了mvn site可在项目路径下看到target/site/index.html,点开后有关于该项目的各种依赖的详细信息,如下图:

关于Maven的配置与学习

在上述的周期中对应着各种Maven命令,有些命令可以同时键入,比如:mvn clean package,每个命令的执行都与Maven提供的插件有着一些密不可分的关系,这里可以看下这里的链接:

https://www.yiibai.com/maven/maven_build_life_cycle.html

https://blog.csdn.net/chaofanwei/article/details/36197183

https://www.cnblogs.com/build-up/p/4975827.html

https://www.cnblogs.com/avivaye/p/5341341.html

5. 项目开发中的Exception

这里举出两个例子,其一:

maven打包时报错:Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.5:test

这里可能是因为在打包时会自动执行测试命令,而Junit测试不通过导致的打包不成功,只需要添加下面的配置即可:

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.4.2</version>
<configuration>
<skipTests>true</skipTests>
</configuration>
</plugin>

其二:

在web项目中使用servlet和jsp时需要引入依赖来解决错误,但是在web发布时打成war包部署到tomcat就会报错,提示信息大概是类之间有冲突。这是因为tomcat已经有包含了servlet的依赖包,因此报错,这里只要在servlet和jsp的依赖中加入一个scope配置,如下:

<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
<scope>provided</scope>
</dependency>

在上面的依赖的scope中包含了几个选项,主要如下:

分类 使用范围
compile 编译(compile)时需要,测试时需要,运行时需要,打包时需要
provided 编译(compile)时需要,测试(test)时也需要 ,运行时不需要,打包时不需要
runtime 编译时不需要,测试时需要,运行时需要,打包时需要
test 编译时不需要,测试时需要,运行时不需要,打包也不需要

除了以上还有一个是system,但是个人没有怎么使用所以这里不做说明

6. 总结

关于以上的东西,个人在见解上可能还存在偏差,但是,Maven作为项目管理的一个工具,只需要把工具的主要功能发挥出来就行了。现在该要纠结的不应该是Maven存在的那些复杂的东西,而是把自己的代码写好先

参考链接

https://maven.apache.org

https://www.yiibai.com/maven/

https://baike.baidu.com/item/Maven/6094909?fr=aladdin

https://blog.csdn.net/zjf280441589/article/details/53044308

https://www.cnblogs.com/li3807/p/6416197.html