Maven实战一：Maven的安装与配置

Maven实战一：Maven的安装与配置

一、安装Maven

1.检查JDK安装

Maven3.3需要JDK7或以上版本

打开命令行：
C:\Users\huhu>echo %JAVA_HOME%
D:\dev\Java\jdk1.8.0_92

C:\Users\huhu>java -version
java version “1.8.0_92”
Java(TM) SE Runtime Environment (build 1.8.0_92-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.92-b14, mixed mode)

2.下载Maven

https://maven.apache.org/download.cgi

下载apache-maven-3.3.9-bin.zip及其源码apache-maven-3.3.9-src.zip

3.本地安装

(1)解压

解压到D:\dev\maven
即其安装目录为：D:\dev\maven\apache-maven-3.3.9

(2)设置环境变量：

M2_HOME: D:\dev\maven\apache-maven-3.3.9

将其到Path末尾：
;%M2_HOME%\bin

打开新的命令行：
C:\Users\huhu>echo %M2_HOME%
D:\dev\maven\apache-maven-3.3.9

C:\Users\huhu>mvn -v
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:47+08:00)
Maven home: D:\dev\maven\apache-maven-3.3.9
Java version: 1.8.0_92, vendor: Oracle Corporation
Java home: D:\dev\Java\jdk1.8.0_92\jre
Default locale: zh_CN, platform encoding: GBK
OS name: “windows 7”, version: “6.1”, arch: “amd64”, family: “dos”

(3)升级Maven

下载新的Maven，解压至D:\dev\maven，然后使用其完整的目录更新M2_HOME环境变量。

同理，如果需要使用某一个旧版本的Maven，也只需要编辑M2_HOME环境变量指向旧版本的安装目录。

二、安装目录分析

1.M2_HOME

M2_HOME环境变量指向Maven的安装目录。该安装目录的结构和内容：
bin
boot
conf
lib
LICENSE
NOTICE
README.txt

bin：
包含mvn运行的脚本，这些脚本用来配置Java命令，准备好classpath和相关的Java系统属性，然后执行Java命令。
mvn和mvnDebug的区别和关系：
两者内容基本一样，只是mvnDebug中多了一条MAVEN_DEBUG_OPTS=”$MAVEN_DEBUG_OPTS”的配置，其作用是在运行Maven时开启debug，以便测试Maven本身。
m2.conf：是classworlds的配置文件

boot：
只包含一个文件plexus-classworlds-2.5.2.jar，
plexus-classworlds是一个类加载器框架，相对于默认的Java类加载器，它提供了更丰富的语法以方便配置，Maven使用该框架加载自己的类库。

conf：
包含一个非常重要的文件：settings.xml
直接修改该文件，就能在机器上的全局地定制Maven的行为。
一般情况下，我们更偏向于复制该文件到~/.m2/目录下，然后修改该文件，在用户范围内定制Maven的行为。

lib：
包含了所有Maven运行时需要的Java类库。
lib目录就是真正的Maven。
用户可以在该目录中找到Maven内置的超级POM。

2.~/.m2

执行一条简单的命令: mvn help:system
该命令会打印出所有的Java系统属性和环境变量。

运行这条命令的目的是让Maven执行一个真正的任务，
从命令行输出可以看到Maven会从远程仓库下载一大堆东西，包括mavne-help-plugin，包括pom文件和jar文件。这些文件都被下载到了Maven本地仓库中。

在当前用户目录下可以发现.m2文件夹。默认情况下，该文件夹下放置了Maven本地仓库./m2/repository。
所有的Maven构件都被存储到该仓库中，以方便重用。
可以到~/.m2/repository/org/apache/maven/plugins/maven-help-plugins/目录下找到刚才下载的maven-help-plugins的pom文件和jar文件。

Maven根据一套规则来确定任何一个构件在仓库中的位置。由于Maven仓库是通过简单文件系统透明地展示给Maven用户的，有些时候可以绕过Maven直接查看或修改仓库文件。

在默认情况下，~/.m2目录下除了repository仓库之外就没有其他目录和文件了，不过大多数Maven用户需要复制M2_HOME/conf/settings.xml文件到~/.m2/settings.xml。这是一条最佳实践。

三、设置HTTP代理

有时候你所在的公司基于安全因素的考虑，要求你使用通过安全认证的代理访问因特网。这种情况下，就需要为Maven配置HTTP代理，才能让它正常访问外部仓库，以下载所需要的资源。

1.确认是否能够直接访问公共的Maven中央仓库

ping repo1.maven.org

2.如果真的需要代理，检查代理服务器是否畅通

telnet 代理服务器IP 端口号

3.编辑~/.m2/settings.xml

(没有该文件，复制M2_HOME/conf/settings.xml)
添加代理服务配置：

<settings> <proxies> <proxy> <id>my-proxy</id> <active>true</active> <protocol>http</protocol> <host>proxy.host.net</host> <port>80</port> <! -- <username>proxyuser</username> <password>proxypass</password> <nonProxyHosts>local.net|some.host.com</nonProxyHosts> --> </proxy> </proxies> </settings>

proxies可以有多个proxy元素，如果声明多个proxy元素，则默认情况下第一个被激活的proxy会生效。
active为true表示激活该代理。
最重要的是指定正确的host和port。
上述xml中注释掉了username、password和nonProxyHost元素。
当代理服务器需要认证时，就需要配置username和password。
nonProxyHost元素指定那些主机名不需要代理，可以使用|来分割所个主机名，
此外，该配置也支持通配符，如*.google.com表示所有以google.com结尾的域名访问都不要通过代理。

四、Eclipse对Maven的支持

最新版的Eclipse已经集成了对Maven的支持：m2e插件

五、Maven安装最佳实践

1.设置MAVEN_OPTS环境变量

运行mvn命令实际上是执行了Java命令，既然是运行Java，那么运行Java命令可用的参数当然也可以在运行mvn命令时使用。

通常需要设置MAVEN_OPTS环境变量，其值为-Xms128m -Xmx512m。因为Java默认的最大可用内存往往不能满足Maven运行的需要。

一开始配置该变量是推荐做法。

应该尽可能地不去修改任何Maven安装目录下的文件，因为修改的话会造成升级时麻烦。

2.配置用户范围settings.xml

M2_HOME/conf/settings.xml 全局配置，修改会影响整台机器上所有的用户
~/.m2/settings.xml 用户范围配置，修改只会影响当前用户
推荐使用用户范围的settings.xml，主要是为了避免无意识的影响到系统中的其他用户。
如果有切实的需求，需要统一系统中所有用户的settings.xml配置，当然应该使用全局范围的settings.xml。

除了影响范围这一因素，配置用户范围的settings.xml还便于Maven升级。直接修改conf/settings.xml会导致Maven升级不便，每次升级到新版本的Maven都需要复制settings.xml文件。
如果使用~/.m2目录下的settings.xml，就不会影响到Maven安装文件，升级时就不需要触动settings.xml文件。

3.不要使用IDE内嵌的Maven

Eclipse集成了Maven，因此会内嵌一个Maven。
这个内嵌的Maven可能和命令行中的使用的Maven版本不一致，为了便于使用应该统一Maven的版本。

在Eclipse中使用外部Eclipse：
在IDE中配置Maven插件时，使用与命令行一致的Maven：
Windows–Preferences–Maven–Installations–Add…–选择Maven的安装目录，添加完毕之后，选择这个外部的Maven。