关于Maven的配置与学习
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
的最前端就可以了,如下图:
通过以上的配置在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>
按照个人理解,画了一个图,如下:
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命令,有些命令可以同时键入,比如: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