Maven 的安装与配置

最近公司需要新起一个项目，想使用maven+springmvc+spring+mybatis+mysql实现，以前我们的项目都是传统的老项目，没用过maven，Eclipse版本是GALILEO的，有点老，没有自带maven，只能先安装插件了，ok，开始工作：

一、下载安装Maven

Maven 下载地址：http://maven.apache.org/download.cgi

安装 Maven 之前要求先确定你的 JDK 已经安装配置完成。Maven 是 Apache 下的一个项目，首先去官网下载 Maven。

下载完成之后将其解压，我将解压后的文件夹重命名成 maven，并将它放在 D:\ 目录下，即 maven 最终的路径是：D:\maven。

二、配置环境变量

添加系统变量：MAVEN_HOME = D:\maven

系统变量path里面添加：%MAVEN_HOME%\bin;

相信大家都有配过环境变量的，详细步骤就不说了，对着把属性名和属性值配上的OK了。

打开 cmd，在里面敲：mvn -version

mvn 是 mavn 的一个指令，mvn -version 是查看版本信息，我公司电脑的操作系统是 32位的 WIN7，安装的 maven 是 3.0.4，如果能打印如上信息，说明到此 Maven 已经在你的电脑上安装完成。

注意：其实环境变量的配置是为了不用进入软件的安装bin目录就能在命令行根目录直接调用相关命令，除了JDK需要提供Java软件环境需要配置外，其他软件可以不用配置。

三、修改Maven配置文件

找到 maven 下的 conf 下的 settings.xml 配置文件，我的是在 D:\maven\conf\settings.xml，maven 的仓库默认是放在本地用户的临时文件夹（一般是在C盘）下面的 .m2 文件夹下的 repository 下，现在我们来修改将它指定到我们自己的路径下，我现在要将仓库指定到 D:\maven\repository 目录下，只需要将上面注销的本地仓库打开，然后把相应的路径值写到里面去就行了：

为了下载速度快一点，把镜像地址改一下，改成阿里云maven私服

 <mirrors>

    <!-- mirror

     | Specifies a repository mirror site to use instead of a given repository. The repository that

     | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used

     | for inheritance and direct lookup purposes, and must be unique across the set of mirrors.

     |

    <mirror>

      <id>mirrorId</id>

      <mirrorOf>repositoryId</mirrorOf>

      <name>Human Readable Name for this Mirror.</name>

      <url>http://my.repository.com/repo/path</url>

    </mirror>

     -->

    <!--默认是从maven官方仓库下载的，添加下面这段代码可以改为阿里云私服，速度能快一点-->

    <mirror>

      <id>nexus-aliyun</id>

      <mirrorOf>*</mirrorOf>

      <name>Nexus aliyun</name>

      <url>http://maven.aliyun.com/nexus/content/groups/public</url>

    </mirror>

  </mirrors>

OK，先来体会一下 maven，在 cmd 中敲并回车执行：mvn help:system 这时候 maven 就会从远程仓库开始下载一大堆的东西，没事，让它下载着，迟早都要下载的，接下来是在 eclipse 中安装 maven 插件。

四、Eclipse中安装Maven插件

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

2. 在Work with 地址栏输入：http://download.eclipse.org/releases/juno （注意：juno是eclipse对应的版本名称，我们公司的galileo版本的eclipse搜不出maven插件，这里就先用juno版本进行演示了）。

3. 在filter框中输入maven便能定位要安装的插件。

4. 选择“Collaboration”-“m2e - Maven Integration for Eclipse"，并点击next按钮进行安装步骤。

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

安装插件的时候很容易失败：

但是这样做很可能会遇到这样的问题cannot complete the install because one or more required items could not be found。原因应该是缺少安装Maven插件所依赖的另一些jar包，可能由于国内网络的限制，这种在线插件安装的方式基本成功不了。因为Mars之后的Eclipse版本自带了对Maven的支持，所以最好的办法就是升级你的Eclipse或者重新下一个新版本Eclipse。

我尝试了好多次，我的galileo版本的eclipse始终无法装上maven插件，所以我直接下载了一个最新版的neon版本的eclipse，自带了对Maven的支持。但是因为我们用的还是jdk1.6，而下载的最新的neon版本的eclipse不支持jdk1.6，需要换一下电脑环境变量里面配的那个jdk的版本，编译的时候可以使用jdk1.6，也就是说eclipse启动和编译不需要使用统一个jdk的，即开发用的jdk和eclipse启动使用的jdk不冲突，这样有点麻烦，所以我还是重新下载了一个luna版本的eclipse，luna版本也自带了对maven的支持，直接省略了maven插件安装这一步。

另外还可以使用link方式离线安装 maven 插件。这种方式可拔性更好，可以随时将插件插上和拔下，非常方便。

首先需要下载maven 插件的离线安装包，官网并不提供 maven 插件的离线安装包，我找了下没找到，所以没用这种方法，但先做个记录，万一以后要用呢。

