Maven

? 1 Maven概述 (1)

1.1 为什么需要Maven？ (1)

1.2 什么是MA VEN? (2)

?2环境的搭建 (2)

2.1在基于Windows下的系统上安装Maven (3)

2.2 Eclipse搭建maven过程 (4)

2.3 maven升级 (12)

? 3 maven基本概念详解 (12)

3.1 Maven生命周期详谈 (12)

3.2 Maven坐标 (13)

3.2.1什么是坐标？为什么要规划？ (13)

3.2.2坐标规划原则 (13)

3.2.3 Classifier (14)

? 4 maven搭建web应用 (15)

4.1创建Maven项目 (15)

4.2运行mvn命令 (16)

? 1 Maven概述

1.1 为什么需要Maven？

先说一下Antx在存在哪些问题：

1. Antx第三方库的管理比较复杂，如果某个项目需要一个新的jar包或者新版本的jar包，则需要走一个严格申请流程，并且需要自己提交相关的jar包

2. Antx对jar包的版本控制，changelist等没有工具上的支持，导致很多项目都是1.0-SNAPSHOT从头用到尾，导致包版本比较不好控制。

3. Antx对SCM打包部署的支持不是很强。

4. Antx在于IDE的兼容性上存在问题，为了让eclipse支持antx，我们需要单独写一个antx 插件来让eclipse支持antx，对于其他的一些比较好的IDE比如Intellij IDEA，是不支持antx 的。

5. 现在IDE很多都有一键式DEBUG的功能，包括集成对应用服务器的支持，antx在这方面存在不足。

Maven能解决这些问题么，还有更好的优势么，答案是YES

1. Maven的库是由开源组织维护，不需要我们再花精力去管第三方库，即使自己维护，也比较方便。

2. Maven对jar包的版本管理有工具上的支持，比如将Release版本和Snapshot版本区分开，有利于SCM管理。

3. Maven是标准，用过的人多，不需要额外培训。

4. Maven的plugin比较多，可以有更多功能，Maven现有体系比较开放，采用的技术相对比较通用和成熟，plugin的机制也可以便于我们扩展更多功能。

5. Maven的库下载是即用即下，不需要实现全部down下来。Maven的插件也是自动升级，可以方便的

我们扩展新功能。

6. 可以很方便的与eclipse, IDEA这样的主流的IDE集成

7. 仓库管理器：它的出现有两个目的：首先它的角色是一个高度可配置的介于你的组织与公开Maven仓库之间的代理，其次它为你的组织提供了一个可部署你组织内部生成的构件(第二方库)的地方。

8. 版本管理功能，这里的版本管理不是指第三方库的版本管理，而是项目的版本管理

9. 站点功能：它的出现让我们可以对项目的状态一目了然，可以自动的把项目的状态和各种报表以站点的形式发布到内部网或者外部网，可以随时随地查看项目状态。有很多中报表可以选择，包括，doc生成，代码规范的检查，自动bug检查，单元测试报表，单元测试的代码覆盖率报表

1.2 什么是Maven?

成功的软件工程需要构建工具。在Java世界中，并不缺少这样的工具，Ant就是一个标准的典型。

Maven是另一种关于开放资源画面的项目管理/构建工具。与Ant相比，Maven是一个将Ant 概念中几个步骤深化了的项目管理工具。它不能建立在Ant之上，但它可以利用Ant构建脚本的优势，甚至生成这种脚本。

为了使用Maven，你首先必须创建一个项目对象模型（POM）。POM的默认值是project.xml 文件，它描述了程序及其相关性。Maven用POM来构建项目和相关文件。一旦你有了一个基本的project.xml文件，你可以把它用作你所有项目的模板。

Maven的目标大致和Ant的类似。Maven还有许多实用的预定目标，如关于编辑、配置、生成文件、生成Ant构建脚本、创建jars、wars、ears文件等，都要用到它。如果漏掉了什么，你可以随意加入自己想要的目标。

