一 maven的安装
1 在镜像(https://mirrors.tuna.tsinghua.edu.cn/apache/)中下载指定的版本(注意,Maven 版本与IDE版本应保持匹配)。
2 解压之后需要进行配置
系统变量:M2_HOME:Maven安装路径
JAVA_HOME: JDK安装路径
path: %MAVEN_HOME%in (这样系统就可以在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 Filesmaven-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