1. 在你的 eclipse 安装的根目录下创建两个文件夹：links，myplugins（名字可以随便取），我的这两个文件夹位于：D:/eclipse/（作为参考，下面用到）

2. 将下载的 eclipse-maven3-plugin.7z 解压缩到 myplugins 目录下

3. 在 links 目录下创建一个 maven.txt（名字可以随便取），打开并输入：path=D:/eclipse/myplugins/maven（请参照上面对应你的 maven 插件）

4. 保存关闭 maven.txt，并将后缀改成 maven.link，重启 eclipse（如果你的 eclipse 没有开着，直接打开就行）

五、Eclipse中配置Maven

检查 eclipse 的 maven 插件是否安装成功：Window --> Preferences，如果出现Maven的目录表示eclipse的maven插件安装成功了

1. 点击 Add 按钮，选到你本机安装 maven 的路径值

2. 点击 Browse 按钮，选到你 maven 的 setting.xml 配置文件，然后点击 OK，这样就完成了 eclipse 的 maven 插件的配置

接下来就可以在eclipse中新建一个Maven项目了！

注意：

Eclipse 一直提示 updating maven dependencies

问题描述：因为jar包的修改，所以Maven需要更新，一启动Eclipse之后，自动更新，由于Maven的架包很多download不下来，就一直卡着的样子，很长时间，什么都做不了。

解决办法：Eclipse的Window---->Preferences---->Maven---->Download repository index updates on startup 这个选项不要选择（之前应该是默认选择的）。

3、使用maven打包

六、maven相关知识

从CVS或SVN上check out 项目后将普通项目转为maven项目

选中项目--右键--Configure--Convert to Maven Project

maven2目录结构

src/main/java 　　　　源文件（不包含测试）
src/main/resources 　　资源文件（.xml,.properties,ftl等等）
src/main/webapp 　　　Web根目录
src/test/java 　　　　测试源文件
src/test/resources 　　测试资源文件（.xml,.properties,ftl等等）
src/site 　　　　　　　生成站点的目录
target/classes 　　　　src/main/java目录下源文件编译出来.class文件
target/test-classes 　　 src/test/java目录下源文件编译出来.class文件
target 　　　　　　　构建过程中的临时目录，构建包会生成在这里

Apache Maven 是做什么用的？

Maven 是一个项目管理和构建自动化工具。但是对于我们程序员来说，我们最关心的是它的项目构建功能。所以这里我们介绍的就是怎样用 maven 来满足我们项目的日常需要。
Maven 使用惯例优于配置的原则。它要求在没有定制之前，所有的项目都有如下的结构：

一个 maven 项目在默认情况下会产生 JAR 文件，另外，编译后的 classes 会放在 ${basedir}/target/classes 下面， JAR 文件会放在 ${basedir}/target 下面。

POM (Project Object Model)

POM全称：Project Object Model 项目对象模型(POM)，一个项目所有的配置都放置在 POM 文件中。

主要定义项目的信息：项目关系定义(项目坐标，依赖关系等)，项目的描述信息(Licenses,developers等)，项目的自定义构建行为(比如插件，路径等)，项目的构建环境(仓库，profiles等)。

在 POM 中，groupId，artifactId，packaging，version 叫作 maven 坐标，它能唯一的确定一个项目。有了 maven 坐标，我们就可以用它来指定我们的项目所依赖的其他项目、插件或者父项目。一般 maven 坐标写成这样的格式：groupId:artifactId:packaging:version。大项目一般会分成几个子项目。在这种情况下，每个子项目就会有自己的 POM 文件，然后它们会有一个共同的父项目。这样只要构建父项目就能够构建所有的子项目了。子项目的 POM 会继承父项目的 POM。另外，所有的 POM都继承了一个 Super-POM。Super-POM 设置了一些默认值，比如默认的目录结构，默认的插件等等，它遵循了惯例优于配置的原则。你看见的这个 POM 只是很简单的一部分，运行时候的 POM 要复杂的多。如果你想看到运行时候的 POM 的全部内容的话，可以运行下面的命令：$mvn help:effective-pom

Maven插件

用 mvn archetype:generate 命令来生成一个项目。那么这里的 archetype:generate 是什么意思呢？archetype 是一个插件的名字，generate是目标(goal)的名字。这个命令的意思是告诉maven 执行 archetype 插件的 generate 目标。插件目标通常会写成 pluginId:goalId。一个目标是一个工作单元，而插件则是一个或者多个目标的集合。比如说Jar插件，Compiler插件，Surefire插件等。从看名字就能知道，Jar 插件包含建立Jar文件的目标， Compiler 插件包含编译源代码和单元测试代码的目标。Surefire 插件的话，则是运行单元测试。看到这里，估计你能明白了，mvn 本身不会做太多的事情，它不知道怎么样编译或者怎么样打包。它把构建的任务交给插件去做。插件定义了常用的构建逻辑，能够被重复利用。这样做的好处是，一旦插件有了更新，那么所有的 maven 用户都能得到更新。