Maven两个最酷的特点是jar repositories和项目站点生成。Jar repositories是包含jar文件的本地或远程站点。当你在建立时间证明jar文件和POM的依赖关系时，Maven将自动将jar文件所需版本下载到本地存储库。这个特点可以让你更加轻松地构建项目。项目站点生成目标则是创建一个项目的专业网站，包括强调语法的源代码的链接、代码格式、javadoc、单体测试等等。

通常对Maven的一个抱怨是有时它很慢。一些开发人员已使用Maven来创建一个用来日常开发的Ant文件，然后用Maven分配他们的项目或作为晚上进程的一部分。

无论如何，Maven的这些特点至少让它值得你认真地考虑

2环境的搭建

2.1在基于Windows下的系统上安装Maven

Maven官方下载地址：https://www.360docs.net/doc/54595429.html,/dyn/closer.cgi/maven/binaries/maven-2.0.7-bin.zip

1Maven下载后，解压到本地目录，如：c:\ maven-2.0.7，配置maven环境变量M2_HOME，如图：，

2在path中添加bin目录，如图：

3启动cmd，输入mvn –version，回车，可以看到maven版本，如图：

说明maven安装正确；

4关于maven的使用，请参考网上资料，在此处不做描述，其中有一点需要说明；

5maven的配置文件有2个，一个是全局配置文件，在maven的安装目录下

conf/settings.xml，另一个是用户级别的配置文件，对于windows xp来说一般在C:\Documents and Settings\％username%\.m2下，其中％username％为操作系统登录用户名。

6若C:\Documents and Settings\％username%\.m2下面没有setting.xml文件，可以将conf/setting.xml拷贝到.m2目录下；

7在配置文件中，有一项配置本地资源库的位置，默认为C:\Documents and Settings\％username%\.m2\ repository，默认配置不是很合适，如修改本地资源库保存路径为maven 安装目录下，修改setting.xml文件，下找到localRepository标签，默认为注释掉的，在该注释段之外添加C:/maven-2.0.7/repository，为本地资源库保存位置，需要手动在mavne安装目录下创建repository目录；

8到此，jetty与maven环境搭建完毕，关于maven构建本地库过程不在这里描述，网上大把资料；

2.2 Eclipse搭建Maven过程

下载安装eclipse过程不做描述了，网上大把的资料，若不熟悉的，请在网上找资料

启动eclipse，Help->Software Updates->Find and Install，如图：

出现Feature Updates 界面，选择Search for new features to install，如下图

点击next，显示Update sites to visit界面，如下图

我们需要新建立jetty与maven的插件更新站点，点击New Romote Site，输入name：jetty

URL：https://www.360docs.net/doc/54595429.html,/updates/

显示如下图：

https://www.360docs.net/doc/54595429.html,/update/ 地址

选中（只用选maven）需要更新的站点，点击Finish，出现如下图：

Eclipse会查询到更新的插件，如下图：

打开maven前面的加号，选择合适的版本，

Eclipse3.2.2版本的maven插件也只有一个，选中

注意这里的选项要是全选会出错提示缺少相应的jar 这里只需要点上maven Integration maven Integration for Eclipse 这里可能会出现2个你就点不出错的那个就行了

点击next，eclipse开始下载maven插件，该插件有15490K，下载比较慢

下载完成后，显示如下：

点击Install All，执行安装

重新启动eclipse后，点击run

可以看到maven安装成功，如下图：

首次点击maven时，eclipse会根据配置的M2_HOME寻找本地资源库位置，若setting.xml 文件内本地资源库位置做了修改，eclipse会使用修改过的路径，若没做修改，会使用默认的路径，即.m2目录下的repository

2.3 Maven升级

Maven还比较年轻，更新比较频繁，因此用户往往会需要更新Maven安装以获得更多更酷的新特性，以及避免一些旧的bug。

