关于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