maven的安装与配置使用

 一  maven的安装

1 在镜像（https://mirrors.tuna.tsinghua.edu.cn/apache/）中下载指定的版本（注意，Maven 版本与IDE版本应保持匹配）。

2 解压之后需要进行配置

系统变量：M2_HOME：Maven安装路径

JAVA_HOME： JDK安装路径

path：  %MAVEN_HOME%\bin  （这样系统就可以在cmd环境下执行mvn命令了）

打开 cmd，在里面敲：mvn -v 可以看到正常版本信息，则表明配置成功。

接着，可以在cmd环境下输入命令：  mvn help:system  这样Maven就会不断的从网络上下各种一来文件。

3 在Eclipse中安装配置Maven

1) 基本配置

preferences -> maven -> local ...  ;  user....

十分简单的。。。主要是配置Maven 的安装路径，settings.xml的路径。

2）m2e插件的扩展配置

前面两步只是完成了Maven的基本绑定，如若想要在Eclipse中正常使用前面所绑定的Maven，则必须安装一个小插件——m2e插件，该插件起到衔接Eclipse与Maven的作用。安装步骤如下：

1）打开eclipse，菜单“Help”-“Install New Software...”

2）在Work with 地址栏输入：http://download.eclipse.org/releases/neon （注意：neon是eclipse对应的版本名称）。

3）在filter框中输入maven便能定位要安装的插件Maven Integration for Eclipse，选中之后点击next按钮进行安装步骤。

4）安装完成重启eclipse，菜单：Window --> preferences ，输入maven进行相关设置。

注：起初我所使用的Eclipse版本为 eclipse-jee-mars-1-win32-x86_64.zip，后来发现 eclipse-jee-mars-2-win32-x86_64.zip 已经集成了诸多必要的插件。因此建议安装mar2版本，这样可以省去很多时间和精力。

3)查找jar包

直接去 官  网 中搜索jar包的名称，即可使用官网所提供的maven坐标，添加到pom文件中即可。

二 maven的重要概念

1 基本组织规范

Maven采用了预定优于配置(Convention over Configuraion, COC) 原则，根据此原则，Maven 的主要预定有以下几条。

源代码应该位于${basedir}/src/main/java 路径下

资源文件应该位于${basedir}/src/main/resources路径下

测试代码应该位于${basedir}/src/test路径下

编译生成的class文件应该位于${basedir}/target/classes路径下。

项目应该会产生一个JAR文件，并将生成的JAR包放在${basedir}/target路径下。

2 Maven的生命周期(lyfecycle)

默认的声明周期包含以下几个核心阶段。

compile 编译项目

test 单元测试

package 项目打包

install 安装到本地仓库

deploy 部署到远程仓库

3 Maven坐标

pom.xml文件成为项目的对象模型（Project Object Model）描述文件。POM为项目提供了一个Maven坐标，也被成为唯一标识符，由以下四个元素组成（Maven坐标通常用英文冒号作为分隔符来书写）。

<groupId>   命名空间  ： <artifactId>  项目名 ： <packaging>  打包类型 ： <version> 项目版本  。

4 资源库Repository

第一次运行Maven时，Maven会自动从远程资源库下载许多文件，包括各种Maven插件，以及项目所依赖的库。实际上，初始的Maven 工具非常的小，这是因为Maven本身的功能非常有限。几乎所有的功能是由Maven插件完成的。实际上Maven类似前端的Gulp工具。主要利用配置文件完成包管理功能。Maven所依赖的包都会保存在资源库中。Maven资源库可分为三种：