Maven生命周期

我们用的第二个命令是：mvn package。这里的 package 是一个maven的生命周期阶段 (lifecycle phase )。生命周期指项目的构建过程，它包含了一系列的有序的阶段 (phase)，而一个阶段就是构建过程中的一个步骤。

那么生命周期阶段和上面说的插件目标之间是什么关系呢？插件目标可以绑定到生命周期阶段上。一个生命周期阶段可以绑定多个插件目标。当 maven 在构建过程中逐步的通过每个阶段时，会执行该阶段所有的插件目标。

maven 能支持不同的生命周期，但是最常用的是默认的Maven生命周期 (default Maven lifecycle )。如果你没有对它进行任何的插件配置或者定制的话，那么上面的命令 mvn package 会依次执行默认生命周期中直到包括 package 阶段前的所有阶段的插件目标：

process-resources 阶段：resources:resources
compile 阶段：compiler:compile
process-classes 阶段：(默认无目标)
process-test-resources 阶段：resources:testResources
test-compile 阶段：compiler:testCompile
test 阶段：surefire:test
prepare-package 阶段：(默认无目标)
package 阶段：jar:jar

Maven依赖管理

之前我们说过，maven 坐标能够确定一个项目。换句话说，我们可以用它来解决依赖关系。在 POM 中，依赖关系是在 dependencies 部分中定义的。在下面的 POM 例子中，我们用 dependencies 定义了对于 junit 的依赖：
Xml 代码

 <dependencies>

 　　<dependency>

 　　　　<groupId>junit</groupId>

 　　　　<artifactId>junit</artifactId>

 　　　　<version>3.8.1</version>

 　　　　<scope>test</scope>

 　　</dependency>

 </dependencies>

那这个例子很简单，但是实际开发中我们会有复杂得多的依赖关系，因为被依赖的 jar 文件会有自己的依赖关系。那么我们是不是需要把那些间接依赖的 jar 文件也都定义在POM中呢？答案是不需要，因为 maven 提供了传递依赖的特性。所谓传递依赖是指 maven 会检查被依赖的 jar 文件，把它的依赖关系纳入最终解决的依赖关系链中。针对上面的 junit 依赖关系，如果你看一下 maven 的本地库~/.m2/repository/junit/junit/3.8.1/ ，你会发现 maven 不但下载junit-3.8.1.jar，还下载了它的 POM 文件。这样 maven 就能检查 junit 的依赖关系，把它所需要的依赖也包括进来。

在 POM 的 dependencies 部分中，scope 决定了依赖关系的适用范围。

我们的例子中 junit 的 scope 是 test，那么它只会在执行 compiler:testCompile and surefire:test 目标的时候才会被加到 classpath 中，在执行compiler:compile 目标时是拿不到 junit 的。

我们还可以指定 scope 为 provided，意思是 JDK 或者容器会提供所需的jar文件。比如说在做web应用开发的时候，我们在编译的时候需要 servlet API jar 文件，但是在打包的时候不需要把这个 jar 文件打在 WAR 中，因为servlet容器或者应用服务器会提供的。

scope 的默认值是 compile，即任何时候都会被包含在 classpath 中，在打包的时候也会被包括进去。

Maven库

当第一次运行 maven 命令的时候，你需要 Internet 连接，因为它要从网上下载一些文件。那么它从哪里下载呢？它是从 maven 默认的远程库 (http://repo1.maven.org/maven2) 下载的。这个远程库有 maven 的核心插件和可供下载的 jar 文件。但是不是所有的 jar 文件都是可以从默认的远程库下载的，比如说我们自己开发的项目。这个时候，有两个选择：要么在公司内部设置定制库，要么手动下载和安装所需的jar文件到本地库。
本地库是指 maven 下载了插件或者 jar 文件后存放在本地机器上的拷贝。在 Linux 上，它的位置在 ~/.m2/repository，在 Windows XP 上，在 C:\Documents and Settings\username\.m2\repository ，在 Windows 7 上，在 C:\Users\username\.m2\repository。本人的在C:\Users\Administrator\.m2。当 maven 查找需要的 jar 文件时，它会先在本地库中寻找，只有在找不到的情况下，才会去远程库中找。
运行下面的命令能把我们的 helloworld 项目安装到本地库：
$mvn install
一旦一个项目被安装到了本地库后，你别的项目就可以通过 maven 坐标和这个项目建立依赖关系。比如如果我现在有一个新项目需要用到 helloworld，那么在运行了上面的 mvn install 命令后，我就可以如下所示来建立依赖关系：
Xml 代码

 <dependency>

     <groupId>com.mycompany.helloworld</groupId>

     <artifactId>helloworld</artifactId>

     <version>1.0-SNAPSHOT</version>

 </dependency>