用Maven做项目管理

在Java世界中我们很多的开发人员选择用Ant来构建项目，一个build.xml能够完成编译、测试、打包、部署等很多任务，但我们也碰到了很多的问题，如jar文件管理混乱，各个项目结构和build.xml相差很大等等。而Maven的出现，给项目提供了更多的支持。<o:p></o:p>

1        简介<o:p></o:p>

Maven作为Apache的一个开源项目，旨在给项目管理提供更多的支持，主页地址为http://maven.apache.org 。它最早的意图只是为了给apache组织的几个项目提供统一的开发、测试、打包和部署，能让开发者在多个项目中方便的切换。很多伟大的事业，出发点都很简单，ebay就是很好的例证。而maven的成功又一次验证了这一点，越来越多的项目开始使用maven。

基本原理<o:p></o:p>

Maven的基本原理很简单，采用远程仓库和本地仓库以及一个类似build.xml的pom.xml，将pom.xml中定义的jar文件从远程仓库下载到本地仓库，各个应用使用同一个本地仓库的jar，同一个版本的jar只需下载一次，而且避免每个应用都去拷贝jar。如图1。同时它采用了现在流行的插件体系架构，只保留最小的核心，其余功能都通过插件的形式提供，所以maven下载很小（1.1M），在执行maven任务时，才会自动下载需要的插件。

这个基本原理与Pear――ＰＨＰ扩展与应用库（the PHP Extension and Application Repository）的原理非常相似，都有一个官方的仓库，都是微内核，通过网络将需要的文件下载到本地，通过官方仓库将相应的类库进行统一管理。Pear已经成为PHP开发事实上的标准，而Maven在Java世界的地位也逐渐加强，成为标准指日可待。

另外由于插件的易开发性，现在有了非常多的可供选择的插件，如与eclipse结合的插件，与test相关的插件，后面我们结合maven在项目中的使用进行详细介绍。

<v:shapetype o:spt="75" coordsize="21600,21600" filled="f" stroked="f" id="_x0000_t75" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:extrusionok="f" o:connecttype="rect" gradientshapeok="t"></v:path><o:lock v:ext="edit" aspectratio="t"></o:lock></v:shapetype><v:shape id="_x0000_i1025" type="#_x0000_t75" style="WIDTH: 414.75pt; HEIGHT: 232.5pt"><v:imagedata src="file:///C:\DOCUME~1\CE\LOCALS~1\Temp\msohtml1\01\clip_image001.png" o:title=""></v:imagedata></v:shape>

图1

2        项目管理<o:p></o:p>

Maven官方把maven定义为一个项目管理工具，我们不妨看看maven能给我们的项目提供哪些好的支持。

2.1       项目标准化<o:p></o:p>

Maven一个重要特性是定义了项目的标准模板，官方说法是最佳实践。可以通过命令：mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app创建一个单一的maven项目。创建好的项目，具有了特定的项目结构。这个项目结构是参考业界的最佳实践而成，为后面使用统一的maven命令打下了基础，如测试mvn test、打包mvn package等，无需写一行脚本，就可以方便的实现众多功能。Maven还提供其它一些类型模板，可以通过添加-DarchetypeArtifactId=｛type｝创建，如-DarchetypeArtifactId=maven-archetype-site，生成site类型的项目。

同时一些好的开源软件使用了maven，也能作为很好的项目模板，如Equinox（Appfuse的简化版），它的pom定义了对hiberante,spring…的依赖，可以通过ant new -Dapp.name=NAME快速生成项目原型，然后对pom文件进行裁减，以符合自身项目的需要。

有了这个标准，项目间能方便的进行交流，你也很容易了解其它使用maven项目的结构。对于企业来说，引入maven就自然引入了规范，这可比费时费力的写文档，定规范有效的多了。

2.2       文档和报告<o:p></o:p>

使用mvn site可以快速生成项目站点，apache很多开源项目站点都采用maven生成，会出现built by maven字样的图标。

而maven提供的针对如junit，checkstyle，pmd等的插件，能够方便的进行测试和检查并能直接生成报告。使用都很简单，如mvn surefire-report:report 就能自动进行junit测试，并生成junit报告，mvn pmd:pmd生成pmd报告。具体使用可以在http://maven.apache.org/plugins/index.html找到。

2.3       类库管理<o:p></o:p>

Maven一个很重要的特色就是类库管理。通过在pom.xml中定义jar包版本和依赖，能够方便的管理jar文件。以下是一个简单的jar定义片断：

<dependency>                                                                       <o:p></o:p>       <groupId>org.hibernate</groupId><o:p></o:p>       <artifactId>hibernate</artifactId><o:p></o:p>       <version>3.1</version><o:p></o:p>       <type>jar</type><o:p></o:p>       <scope>runtime</scope><o:p></o:p>   </dependency><o:p></o:p>