本地资源库(Local  Repository）  可在setting.xml中进行配置。

远程资源库 通常由公司或团队进行集中维护。目的是为了让全公司的项目使用相同的JAR包系统。

中央资源库（默认）：由Mavwn官方维护。包含各种公开的Maven插件及第三方项目。地址为http://repo.maven.org/maven3

当Maven需要使用某个插件或JAR包时，MAVEN的搜索顺序为：本地资源库  —> 远程资源库 —> 中央资源库。

一般情况下，第一次运行后，从远程或中央资源库加载的资源会保存在本地资源库目录中，下次需要时会直接从本地资源库中提取。

此外，远程镜像也可以纳入远程资源库的范畴。可以在<mirror>元素或<profile>元素中进行配置远程资源库的路径。

5 依赖管理

POM包含的<dependency/>元素定义了一个依赖框架或依赖类库。Maven依赖管理具有传递性，有时需要使用<exclusions...>子元素排除指定的依赖。例如：

<dependency>

　　<groupId>javax.activation</groupId>

　　<artifactId>mail</artifactId>

<type>jar</type>

　　<exclusions>

　　　　<artifactId>activation</artifactId>

　　　　<groupId>javax.activation</groupId>

　　</exclusions>

<dependency/>

上面的配置指定该项目依赖 mail.jar，由于Maven的依赖具有传递性，因此会自动加载activation.jar进来。为了将activation.jar排除出去，即可在<exclusions>标签中进行指定。

三  maven的基本配置

修改安装目录的conf/settings.xml 与 用户目录.m2/settings.xml。主要涉及两个地方，一是镜像mirror 的配置；另外一个是local repository的配置。

1 修改maven 的settings.xml中的镜像配置，默认配置下载速度简直是龟速，可以修改为aliyun镜像。

<mirrors>
<!-- mirror
<mirror>
<id>mirrorId</id>
<mirrorOf>repositoryId</mirrorOf>
<name>Human Readable Name for this Mirror.</name>
<url>http://my.repository.com/repo/path</url>
</mirror>
-->
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>*</mirrorOf>
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>
</mirrors>

2 local repository的配置

这个目录可以使得maven所下载的jar包存储在指定的目录下，默认是存储在用户目录下，这样占据了C盘的空间，不太好。

<localRepository>D:\Program Files\maven-repository</localRepository>

3  使用注意事项

如果Jar包下载到本地之后下载一半没有成功，需要删除整个的repository的内容，然后重启使用run as maven install下载。下载完成之后，需要使用maven update project进行更新。

四 maven的运行错误

1 报错 ：

Plugin execution not covered by lifecycle configuration: org.codehaus.mojo:aspectj-maven-plugin:2.6.1:compile (execution: default, phase: compile)

官网解释为这是一个 M2E_plugin_execution_not_covered 类型的错误。解决方法不止一个，这个方法来的比较快：

在plugins标签外加上 <pluginManagement> 标签即可。这种方法的最大弊端是需要修改文件，如果有多个项目则每一个项目的POM文件都需要进行修改，此外，还会影响版本管理。

另外一种较为直接彻底的方法是：在 Windows -> Preferences -> Maven -> LyfeCycleMapping中查看文件目录E:/eclipse_new/.metadata/.plugins/org.eclipse.m2e.core/lifecycle-mapping-metadata.xml

实际上这个目录下没有这个文件，所以需要去拷贝一个模板文件来进行适当的修改。

接着，需要到eclipse的安装目录下的plugins下的org.eclipse.m2e.lifecyclemapping.defaults_xxxxxx.jar文件中找到该文件。

将其中的lifecycle-mapping-metadata.xml拷贝出来进行加工，加入以下xml内容：

<pluginExecution>
	<pluginExecutionFilter>
		<groupId>org.codehaus.mojo</groupId>
		<artifactId>aspectj-maven-plugin</artifactId>
		<versionRange>[1.9,)</versionRange>
		<goals>
			<goal>compile</goal>
		</goals>
	</pluginExecutionFilter>
	<action>
		<ignore />
	</action>
</pluginExecution>

　　这里的 [1.9,) 主要是因为POM中配置了1.9版本的插件。E:/eclipse_new/.metadata/.plugins/org.eclipse.m2e.core/这个目录下的lifecycle-mapping-metadata.xml文件只是在初始化时会下载插件，下载完之后（保存在本地 maven repository 仓库目录中）就不会使用到这个文件了。

2 报错：

[ERROR] No compiler is provided in this environment. Perhaps you are running on a JRE rather than a JDK?

原因：eclipse默认是运行在jre上的，但是maven插件需要使用jdk，因此需要在eclipse修改Installed JRES。

解决方法：【Window】-->【Prefrences】-->【Java】-->【Installed JREs】修改为jdk即可。

3 报错

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

在官网中搜索nop，取得maven配置：

<!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-nop -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-nop</artifactId>
    <version>1.7.21</version>
    <scope>test</scope>
</dependency>

结果就报错了。

解决方法：

把 <scope>test</scope> 注释掉就OK了。

五 利用maven添加和查看第三方框架源码与文档

1 先添加下载功能

默认情况下，Maven 只会选择下载项目运行所必要的jar包，不会下载第三方框架所对应的源码和文档jar包。因此需要在Eclipse中对Maven进行设置。具体方法为：

在eclipse中进入windows -> preferences -> Maven 选项，然后查看右侧 菜单来中 找到 Download Artifact Sources  选项勾选；如果想要下载JavaDOC  则勾选 DownloadArtifact JavaDOC 选项。点击apply  并确定。设置完成之后，就可以在maven install时下载所需的第三方框架源码包和文档jar包。

2 在Eclipse中设置文件路径

默认情况下，Eclipse不会绑定源码和文档的jar包路径。因此，想要查看这些框架的源码和注释，还需设置这些jar包的文件路径。具体方法为：

鼠标选中Eclipse 中 Maven 依赖的jar包（这里指的是你所想要看其源码和注释的目标jar包）。然后右键选择 Properties，分别设置 Source Attachment 与 Java doc location 的 jar 包的绝对路径即可。

AJDT插件的安装

http://download.eclipse.org/tools/ajdt/45/dev/update

参考：

[1]  http://www.cnblogs.com/wbyp/p/6381259.html

[2]  http://blog.csdn.net/xxd851116/article/details/25197373

[3]  http://www.bubuko.com/infodetail-743907.html