在Windows上更新Maven非常简便，只需要下载新的Maven安装文件，解压至本地目录，然后更新M2_HOME环境变量便可。例如，假设Maven推出了新版本3.1，我们将其下载然后解压至目录D:\bin\apache-maven-3.1，接着遵照前一节描述的步骤编辑环境变量M2_HOME，更改其值为D:\bin\apache-maven-3.1。至此，更新就完成了。同理，如果你需要使用某一个旧版本的Maven，也只需要编辑M2_HOME环境变量指向旧版本的安装目录。

? 3 Maven基本概念详解

3.1 Maven生命周期详谈

Maven可以支持许多不同的生命周期，但是最常用的生命周期是默认的Maven生命周期，这个生命周期中一开始的一个阶段是验证项目的基本完整性，最后的一个阶段是把一个项目发布成产品。生命周期的阶段被特地留得含糊，单独的定义为验证(validation)，测试(testing)，或者发布(deployment)，而他们对不同项目来说意味着不同的事情。例如，打包(package)这个阶段在一个项目里生成一个JAR，它也就意味着“将一个项目打成一个jar”，而在另外一个项目里，打包这个阶段可能生成一个W AR文件。

Maven执行一个阶段的时候，它首先会有序的执行前面的所有阶段，到命令行指定的那个阶段为止。每个阶段对应了零个或者多个目标。我们没有进行任何插件配置或者定制，所以这个例子绑定了一组标准插件的目标到默认的生命周期。当Maven经过以package为结尾的默认生命周期的时候，下面的目标按顺序被执行：

?resources:resources

Resources插件的resources目标绑定到了resources 阶段。这个目标复制src/main/resources下的所有资源和其它任何配置的资源目录，到输出目录。

?compiler:compile

Compiler插件的compile目标绑定到了compile 阶段。这个目标编译src/main/java下的所有源代码和其他任何配置的资源目录，到输出目录。

?resources:testResources

Resources插件的testResources目标绑定到了test-resources 阶段。这个目标复制src/test/resources下的所有资源和其它任何的配置的测试资源目录，到测试输出目录。

?compiler:testCompile

Compiler插件的testCompile目标绑定到了test-compile 阶段。这个目标编译src/test/java 下的测试用例和其它任何的配置的测试资源目录，到测试输出目录。

?surefire:test

Surefire插件的test目标绑定到了test 阶段。这个目标运行所有的测试并且创建那些捕

捉详细测试结果的输出文件。默认情况下，如果有测试失败，这个目标会终止。

jar:jar

Jar插件的jar目标绑定到了package 阶段。这个目标把输出目录打包成JAR文件。

总结得来说，当我们运行mvn package，Maven运行到打包为止的所有阶段，在Maven沿着生命周期一步步向前的过程中，它运行绑定在每个阶段上的所有目标。你也可以像下面这样显式的指定一系列插件目标，以得到同样的结果：

mvn resources:resources \

compiler:compile \

resources:testResources \

compiler:testCompile \

surefire:test \

jar:jar

运行package阶段能很好的跟踪一个特定的构建中包含的所有目标，它也允许每个项目使用Maven来遵循一组定义明确的标准。而这个生命周期能让开发人员从一个Maven项目跳到另外一个Maven项目，而不用知道太多每个项目构建的细节。如果你能够构建一个Maven 项目，那么你就能构建所有的Maven项目。

3.2 Maven坐标

3.2.1什么是坐标？为什么要规划？

