api报错 javaee maven_JavaEE关于Maven的配置与学习

关于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文件，使用编辑器打开，然后修改里面的配置C:/...../localRepository

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

在setting.xml，我们可以看到下方有这一个项，这里只需要向里面添加代码

alimaven

central

aliyun maven

http://maven.aliyun.com/nexus/content/groups/public/

3. Maven仓库

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

但是，关于存放的位置还是有略微的区别，有远近之分，近的看来有本地仓库和私服远的有中央仓库和其他私人仓库本地仓库：通过本地存储依赖包，在项目构建需要时直接提供

私服：由个人/组织搭建，在局域网上的服务器运行，由该服务器提供依赖包

中央仓库：Maven依赖包的主要来源

其他私人仓库：需要使用的依赖包在他人服务器而不在在中央仓库没有的情况下，需要自己配置远程的仓库，它在中央仓库找不到下会去该仓库查找，其配置如下：

companyname.lib1

http://download.companyname.org/maven2/lib1

按照个人理解，画了一个图，如下：

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测试不通过导致的打包不成功，只需要添加下面的配置即可：

org.apache.maven.plugins

maven-surefire-plugin

2.4.2

true

其二：

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

javax.servlet

jsp-api

2.0

provided

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

compile

编译(compile)时需要，测试时需要，运行时需要，打包时需要

provided

编译(compile)时需要，测试(test)时也需要   ，运行时不需要，打包时不需要

runtime

编译时不需要，测试时需要，运行时需要，打包时需要

test

编译时不需要，测试时需要，运行时不需要，打包也不需要

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

6. 总结

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