这个片断告诉我们，依赖的jar包groupId为org.hibernate，artifactId为hibernate，版本为3.1，scope为runtime。在实际项目中，会将M2_REPO(maven本地仓库地址)/ org/hibernate / hibernate /3.1/ hibernate -3.1.jar放入classpath。

同时maven会通过pom.xml管理jar包间的依赖。比如上面的hibernate-3.1.jar同级目录肯定会有一个hibernate -3.1.pom，在这个pom文件中指定了这个jar对其它一些jar的依赖。而这个pom文件是远程仓库提供，无需进行修改，执行maven相关命令就会自动根据相关依赖去下载jar包。这样只需定义对hibernate的依赖而无需关心相关jar，在构建项目上方便了很多。

因为pom文件对jar的管理，也产生了一个很吸引人的特性：项目文件很小。以往一个web项目中，jar文件都要放入WEB-INF/lib下，并放入cvs(svn)中，很容易就达到几十M。而通过maven，只需一个pom.xml，在执行mvn eclipse:eclipse时再去远程仓库下载，项目文件一般只需几百K。

2.4       发布管理<o:p></o:p>

使用maven可以方便的进行项目发表管理。在项目开发到一定阶段，可以使用mvn package打包，它会自动先运行mvn test，跑所有的testcase，只有全部通过才能正确打包。生成的war包（如果项目的packaging为war）在target目录下。这个war包与使用ant脚本生成一样，但无需一行脚本，这也是maven对比ant的优势之一。使用mvn install将编译和打包好的文件发布到distributionManager指定的远程repository。使用mvn deploy可以自动管理项目版本。

<o:p> </o:p>

3        使用maven<o:p></o:p>

Maven使用简单，插件丰富且经过大量项目考验，在项目中引入的风险很小。笔者在项目中使用maven，新进员工在半小时内就能成功使用maven构建项目，并很快掌握几个常用的命令。Maven也不需要什么特殊的设施。如果项目全部使用开源软件，并且不需要maven管理项目版本，只需要一个SCM环境（CVS或SVN），共享开发源码就可以。把pom.xml中的repository设为官方地址就行，配置如下：

<repository>       <id>central</id>       <url>http://www.ibiblio.org/maven2</url> </repository>

这个官方remote repository上有非常多的开源软件，应该能满足大部分项目的需要。如果有项目需要而它上面暂时还没有的软件，或者希望使用公司内部的软件，那么就需要自己配置一个repository了。

3.1       自建私服<o:p></o:p>

传奇私服大家应该都听过，一个网吧自己搞个私服，一伙人免费在上面砍杀。官方因此少赚了很多钱，因此总想打击。而maven官方却对自建私服很是支持，我们总算可以正正当当搞把私服了（Springside的老大江南白衣就是创建私服的好手）。我们就来介绍下自建私服的最快方法。

首先需要一个http server，找台服务器装上apache就行。放一个空的maven目录到htdocs下，假设服务器ip为192.168.0.1，确认能用http://192.168.0.1/maven访问到。然后在自己机器上装好maven2，初始化好项目，在pom.xml放入需要的jar定义，运行如mvn eclipse:eclipse就自动从官方下载jar到本地，如果不做配置，默认本地repository为${user.home}/.m2/。对于windows xp来说一般在C:\Documents and Settings\％username%\.m2下，其中％username％为操作系统登录用户名。这时你可以看到${user.home}/.m2/下多了个repository目录，里面有很多的项目相关jar，目录按groupId/ artifactId/version排好。把repository目录整个拷贝到apache服务器的maven目录下，如果需要官方缺少的jar或公司内部jar，仿照这个目录结构，做好jar放到maven目录下。自建私服成功！

要使用私服，只需修改pom.xml，在repository配置后加上：

<repository>       <id>companyName</id>       <url>http:// ${ip}/maven</url> </repository>

这样需要下载jar时，会先到本地repository查看，没有下载过再到官方搜索，没有找到再到后面的repository查找。

3.2       安装配置<o:p></o:p>

Maven的安装很简单：

1.         从apache网站上下载maven安装包，实际上就是个压缩文件。将其解压到你想要存放maven的目录中。在这里假设你将maven解压到C:\Program Files\Apache Software Foundation\maven-<st1:chsdate isrocdate="False" month="12" w:st="on" day="30" islunardate="False" year="1899">2.0.4</st1:chsdate>中。<o:p></o:p>

2.      将C:\Program Files\Apache Software Foundation\maven-<st1:chsdate isrocdate="False" month="12" w:st="on" day="30" islunardate="False" year="1899">2.0.4</st1:chsdate>\bin设到你的系统环境变量%PATH%中。<o:p></o:p>

3.      同时确保你已经将你的JDK安装目录设为java_home系统变量。<o:p></o:p>

4.         打开个命令行窗口，运行mvn –version验证是否安装成功。<o:p></o:p>

5.  &