坐标是Maven最基本的概念，它就像每个构件的身份证号码，有了它我们就可以在数以千万计的构件中定位任何一个我们感兴趣的构件。举个最简单的例子，如果没有坐标，使用JUnit的时候，用户就需要去下载依赖jar包，用依赖的方式，简单配置使用如junit:junit:4.8.2就可以了。这里第一个junit是groupId，第二个junit是artifactId，4.8.2是version。Maven的很多其他核心机制都依赖于坐标，其中最显著的就是仓库和依赖管理。对于仓库来说，有了坐标就知道在什么位置存储构件的内容，例如junit:junit:4.8.2就对应仓库中的路径/junit/junit/4.8.2/junit-4.8.2.pom和/junit/junit/4.8.2/junit-4.8.2.jar这样的文件，读者可以直接访问中央仓库地址看到这样的仓库布局，或者浏览本地仓库目录~/.m2/repository/以获得直观的体验。依赖的配置也是完全基于坐标的，例如：

junit junit 4.8.2 test

有了正确的坐标,Maven才能够在正确的位置找到依赖文件并使用，这里值为test的scope 是用来控制该依赖只在测试时可用，与坐标无关。

正因为坐标是Maven核心的核心，因此规划正确的坐标至关重要，如果你使用了模糊不清的坐标，那么你的用户就很难找到你的构件，或者即使找到了，也容易写错。错误的使用坐标，还会造成冲突，如果你也使用junit这样的groupId，那会发生什么？下面先看一些不是很规范的坐标使用方式。

3.2.2坐标规划原则

滥用坐标、错用坐标的样例比比皆是，在中央仓库中我们能看到SpringFramework有两种坐标，其一是直接使用springframework作为groupId，如springframework:spring-beans:1.2.6，另一种是用org.springframework作为groupId，如org.springframework:spring-beans:2.5。细心看看，前一种方式显得比较随意，后一种方式则是基于域名衍生出来的，显然后者更合理，因为用户能一眼根据域名联想到其Maven坐标，方便寻找。因此新版本的SpringFramework构件都使用org.springframework作为groupId。由这个例子我们可以看到坐标规划一个原则是基于项目域名衍生。其实很多流行的开源项目都破坏了这个原则，例如JUnit，这是因为Maven社区在最开始接受构件并部署到中央仓库的时候，没有很很严格的限制，而对于这些流行的项目来说，一时间更改坐标会影响大量用户，因此也算是个历史遗留问题了。

还有一个常见的问题是将groupId直接匹配到公司或者组织名称，因为乍一看这是显而易见的。例如组织是https://www.360docs.net/doc/54595429.html,，有个项目是dog，那有些人就直接使用groupId com.zoo了。如果项目只有一个模块，这是没有什么问题的，但现实世界的项目往往会有很多模块，Maven 的一大长处就是通过多模块的方式管理项目。那dog项目可能会有很多模块，我们用坐标的哪个部分来定义模块呢？groupId显然不对，version也不可能是，那只有artifactId。因此要这里有了另外一个原则，用artifactId来定义模块，而不是定义项目。接下来，很显然的，项目就必须用groupId来定义。因此对于dog项目来说，应该使用groupId com.zoo.dog，不仅体现出这是https://www.360docs.net/doc/54595429.html,下的一个项目，而且可以与该组织下的其他项目如com.zoo.cat区分开来。

除此之外，artifactId的定义也有最佳实践，我们常常可以看到一个项目有很多的模块，例如api，dao，service，web等等。Maven项目在默认情况下生成的构件，其名称不会是基于artifactId，version和packaging生成的，例如api-1.0.jar，dao-1.0.jar等等，他们不会带有groupId的信息，这会造成一个问题，例如当我们把所有这些构件放到Web容器下的时候，你会发现项目dog有api- 1.0.jar，项目cat也有api-1.0.jar，这就造成了冲突。更坏的情况是，dog项目有api-1.0.jar，cat项目有api- 2.0.jar，其实两者没什么关系，可当放在一起的时候，却很容易让人混淆。为了让坐标更加清晰，又出现了一个原则，即在定义artiafctId时也加入项目的信息，例如dog项目的api模块，那就使用artifactId dog-api，其他就是dog-dao，dao-service等等。虽然连字号是不允许出现在Java的包名中的，但Maven 没这个限制。现在dog-api-1.0.jar，cat-2.0.jar被放在一起时，就不容易混淆了。

关于坐标，我们还没谈到version，这里不再详述因为读者可以从Maven: The Complete Guide中找到详细的解释，简言之就是使用这样一个格式：

<主版本>.<次版本>.<增量版本>-<限定符>

其中主版本主要表示大型架构变更，次版本主要表示特性的增加，增量版本主要服务于bug 修复，而限定符如alpha、beta等等是用来表示里程碑。当然不是每个项目的版本都要用到这些4个部分，根据需要选择性的使用即可。在此基础上Maven还引入了SNAPSHOT的概念，用来表示活动的开发状态，由于不涉及坐标规划，这里不进行详述。不过有点要提醒的是，由于SNAPSHOT的存在，自己显式地在version中使用时间戳字符串其实没有必要。

3.2.3 Classifier

Classifier可能是最容易被忽略的Maven特性，但它确实非常重要，我们也需要它来帮助规划坐标。设想这样一个情况，有一个jar项目，就说是 dog-cli-1.0.jar 吧，运行它用户就能在命令行上画一只小狗出来。现在用户的要求是希望你能提供一个zip包，里面不仅包含这个可运行的jar，还得包含源代码和文档，换句话说，这是比较正式的分发包。

这个文件名应该是怎样的呢？dog-cli-1.0.zip？不够清楚，仅仅从扩展名很难分辨什么是Maven默认生成的构件，什么是额外配置生成分发包。如果能是dog-cli-1.0-dist.zip就最好了。这里的dist就是classifier，默认Maven只生成一个构件，我们称之为主构件，那当我们希望Maven生成其他附属构件的时候，就能用上classifier。常见的classifier还有如dog-cli-1.0-sources.jar表示源码包，dog-cli-1.0-javadoc.jar表示JavaDoc包等等。制作classifier的方式多种多样，其中最重要的一种是使用Maven Assembly Plugin.

4 Maven搭建web应用

4.1创建Maven项目

创建一个Maven项目也十分简单，选择菜单项File -> New -> Other，在弹出的对话框中选择Maven下的Maven Project，然后点击Next >，在弹出的New Maven Project对话框中，我们使用默认的选项（不要选择Create a simple project选项，那样我们就能使用Maven Archetype），点击Next >，此时m2eclipse会提示我们选择一个Archetype，我们选择maven-archetype-quickstart，再点击Next >。由于m2eclipse实际上是在使用maven-archetype-plugin插件创建项目，因此这个步骤与上一节我们使用archetype创建项目骨架类似，输入groupId,、artifactId、version、package（暂时我们不考虑Properties），如图3-3所示：

图3-3 在Eclipse中使用Archetype创建项目

注意，为了不和前面已导入的Hello World项目产生冲突和混淆，我们使用不同的artifactId 和package。OK，点击Finish，Maven项目就创建完成了，其结构与前一个已导入的Hello World 项目基本一致。

4.2运行mvn命令

我们需要在命令行输入如mvn clean install之类的命令来执行maven构建，m2eclipse中也有对应的功能，在Maven项目或者pom.xml上右击，再选择Run As，就能看到如下的常见Maven命令，如图3-4所示：

图3-4 在Eclipse中运行默认mvn命令

选择想要执行的Maven命令就能执行相应的构建，同时我们也能在Eclipse的console中看到构建输出。这里常见的一个问题是，默认选项中没有我们想要执行的Maven命令怎么办？比如，默认带有mvn test，但我们想执行mvn clean test，很简单，选择Maven buid… 以自定义Maven运行命令，在弹出对话框中的Goals一项中输入我们想要执行的命令，如clean test，设置一下Name，点击Run即可。并且，下一次我们选择Maven build，或者使用快捷键Alt + Shift + X, M快速执行Maven构建的时候，上次的配置直接就能在历史记录中找到。图3-5就是自定义Maven运行命令的界面：