Maven起步

版权声明：可以任意转载，转载时请务必以超链接形式标明文章原始出处和作者信息及本声明
英文原文地址:
http://www.onjava.com/pub/a/onjava/excerpt/mavenadn_ch01/index.html
中文地址:
http://www.matrix.org.cn/resource/article/43/43661_Maven.html
关键词： Maven Ant Java




编者注：

如果你已经有十次输入同样的Ant targets来编译你的代码、jar或者war、生成javadocs，你一定会自问，是否有有一个重复性更少却能同样完成该工作的方法。Maven便提供了这样一种选择，将你的注意力从作业层转移到项目管理层。Maven项目已经能够知道如何构建和捆绑代码，运行测试，生成文档并宿主项目网页。

O'Reilly's的新书Maven:A Developer's Notebook帮你提升你的项目、使其尽快的运行起来，同时也提供了对Maven插件及其团队协作等高级特性的深度考察。在“Maven Jump-Start” (656K PDF)的示范章节中，作者Vincent Massol和Timothy M.O'Brien向你展示了如何安装Maven，如何开始你初次的构建，研究如何使其与IDEs集成极其资源管等特性。

Vincent Massol是Jakarta Catus framework（框架）的创建者。其后他花费4年的时间在几个大项目（主要是J2EE）的架构技术上。他现在是Pivolis的创办人和CTO,这是一家专注于应用敏捷方法进行软件开发的公司。他现在居住在法国的首都City of Light（巴黎）。

Timothy M. O'Brien作为一个专业的歌手/程序员现正在芝加哥地区工作和生活。




让我们开始使用Maven。在本章结束时，你应该能够从头建立一个Maven的项目，使用Maven进行相关管理，创建基于某些感兴趣报告的简单的web站点。

安装Maven
开始本书以前，你有一些必备的安装工作。本书中的例子用Java1.4.2编写，Maven能够兼容Java1.4.2和Java1.5.0。本书中所写Maven的最新版本是在编写本书时发布的—Maven 1.0.2。除JDK和Maven1.0.2之外，你还需要连接到Internet，Maven将通过公网站点下载相关其需要的。那么，前进，安装Maven吧。

我该如何做？
从Apache Software Foundation(ASF)下载Maven。进入http://maven.apache.org/从左侧的导航菜单中的Getting Maven菜单选择下载。它将带你进入一个让你选择Windows 安装包、zip文件、tar'd.bzip文件或者tar'd.gzip文件。下载适合你平台的分类。

我该如何做？
从Apache Software Foundation(ASF)下载Maven。进入http://maven.apache.org/从左侧的导航菜单中的Getting Maven菜单选择下载。它将带你进入一个让你选择Windows 安装包、zip文件、tar'd.bzip文件或者tar'd.gzip文件。下载适合你平台的分类。


提示


某些Developer's Notebook中涉及的插件未与Maven1.0.2
绑定。请参考第6章并且附录A有安装Maven所需插件的全部
列表以及详细说明。



在Microsoft Windows平台，下载Windows安装包（maven-1.0.2.exe），跟随自动安装过程中的提示。在使用Maven Windows 安装器进行安装后，你应该定义一个用户环境变量，MAVEN_HOME，指向你本地的Maven安装。你此时需要进入控制面版→系统→高级选择环境变量按钮，添加%MAVEN_HOME%\bin到你的PATH环境变量。进入命令提示行运行cmd.exe，如果Maven安装成功，你将能够看到命令行有下面的输出：
C:\dev\mavenbook\code>maven -v
__  __
|  \/  |__ _Apache__ ___
| |\/| / _` \ V / -_) ' \  ~ intelligent projects ~
|_|  |_\__,_|\_/\___|_||_|  v. 1.0.2

如果你愿意安装Maven到一个除了C:\Program Files\Apache Software Foundation\Maven 1.0.2的目录，你也可以下载Maven1.0.2.zip文件，解压缩到任何目录。设置MAVEN_HOME指 向到Maven解压缩的目录，并且添加%MAVEN_HOME%\Bin到你的PATH环境变量。

在Unix平台，下载tar'd.zip文件（Maven-1.0.2.tar.gz）并接压缩tar xvzf maven-1.0.2.tar.gz到你选择的目录。本试验假设你解压Maven到/usr/local/maven-1.0.2目录下。你此时需要设置两个环境变量，MAVEN_HOME和PATH。下面的命令为这两个变量设置适当的值：
[tobrien@mavenbook tobrien]$ export MAVEN_HOME=/usr/local/maven-1.0.2
[tobrien@mavenbook tobrien]$ export PATH=${PATH}:${MAVEN_HOME}/bin
如果Maven被成功安装到你的机器，你能够看到与Windows系统同样的输出。恭喜！你已经成安装了Maven。


提示


有些人喜欢保存本地应用程序在Unix下的/opt目录或
Windows下的c:\apps。你可以根据个人喜好安装Maven。


刚刚发生了什么？
你刚刚安装了Maven1.0.2并且配置了一些环境变量。是的！一旦你对MAVEN_HOME进行了有效的设置或是maven.bat或maven.sh已经存在，你已经能够完成Developer's Notebook本次的实验。

关于....
          ..Maven 2?
是时机提及Maven 2（有时也被称为“m2”）。Maven 2完成了对Maven 1的重写。重写的首要目的是要提供了强大的Jave构建和包含API的项目，允许Maven被植入任何地方，尤其是高级别的产品如IDEs、质量工具、报告工具等这些。Maven 2构建生命周期的概念正式话，其比Maven更易扩展。

Maven 1和Maven 2有许多共同点，但它们还有几个主要的不同之处。在书中的各个部分我们尽可能提示你所希望了解的那些不同之处。更多关于Maven 2的信息，请转到http://maven.apache.org/下载Maven 2的体验版本，并加入Maven用户或开发者邮件列表。如果你听过Continuous Integration，你可能也想看一看命名为Continuum的Maven子项目，地址在http://maven.apache.org/continuum。

开始一个新的项目
创建新项目的争论一部分在于有很大部分的工作努力被用到在“发展基础设施”上—自动构建、单元测试、文档、项目报告等。使用Maven你可以加速这个过程，生成项目的框架使其作为新应用的种子。


我该如何做？
Maven拥有一个应用程序生成插件（Genapp）你能通过其创建一个新项目。首先创建一个空的目录c:\dev\mavenbook\code\genapp\test-application这将成为应用程序生成后的处所。通过执行genapp这个目标来运行Genapp插件，选择默认的模版并且提供一些你的新项目的相关信息。
C:\dev\mavenbook\code\genapp\test-application>maven genapp

__ __| \/ |__ _Apache__ ___| |\/| / _` \ V / -_) ' \ ~ intelligent projects ~|_| |_\__,_|\_/\___|_||_| v. 1.0.2Attempting to download commons-jelly-tags-interaction-20030211.143817.jar.4K downloadedEnter a project template to use: [default]EnterPlease specify an id for your application: [app]test-applicationPlease specify a name for your application:  Example ApplicationTest ApplicationPlease specify the package for your application: [example.app]mdn.testappbuild:start:genapp:[copy] Copying 1 file to C:\dev\mavenbook\code\genapp\test-application\src\java\mdn\testapp[copy] Copying 3 files to C:\dev\mavenbook\code\genapp\test-application\src\test\mdn\testapp[copy] Copying 1 file to C:\dev\mavenbook\code\genapp\test-application\[copy] Copying 2 files to C:\dev\mavenbook\code\genapp\test-application\BUILD SUCCESSFUL


本插件会要求用户一些输入，从这个输出内容你可以看到你使用了默认的（defalut）应用程序模板，并且你提供了新项目的应用程序ID、name，和包名。默认的（default）应用程序模板创建了一个单独的类，mdn.testapp.app，和一个静态main函数和两个JUnit测试。

Maven的应用程序生成插件生成了下面的目录和文件：

test-application/project.propertiesproject.xmlsrc/conf/app.propertiesjava/mdn/testapp/App.javatest/mdn/testapp/AbstractTestCase.javaAppTest.javaNaughtyTest.java

所有Maven项目有一个参考了项目对象模型（POM）的标准目录结构, （as described shortly）。如果你有一些现存的类你想添加到一个项目，添加它们到src/java，如果你有一些单元测试将它们添加到src/test。如果这些已有的类和单元测试依赖一些外部的苦，你将在随后的章节看到如何添加一个附属。xdos目录包含了格式为XDoc的项目文档。


提示


请注意Maven1.0.2装载的Genapp插件版本创建了非标准
的布局。在Maven项目中src/java和src/test不再出现
在固有的源代码和单元测试位置。取而代之的是你可
以使用src/main/java和src/test/java。为了改变这些，
修改你项目的xml文件，改变src/java的引用为src/main-
/java，src/test的引用为src/test/java。更多的信息，
请参见“Maven Conventions”,地址在
http://maven.apache.org/-reference/conventions.html。


project.xml是项目的描述符；它是一个内容为POM的XML文件。让我们看看这个project.xml的拷贝，其已经定义了这个项目：


<project><pomVersion>3</pomVersion><artifactId>test-application</artifactId><name>Test Application</name><currentVersion>1.0</currentVersion><organization><name>Your Organization</name><url>http://www.someorganization.biz/</url><logo>http://www.someorganization.biz/logo.gif|jpg|...</logo></organization><inceptionYear>2005</inceptionYear><package>mdn.testapp</package><logo>http://yourproject/logo.jpg|gif|...</logo><description>An example project</description><shortDescription>How to use maven in different situations</shortDescription><!-- Many Elements Omitted (see generated POM) --><dependencies/><build><sourceDirectory>src/java</sourceDirectory><unitTestSourceDirectory>src/test</unitTestSourceDirectory><unitTest><includes><include>**/*Test.java</include></includes><excludes><exclude>**/NaughtyTest.java</exclude></excludes></unitTest><resources><resource><directory>src/conf</directory><includes><include>*.properties</include></includes></resource></resources></build></project>


该文件告诉Maven有关你项目的全部。build元素定位应用程序原码，单元测试和资源文件包的位置。name, artifactId, currentVersion, inceptionYear, description。
shortDescription标识该项目并且提供了该项目的信息被用作完成品的名字来创建项目。


提示


如果你工作在已有的Maven项目，你应该看到id元素在
artifactId的位置。该id元素已经不被赞成使用，
你可以用artifactId替代。


resources元素被用于JAR插件拷贝资源到JAR生成物。在该元素你指定一批资源到资源库。本例中，自src/conf的资源将被复制到classpath的根目录。换言之，app.properties资源将被复制到所生成的JAR生成物的根目录。如果你想所有位于src/conf的*.properties资源和*.xml资源在mdn.testapp包中生成的JAR有效，你可以按照以下来指定targetPath：

<resource><directory>src/conf</directory><targetPath>mdn/testapp</targetPath><includes><include>*.properties</include><include>*.xml</include></includes></resource>

project.properties让你能够定制Maven及其插件在本项目中的行为。你将在看过本书之后使用该文件定制所生成web站点的品质和JAR文件的内容。

提示

关于在没有Genapp插件来生成新Maven项目的快速入
门指导，参见BrettPorter的“The Ten Minute Test”，
地址在http://maven.apache.org/start/ten-minute-
test.html。


关于...
... Maven在有关协作项目中跟踪信息的能力？
为简化本例，我们从project.xml文件中去掉了一些初期显示的描
述项目邮件列表、知识库、开发者和web站点的元素。第4、5章深
入更多有关使用Maven发布web站点和在现有源码库中工作的细节。


在代理服务器下使用Maven
Maven依赖于Internet连接，其通过HTTP下载相关的插件。如果你工作在公共环境，你可能需要配置Maven来与工作代理服务器系统。


我该如何做？
你可能需要设置你项目中project.properties文件的一些属性。project.properties文件允许你通过设置命名的属性来定制Maven的行为。配置代理服务器，放置下面的project.properties到与你项目中project.xml文件同样的位置：
maven.proxy.host = proxy.company.com
maven.proxy.port = 80
并且，如果你需要连接到一个代理服务器必须有NTLM的授
权，设置以下属性：
maven.proxy.ntlm.username = tobrien
maven.proxy.ntlm.password = myp@ssw0rd


提示


在第二章，你将学到user-specific属性将被定义在
~/build.properties或%USERPROFILE%\build.properties 文件。现在，如果你需要完成本试验，在 project.properties里定义这些属性。


编译和测试一个项目
你拥有了一个包含一个类文件和单元测试文件的项目。下
面，让我们够见这个项目和运行应用程序类吧。

我该如果做？
通过执行jar:jar goal来创建一个包含应用程序的类的jar
文件。JAR插件定义了一个速记目标命名为jar其依赖之前的jar:jar goal。执行任何一个目标将得到相同的结果。所有的插件都定义了一条这样的捷径；例如，测试目标执行的是Test插件里的test:test goal。执行jar goal和maven jar：

C:\dev\mavenbook\code\genapp\test-application>maven jar__ __| \/ |__ _Apache__ ___| |\/| / _` \ V / -_) ' \ ~ intelligent projects ~|_| |_\__,_|\_/\___|_||_| v. 1.0.2Attempting to download junit-3.8.1.jar.118K downloadedbuild:start:java:prepare-filesystem:[mkdir] Created dir: C:\dev\mavenbook\code\genapp\test-application\target\classesjava:compile:[echo] Compiling to C:\dev\mavenbook\code\genapp\test-application/target/classes[echo][javac] Compiling 1 source file to C:\dev\mavenbook\code\genapp\testapplication\target\classesjava:jar-resources:Copying 1 file to C:\dev\mavenbook\code\genapp\test-application\target\classestest:prepare-filesystem:Compiling and Testing a Project 9[mkdir] Created dir: C:\dev\mavenbook\code\genapp\test-application\target\test-classes[mkdir] Created dir: C:\dev\mavenbook\code\genapp\test-application\target\test-reportstest:test-resources:test:compile:[javac] Compiling 3 source files to C:\dev\mavenbook\code\genapp\testapplication\target\test-classestest:test:[junit] Running mdn.testapp.AppTest[junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 0.078 secjar:jar:[jar] Building jar: C:\dev\mavenbook\code\genapp\test-application\target\test-application-1.0.jarBUILD SUCCESSFULTotal time: 9 seconds


Maven创建一个target（目标）目录来保存中间文件和JAR文件。在JAR首次被建立后，按照下面执行App类。

C:\dev\mavenbook\code\genapp\test-application> java ^More? target\test-application-1.0.jar mdn.testapp.AppHello World!

如果你想重复此项工作，运行maven clean来移除target目录重新构建。

刚刚发生了什么？
当你运行jar目标时，Maven使用JAR插件来创建了一个JAR生成物。首先，Maven找到一系列的目标以便能够创建这个应用程序的JAR文件；JAR插件有一个其它目标所依赖于目标的jar:jar goal，反过来，它也依赖于其他的目标。Maven找出下列需要的目标来执行：java:prepare-filesystem，java:compile，java:jarresources，
test:prepare-filesystem，test:test-resources，test:compile，and test:test。

Maven查看其需要执行目标中的Test插件来执行单元测试，并且检查本地Maven库中的JUnit JAR文件。因为你还没有使用过Maven，所以它将从位于http://www.ibiblio.org/
maven/的Maven默认库中下载junit-3.8.1.jar。你将在本章后学习到有关Maven本地库和Maven强大的相关管理能力的内容。


与项目对象模型一同工作
Project Object Model（POM）是Maven的重要部分，你将与其一同工作贯穿本书。


我该如何做？
POM同样涉及到项目的描述。project.xml描述了项目的源代码、开发者、源控制，许可和标示信息譬如项目名称和发起组织。Maven打破了过去传统的构建系统；取而代之的是为每个构建提供了外在说明，Maven使用声名的方法管理构建。换句话说，你不用过多的告诉Maven做什么，Maven知道去查找基于project.xml中的内容。另一方面，Ant以命令方式进行项目构建；你最终要告诉Ant编译这个文件，建立这个目录，绑定这些文件到WAR等等。Maven维护一个插件的分类来与标准的POM—一个结构声明、标示和内容工作。

如果你看了上次练习所生成的project.xml文件，你将注意到许多元素都在上次讨论中被忽略。下面的XML列出了POM中顶级的元素，（in the order in which they are expected:
）：

<project><extend/><pomVersion/><id/><name/><groupId/><currentVersion/><organization/><inceptionYear/><package/><logo/><gumpRepositoryId/><description/><shortDescription/><url/><issueTrackingUrl/><siteAddress/><siteDirectory/><distributionSite/><distributionDirectory/><repository/><versions/><branches/><mailingLists/><developers/><contributors/><licenses/><dependencies/><build/><reports/><properties/></project>

本章探究更多以上XML列出的元素，包括contributors，developers，dependencies，reports和repository。本章的式样将提供这些细节，但你应该使用上面XML的摘录来以适当的顺序放置这些元素到你的project.xml中。

列出有效的Goals
当你使用Maven时，你将执行目标。Maven插件是一组相关的插件。例如，要为一个项目创建JAR文件，你将如下所示执行JAR插件中的jar:jar goal。
C:\dev\mavenbook\code\genapp> maven jar:jar
冒号之前的jar分类这个目标属于JAR插件。查看全部的JAR插件列表，键入以下命令：
C:\dev\mavenbook\code\genapp> maven -P jar
__ __
| \/ |__ _Apache__ ___
| |\/| / _` \ V / -_) ' \ ~ intelligent projects ~
|_| |_\__,_|\_/\___|_||_| v. 1.0.2
Goals in jar
============
[jar] Create the deliverable jar file.
deploy ......................... Deploy a jar to the remote repository
deploy-snapshot ................ Deploy a snapshot jar to the remote
repository
install ........................ Install the jar in the local repository
install-snapshot ............... Install a snapshot jar in the local
repository
jar ............................ Create the deliverable jar file.
snapshot ....................... Create a snapshot jar, ie '
id-YYYYMMDD.hhmmss.jar'
Plugin for creating JAR files. Requires Maven 1.0 RC2.

如果你需要查看每个有效的插件和目标，输入下面内容：
C:\dev\mavenbook\code\genapp\test-application> maven -g | more
全部的插件可能使人有些畏惧，Maven有关于一切的插件，从生成项目文件到IDEs到生成WAR文件以及开始和停止应用服务器。你将在下面的实验中学习到一些更有用的插件。

生成调试信息
现在，你可能已经注意到Maven执行了许多繁重的工作。如果你使用Ant，你可能已经开始编写Ant的build.xml文件并且添加编译.jar任务和单元测试。Maven隐藏了许多复杂性，但当调试问题时，它也能够查看“幕后”。这个能力运行于Maven的调试模式并且这个工具打印输出每个构建的细节重要的是你可以根据需要来验证构建是否正确执行。


我该如何做？
本次实验，参考上一个测试应用程序。当你运行maven test，你将收到如下信息：

java:compile:[echo] Compiling to C:\dev\mavenbook\code\genapp\test-application/target/classes[echo]java:jar-resources:[...]


在执行java:comile或java:jar-resources目标时到底发生了什么？执行构建项目中运行maven -x test将显示全部目标的调试信息。让我们来是一下，把注意力放在最早的第三个目标上。运行maven -x test生成下面的输出：


[...]java:compile:[echo] Compiling to C:\dev\mavenbook\code\genapp\test-application/target/classes[javac]  DEBUG  fileset: Setup scanner in dirC:\dev\mavenbook\code\genapp\test-application\src\java withpatternSet{ includes: [ ] excludes: [**/package.html] }[javac]  VERBOSE  mdn\testapp\App.java omitted as mdn/testapp/App.classis up to date.java:jar-resources:DEBUG  FileSet: Setup scanner in dirC:\dev\mavenbook\code\genapp\test-application\src\conf withpatternSet{ includes: [*.properties] excludes: [ ] }VERBOSE  app.properties omitted as app.properties is up to date.[...]


java:compile的打印输出任务可能看起来很熟悉。它是Ant的echo和javac任务的输出。Maven常常使用Ant的进程来执行常用操作如：拷贝、删除、编译和创建JAR文件。

刚刚发生了什么？
这两个目标执行的都是非常简单的调试输出。java:compile目标简单的扫描源目录中java源码中较新的相关类文件。java:jar-resources目标寻找资源中包含的JAR文件。更复杂的如test:test将产生有关虚拟机和类加载器的调试信息。

当Maven有问题或某个目标抛出异常，Maven将简单打印较少的错误信息来告诉你有错误发生。如果你需要等多信息，并且看到堆栈跟踪，添加-e标志到命令行。与-e标志一起，Maven将打印完整的堆栈信息当其遇到错误时。

添加依赖关系
你有了一个拥有单个类文件并且已经成功编译执行的项目。下面，你将添加一个依赖关系到项目描述器并且开始使用Maven管理项目依赖关系。本次实验的目的是，假设你需要工作在Spring框架中。添加Spring框架-spring-core-1.1.4.jar和spring-web-1.1.4.jar的依赖关系。


我该如何做？
首先，你需要根据需要定位Maven默认中心源码库中的JAR文件。ibiblio.org在http://www.ibiblio.org/maven/提供了这些。在Web浏览器中加载这个URL你将看到一系列的目录；我们关心的是springframework的目录，springframework下子目录的结构如下所示：
http://www.ibiblio.org/maven
/springframework
/jars
spring-core-1.1.4.jar
spring-dao-1.1.4.jar
spring-web-1.1.4.jar

依照人造物，你使用dependency—groupId, artifactId和version三个元素。你能够添加两个依赖关系的完成品以替代test-application/project.xml中的dependencies元素如下所示：

<dependencies><dependency><groupId>springframework</groupId><artifactId>spring-core</artifactId><version>1.1.4</version></dependency><dependency><groupId>springframework</groupId><artifactId>spring-web</artifactId><version>1.1.4</version></dependency></dependencies>


现在，运行jar目标并且看看Maven的输出吧；它将包含下面如下这些。

Attempting to download spring-core-1.1.4.jar.266K downloadedAttempting to download spring-web-1.1.4.jar.111K downloaded


图1-1显示了jar目标触发的一系列事件：
1.Maven查看POM,依据project.xml的定义，看到在springframework组中的两个人造物的依赖关系。它将载你本地Maven的资源库中检查spring-core-1.1.4.jar和spring-web-1.1.4.jar。
2.当Maven找不到这些文件，它将到http://www.ibiblio.org/maven/springframework/jars/寻找JAR文件。这些JAR文件会被下载并放置于你本地Maven的资源库中。它们也被添加到你项目的classpath中。下次在你的项目查询这些文件时，Maven将在你本地的资源库中提供它们。


图1-1.Maven本地和远程资源库为test application项目提供的spring Jar。

刚刚发生了什么？
Maven为你节省了相当的时间和不必要的麻烦。Maven到来之前，依赖关系常常被捆绑到一个项目的目录或者项目应该指向到添加正确的JAR到你的classpath。使用Maven管理依赖关系显然有着明显的优势；作为初学者，如果你的项目依赖30个外部的JAR文件，这就不需要在你的资源库中存储成兆的JAR文件。这意味着当你在项目的外部检查资源控制的时候更少的存储空间和更快的下载时间。另外，如果你有多个项目依赖相同的外部依赖，Maven仅需要下载一次依赖关系，并且每个项目引用一个单独的副本在你本地的资源库中。当依赖关系能够从Maven资源库远程下载的时候，没有强制的原因让你存储你项目的依赖关系的版本。

当Maven下载依赖关系，其在你本地的机器上从远程的Maven资源库拷贝一个文件到你本地的Maven资源库。Maven如何定位依赖关系的？它使用project.xml中dependency元素的信息，如图1-2所示。


图1-2.POM和Maven资源库的映射。

指定的groupId告诉Maven查看特定的目录-springframework。指定type告诉Maven查找特定的子目录如jar和war（注意s是Maven附加到type元素上的）；本例中，type是被忽略的，JAR类型是默认类型。当你指定了artifactId，你正告诉Maven哪个文件将从jar目录下载。顶级目录表现为组标示符，JAR文件名的第一部分表现为artifact标示符，文件名最后的部分，包括扩展名表现为version标示符。Maven使用下面的公式来决定一个来自于资源库中的依赖关系。[REPO_ROOT]参考你远程的资源库：

[REPO_ROOT]/<groupId>/<type>s/<artifactId>-<currentVersion>.<type>



提示


Maven2.0的说明中，资源库可能开始于类似Java包的
结构。作为springframework的替代，groupId被提议
的结构为org.springframework。另外，每个版本将有
一个分隔目录用以增加Maven资源库的效率。更多有关
改变的提交建议，参见http://docs.codehaus.org/display/
MAVEN/Repository+Layout+-+Final。


一个本地的资源库来处理依赖关系。在Unix机器上，你的Maven资源库能在~/.maven/repository目录找到，在Windows机器上，你的Maven的资源库在你的%USERPROFILE%目录。如果你看一看本地Maven的资源库，你将会注意到它正包含一个springframework的目录。%USERPROFILE%\.maven\repository\springframework\jars目录包含spring-core依赖关系的两个：spring-core-1.1.4.jar文件和spring-core-1.1.4.jar.md5文件,其包含MD5文件用于验证sprint-core JAR文件的完整性。Maven 1当前并没有使用MD5来验证完成品的完整性，但在将来的版本可能会用其来验证完成品的完整性。


提示


在Windows机器上，%USERPROFILE%通常决定于C:\D-
ocuments and Settings\vmassol这种目录。%USERPR-
OFILE%被用在Unix的主目录。（%USERPROFILE% is
used in the spirit of the abbreviation for a Unix home directory。）


关于...
...使用id元素?

如果你工作在现存的Maven项目，你可能有依赖关系使用id元素。下面的dependencies元素示范了使用单独id元素来附加Jakarta Commons Math的1.0版本：

<dependencies><dependency><id>commons-math</id><version>1.0</version></dependency></dependencies>

单独使用id元素工作仅在groupId和artifactId匹配时，如果你浏览Maven资源库，你将看到下面的目录结构：
/commons-math
/jars
commons-math-1.0.jar
commons-math-1.1.jar

使用id元素工作，单独的id标记已经不被赞成使用并在Maven 2中消失。当你看到别的Maven项目中使用dependencies的速记符号时，请尝试使用groupId和artifactId来标识你的依赖关系。

依赖快照
如果你开发的程序依赖的依赖关系经常改变，你可能想将依赖的每个依赖关系替代为最近构件的硬编码的版本。在一个项目依赖的依赖关系还处在beta的版本，或你正开发一系列项目依赖的Maven项目时时特别有用，这将在第3章论述。本实验，你将学习到如何依靠快照。


我该如何做？
在你的依赖关系块儿中指定一个明确的版本，使用SNAPSHOT关键字作为版本名称的一部分。每次你执行Maven目标时，Maven将从远程资源库中检查较新的依赖关系。如果远程资源库的版本较新Maven将下载其到本地资源库。例如：下面的依赖关系将一直下载spring的新版JAR文件。

<dependency><groupId>springframework</groupId><artifactId>spring</artifactId><version>1.2-SNAPSHOT</version></dependency>


刚刚发生了什么？
当你使用SNAPSHOT依赖关系，你正告诉Maven使用远程资源库的最新版本。在你使用多项目插件或者当你依赖的一个完成品尚处于开发阶段这将得心应手。在你工作的团队仅有较少的开发者组成时，最好也常这么做。你将使用SNAPSHOT依赖关系当你的项目依赖一个最近的开发或者非正式版本的特别组件。SNAPSHOT依赖关系应该在开发阶段被保留，并且，概括说，你不用改发布一个依赖于SNAPSHOT依赖关系的项目。

执行脱机构建
如果你需要在一个离线的情况下使用Maven，你可能需要知道如何确使Maven不检查最新的SNAPSHOT依赖关系。本实验将向你展示如何用Maven执行脱机构建。


我该如何做？
这个方法很简单：仅仅使用-o命令行选项。例如，如果你没有网络连接，但又想执行测试目标，运行Maven -o test。Maven将执行这个test目标而不检查依赖关系。如果你的项目没有依赖SNAPSHOT构建，你也可以断看你的环境来添加-o标志。如果你依赖SNAPSHOT构建，你将需要使用-o标志，Maven将在每次执行目标时尝试检查最新的SNAPSHOT。在这种情况下不使用-o标志本项目将不会构建成功。


关于...
... 执行离线构建如果你不想下载任何完成品？
当然，这将不会工作。离线构建的工作，你必须已经有必需的依赖关系在你本地的资源库。项目最简单的获得Maven下载依赖
关系的方法是在每个Maven项目实例简单的运行“noop”目标，build:start。这个目标执行之前任何其它的目标并不执行任何动作。如果你运行build:start，Maven将从project.xml获得获取任何依赖关系。


使用Maven控制台
如果你再三的从命令行运行Maven，你可以通过Maven控制台来节省时间。Maven控制台提供一个“外壳”，在这你可以键入目标的名称来执行Maven。通过使用Maven可以避免每次载你想运行一个Maven目标时Java Virtual Machine（JVM）启动的等待。


我该如何做？
Maven Console是一个插件，你可以通过键入maven console在命令提示符。这将产生下面的输出：

__ __| \/ |__ _Apache__ ___| |\/| / _` \ V / -_) ' \ ~ intelligent projects ~|_| |_\__,_|\_/\___|_||_| v. 1.0.2The following commands are available:list - list all available goalshelp - this message<goalname> - attain a goalquit - quits the consoletest-application 1.0 >


目前，你可以在命令行执行任何你能执行的目标。开始是一下；键入 java:compile。Maven将执行 java:compile目标并返回提示符其它的目标。在一个序列中运行两个目标，你可以在提示符处输入它们，通过“空格”-例如， clean test。众所周知作为“goal chaining”这是你想通过Maven获得指定一系列目标的方法。退出Maven Console，键入quit，查看有效目标列表，键入list。

刚刚发生了什么？
在Maven Console下Maven执行java:compile目标非常之快，不信么？当你使用Maven Console时你所执行的目标是在一个现成的JVM下。当你从命令行运行Maven时，你每次运行一个目标都不得不等待JVM的启动。如果你不确信其对性能的提升，自己试试看。在命令行下运行java:complie 10次，再在Maven Console下同样运行java:compile 10次。注意时间的差别，你将发现JVM启动的时间开始增加。如果你找到你自己常用的Maven目标，Maven Console将通过启动JVM一次为来节省时间。


生成Eclipse项目
我打赌你一定想在IDE下工作。Maven通过插件来与Eclipse,InelliJ,IDEA,JBuilder,JDeveloper以及Emacs集成。Maven很好的与全部这些工作集成，本实验关注其在Eclipse上的集成，一个开源的IDE。


我该如何做？
这个过程很简单；仅仅执行eclipse插件：

C:\dev\mavenbook\code\genapp\test-application> maven eclipsebuild:start:eclipse:generate-project:[echo] Creating C:\dev\mavenbook\code\genapp\test-application/.project ...eclipse:generate-classpath:[echo] Creating C:\dev\mavenbook\code\genapp\test-application/.classpath ...[echo] Contains JUnit tests[echo] Setting compile of src/test to target/test-classesPlugin 'cactus-maven' in project 'Test Application' is not available[echo] Setting default output directory to target/classeseclipse:[echo] Now refresh your project in Eclipse (right click on the projectand select "Refresh")BUILD SUCCESSFULTotal time: 2 seconds


Maven创建两个文件以识别Eclipse的项目：.project和.classpath。在Eclipse中，你就可以通过下面的步骤导入这个工程了：
1.启动Eclipse。
2.从菜单栏选择File→Import...&#61472;
3.选择现存项目放入Workspace并单击Next按钮。
4.在Import对话框选择C:\dev\mavenbook\code\genapp\test-application目录，并单击Finish按钮。

你稍候将执行更多步来指向Eclipse到本地Maven资源库。Eclipse使用一个名叫MAVEN_REPO来指向到本地Maven资源库。你能通过在命令行执行下面的操作设置MAVEN_REPO来使用Maven:
maven -Dmaven.eclipse.workspace=c:\eclipse\workspace eclipse:add-maven-repo
执行这个目标可以设置位于目录c:\eclipse\workspace的全局变量MAVEN_REPO。
作为选择，你可以按照这些步骤手工配置该变量：
1.从菜单栏中选择Window→打开Eclipse Preferences选择preferences。
2.在树型菜单左手边的Preferences对话框，选择Java→Build Path→Classpath变量。
3.单击New按钮来创建一个新的变量；这可以带入到新变量对话框。
4.输入MAVEN_REPR到Name域。
5.单击Folder按钮选择你本地的Maven资源库。
6.单击OK并重新构建你的项目。

你可能需要配置MAVEN_REPO仅一次；该变量是全局的它可以与全部Eclipse项目共享。

关于...
... JBuilder, JDeveloper, and IntelliJ IDEA？
所有这些IDE有着Eclipse一样简单的插件。为JBuilder 项目生成必需的文件，运行mave jbuilder，对于JDeveloper运行mave jdeveloper，为IntelliJ IDEA项目运行mave idea。


使用Maven的Eclipse插件
是的，这是一个你可以使用的高品质的Maven插件。它提供了许多有趣的特性，如编辑project.xml文件的能力，支持Maven自定义，Maven资源库浏览等其他功能。


我该如何做？
Mevenide (http://mevenide.codehaus.org/mevenide-ui-eclipse/update/index.html) 是一个Eclipse插件其允许你使用Maven在Eclipse中工作。你能够按照如下指导从Eclipse更新站点上下载它：
1.启动Eclipse。
2.从菜单中选择Help→Software Updates→Find and Install。
3.在Install/Update和更新的对话框中，选择“Search for new feature to install,”并单击下一步。
4.在Install对话框中，单击New Remote Site。
5.在New Update Site对话框中，键入Mevenide在Name域，其位置在Eclipse Updates站点的URL区域。Mavenid在Eclipse Update站点中的位置是http://mevenide.codehaus.org/release/eclipse/update/site.xml。
6.当单词Mevenide出现在Install对话框中，选择两个子目标，Maven和Mevenide并单击Next。
7.直到Maven和Mevenide被下载和安装，重起Eclipse。

首先你会注意到Mevenide标注所有project.xml文件为绿色图标。在Project Object Model编辑器中打开project.xml，右击任何project.xml文件并选择Open With...→Project Object Model编辑器。该编辑器如下图1-3所显示。


Mevenide在Eclipse中提供了一系列tab让你编辑不同的project.xml片断。如果你学到了很多的project.xml语法，就知道Mevenide的Project Object Model编辑器提供了GUI接口来维护这个XML文件。如果你仍然希望直接编辑这个XML，你能够选择最右边的Source tab。
除POM编辑器之外，Mevenide也为你提供了Eclipse以外执行Maven目标的方法。要在Eclipse中执行一个Maven目标，选择Run→External Tools…→External Tools…你就能够创建一个Maven的配置并从全部有效的目标中选择你希望执行的目标。当目标在Eclipse中被执行，通过Console视图有效得显示它的输出。

Mevenide提供的另一个有趣的功能是Repository Browser。这个工具允许你检查许多远程资源库的内容。打开Repository Browser，选择Window→Show View…→Other…，此时在Maven目录的结果对话框中选择Repository Browser。Repository Browser简单的以树型显示了资源库中的全部依赖关系（dependency），如图1-4所示，其显示了HTTPClient和abbot group的依赖关系。



图1-4.Mevenide Repository Browser view

如果你想搜索资源库中完成品的细节，Mevenide同样提供了资源库搜索功能。这将是得心应手的因为为了某个依赖关系的细节搜索http://www.ibiblio.org/maven是非常恼人的。检查Mevenide；它将为你节省时间。

关于...
... NetBeans和JBuilder？
Mevenide当前的版本支持这两个IDE的表现。更多详情参见http://mevenide.codehaus.org/。
... IntelliJ？
IDEA插件维持了一些目标如同你在Eclipse中使用的目标。更多详情参见位于http://maven.apache.org/reference/plugins/idea/goals.html的IDEA插件的联机文档。


生成Ant构建文件
当你想用Apache的Ant构建的某些时候。可能你的项目使用自动化处理正依赖于Ant，又可能你有一些团队成员没有完成到Maven的转换并且他们希望继续使用Ant。目前为止许多IDE提供通过Ant构建项目文件，你能够使用Maven生成build.xml文件这样你的项目就能够被Apache的Ant所构建。


我该如何做？
运行Ant插件。运行maven ant将创建build.xml文件其包含到聚合的依赖关系的目标，build和test你的应用程序。看看运行默认的jar目标的输出：

C:\dev\mavenbook\code\genapp\test-application>antBuildfile: build.xmlinit:[mkdir] Created dir: C:\dev\mavenbook\code\genapp\target\libget-deps:[get] Getting: http://www.ibiblio.org/maven/springframework/jars/spring-core-1.1.4.jar[get] Getting: http://www.ibiblio.org/maven/springframework/jars/spring-web-1.1.4.jarcompile:[copy] Copying 1 file to C:\dev\mavenbook\code\genapp\target\classesjunit-present:[echo] = = = = = = ============ WARNING = = = == = = = = = = = = = = = = = = = = = = =[echo] Junit isn't present in your ${ANT_HOME}/lib directory. Tests notexecuted.[echo] = = ==============================================compile-tests:internal-test:test:jar:[jar] Building jar: C:\dev\mavenbook\code\genapp\test-application\target\test-application-1.0.jarBUILD SUCCESSFULTotal time: 2 seconds


你可能注意到这里存在一个问题，这是个说明性的问题。Apache Ant没有自动管理依赖关系用于可选的Ant任务。如果你向运行JUnit单元测试，你就需要从本地Maven资源库拷贝junit-3.8.1.jar到${ANT_HOME}/lib下。这个构建文件包含了一个get-deps的目标其从位于http://www.ibiblio.org/maven的远程Maven资源库为所有的项目依赖关系执行Ant获得任务到gran。

关于...
... 试图离开Ant?Maven是Ant的替代者么？
是或不是。Ant并不“差”，并且多数工具仍然同Ant工作。没有理由不提供与Apache Ant的交互，一旦你学到更多关于第2章的Jelly，你将发现Ant工作在Maven里应用的更广泛。许多项目使用持续集成的系统如其期望的Ant构建文件。运行maven ant provides很容易找到继续支持这些工具。


移植一个Ant项目到Maven
一定数量的项目使用Ant作为构建系统，你可能打算移植到Maven上来。


我该如何做？
从头开始。创建一个默认的Maven模版，并且移动你的代码到适当的位置。不要设法使Maven适合你项目的目录和构建位置。Maven强过一个构建工具；它是一个标准方式考虑到项目的布局和管理。如果你试图使Maven适应你项目的想法来构建，你将结束使用Maven。如果你的项目由一个复杂的buil.xml文件组成其产生许多不同的交付结果，你将需要“组件化”你的项目请跟随第3章的多项目描述。你可能要开始移动你项目的目录结构转向标准的Maven项目目录结构。换而言之，不要试图生搬硬套你的项目到Maven。
如果你对迁移到Ant感兴趣，但你没有时间停止开发，你可以使用Maven调用你现存的Ant目标。如果你这么做，你将错失使用Maven的大部分益处，但仅仅是可能。更多信息参见位于http://maven.apache.org/using/migrating.html的“Migrating from Ant”。

关于...
... 灵活性和选择？
灵活性和选择是个比较老的问题了。我们保证Maven将改变你构建和维护项目的方式方法，重要的是应该有意的使用Maven。Ant和Maven间的差别是什么呢？Ant提供块构建的可重用任务如copy,move,delete和junit，Maven提供了可重用的任务构建。Maven是一个“构建容器”，其允许你在一系列项目上重用任务构建。以单元测试为例，使用Ant，你将通过在你项目的build.xml文件里包含下面来执行JUnit测试。

<junit printsummary="yes" haltonfailure="yes"><classpath><pathelement location="${build.tests}"/><pathelement path="${java.class.path}"/></classpath><formatter type="plain"/><test name="my.test.TestCase" haltonfailure="no" outfile="result"><formatter type="xml"/></test><batchtest fork="yes" todir="${reports.tests}"><fileset dir="${src.tests}"><include name="**/*Test*.java"/><exclude name="**/AllTests.java"/></fileset></batchtest></junit>

该片断省略的不同路经和变量的定义如build.tests和java.class.path，同时也省略的Ant目标的定义。另外一些单元测试类，你也需要定义一个标以目标在源文件和单元测试中，并且一个目标对应创建一个目录。每个项目需要定义同样的逻辑以执行单元测试。最后，大多数的Ant项目使用了相似的目录结构，并且构建逻辑重用是通过拷贝和粘贴到build.xml文件。时间推移，项目将变的更复杂和用户化，目录标准增加并且每个项目趋于不同的编译、测试方法和包；久而久之，build.xml变成项目中的一部分了。你定制的Ant构建文件越大，越多的(entropy creeps)会进入到你的构建工作。Ant作为一个构建工具的能力要少于其作为语言提供构特性的API。1.6的Ant，含有了Ant库和宏。在完成全局可重用的表现上与Maven相比Ant还有一段很长的路要走。

利用Maven的Test插件为所有项目定义通用逻辑其需要编译和执行单元测试。单元测试插件为编译和执行单元测试获得了最好的实践，并且它为所有项目达成了最有效的实践。当你运行maven test，Maven从POM传递信息到Test插件，Test插件则依赖于Java插件来执行编译。在Maven中没有一处你明确的告诉构建容器如何执行JUnit单元测试。如果你这么做了，在Ant中你将会面对同样的问题。正如你不用告诉你的Servlet容器如何解压WAR文件一样，你不用告诉Maven如何构建你的项目。Maven是一个构建容器。许多人最初被Maven吸引是因为它提供了依赖关系管理，但Maven最大的好处是它提供了标准的开发结构来访问多个项目。依赖关系管理仅仅是标准开发结构的一个简单的副产品。


提示


Maven提供了开发结构，统一了项目布局，在最后你可
以尝试让Maven照管许多构建任务的细节。与其花费你
重要的时间来写构建脚本，不如使用Maven插件来把焦
点放到编写你应用程序上来。


下面的章节将向你展示如何调整和定制Maven，但你需要确定你并不要求Maven成为另一个Ant。很有可能你有一个巨大的重建于Ant的build.xml文件充满了Jelly脚本（见第2章）并且的Maven项目和一个大的maven.xml文件。但如果这么做你则失去了所有Maven的指向。如果你发想自己包含了很多构建相关的逻辑在你的Maven构建，你需要慎重考虑使用Maven。高定制化的Maven构建是矛盾的；你的Maven项目应该对现存插件起到杠杆作用。例如，如果你的项目需要编译Jave源文件，创建JAR文件，使用Jave插件和JAR插件。如果你忽略重用Maven插件使用Maven的Ant集成则是重复制造轮子，你最好不要使用Maven。不要滥用Maven；合理使用Maven，省省你的火气。

生成项目文档
如果你正开发Java应用程序或者库，你可能想生成JavaDoc。

我该如何做？
简单的执行javadoc目标，Maven将生成项目的文档。下面是执行javadoc目标的输出：

C:\dev\mavenbook\code\genapp\test-application>maven javadoc__ __| \/ |__ _Apache__ ___| |\/| / _` \ V / -_) ' \ ~ intelligent projects ~|_| |_\__,_|\_/\___|_||_| v. 1.0.2build:start:xdoc:init:maven-javadoc-plugin:report:[mkdir] Created dir: C:\dev\mavenbook\code\genapp\test-application\target\javadoc\src[javadoc] Generating Javadoc[javadoc] Javadoc execution[javadoc] Loading source files for package mdn.testapp...[javadoc] Constructing Javadoc information...[javadoc] Standard Doclet version 1.5.0_01[javadoc] Building tree for all the packages and classes...[javadoc] Generating C:\dev\mavenbook\code\genapp\test-application\target\docs\apidocs\constant-values.html...[javadoc] Copying file C:\Documents and Settings\tobrien\.maven\cache\maven-javadoc-plugin-1.7\plugin-resources\stylesheet.css to file C:\dev\mavenbook\code\genapp\test-application\target\docs\apidocs\stylesheet.css...[javadoc] Building index for all the packages and classes...[javadoc] Building index for all classes...[delete] Deleting directory C:\dev\mavenbook\code\genapp\testapplication\target\javadoc\srcBUILD SUCCESSFULTotal time: 7 secondsOnce this goal has been executed, JavaDoc is available in testapplication/target/javadoc/src.


刚刚发生了什么？
再次，Maven作了全部繁重的工作。你想要JaveDoc，你告诉Maven生成JaveDoc，故事结束。注意你不用告诉Maven任何你项目的情况；它“知道”如何做，Maven这很多这样的事都是直截了当的；在你告诉Maven有关你的项目后你就不用做什么了。Maven操作细节。



介绍Maven给你的团队
Maven是一个伟大的协作工具，你能够使用它生成开发者活动报告，项目捐赠者和邮件列表。


我该如何做？
许多项目有一个邮件列表其被用于讨论架构和实现。并且，通过透视图，如Tomcat服务器，Maven和Ant等项目，并不仅仅是一个开发者社区来共享捐赠到同样的邮件列表。邮件列表不仅用于开源项目；许多组织开始使用同样的协作模型用于开启，发布开发。因为邮件列表是协作的关键部分，Maven提供了在一个项目的project.xml中指定邮件列表的途径。下面引用project.xml添加邮件列表的元素：

<mailingLists><mailingList><name>Maven User List</name><subscribe>[e-mail]</subscribe><unsubscribe>[e-mail]</unsubscribe><archive>http://marc.theaimsgroup.com/?l=turbine-maven-user</archive></mailingList><mailingList><name>Maven Developer List</name><subscribe>[e-mail]</subscribe><unsubscribe>[e-mail]</unsubscribe><archive>http://marc.theaimsgroup.com/?l=turbine-maven-dev</archive></mailingList></mailingLists>


有两种类型的团队成员位于Maven项目中：捐赠者和开发者。这种定义可能改变你的项目，捐赠者通常被认为是开源社区中捐赠过补丁或文档者，开发者是一个项目的核心成员。在ASF，提交者和捐献者可以一同捐献一个项目，但捐献者既不写资源库代码又不提交大的项目决定。下面引用了project.xml添加contributor和developer元素到project.xml文件：

<developers><developer><name>Vincent Massol</name><id>vmassol</id><email>[e-mail]</email><organization>Apache Software Foundation</organization><roles><role>Author</role><role>Developer</role></roles><url>http://www.massol.net</url><timezone>+1</timezone></developer></developers><contributors><contributor><name>Tim OBrien</name><email>[e-mail]</email><organization>Apache Software Foundation</organization><roles><role>Author</role><role>Developer</role></roles><url>http://www.oreillynet.com/pub/au/1738</url><timezone>-6</timezone></contributor></contributors>


刚刚发生了什么？
你告诉Maven谁在这个项目工作，对于今后你生成项目的web站点很有用。开发者和捐赠者的信息在POM中以列表的通过站点生成插件，很多插件为资源控制生成报告。跟资源控制对话...。


向Maven到资源控制
你使用资源控制么？把它告诉给Maven，在本书的下面你将能够生成一些有兴趣的描述报告。一旦你关联了源代码资源库到你的项目，你将能够是用Maven的Source Control Management(SCM)插件，其提供了许多目标（goal）用于从诸如CVS和其子版本的版本控制系统更新和发布。


我该如何做？
你需要添加一个respository元素到你项目的project.xml文件。下面的respository元素来自于Apache Struts Framework项目，并且它指向到位于有效的子版本资源库http://svn.apache.org/repos/asf/struts framework/core/trunk：

<repository><connection>scm:svn:http://svn.apache.org/repos/asf/struts framework/core/trunk</connection><developerConnection>scm:svn:https://svn.apache.org/repos/asf/struts framework/core/trunk</developerConnection><url>http://svn.apache.org/repos/asf/struts framework/core/trunk</url></repository>

connection元素告诉Maven有关SCM只读的位置。scm标识该URL起始于SCM位置，svn告诉Maven该URL将是资源库的子项目，并且最终的片断定位于项目的trunk。你可能也指定了developerConnection，你使用该元素在你需要分隔观众人群的不可写访问和一般人群的可写访问源代码。url元素提供了能够被浏览的资源库的URL。在Struts Framework的案例中，他们选择了指向资源库到它自己，它能够被一个正常的浏览器所浏览。Struts Framework团队也可以指向到ViewCVS实例配置指向到ASF的资源库的子版本，它能够在http://cvs.apache.org/viewcvs.cgi/struts framework/core/trunk/?root=Apache-SVN的位置找到。

当你在一个详细的资源控制系统指定了project.xml，你也可以指向到一个详细项目的不同版本和分之。下面的XML展示了简化版的Apache Struts Framework项目的version和branche元素。

<versions><version><id>1.2.0</id><name>1.2.0</name><tag>STRUTS_1_2_0</tag></version><version><id>1.2.6</id><name>1.2.6</name><tag>STRUTS_1_2_6</tag></version></versions><branches><branch><tag>STRUTS_1_1_BRANCH</tag></branch><branch><tag>STRUTS_1_2_BRANCH</tag></branch></branches>

Version被用于几个插件，如Announcements插件，其用于为每个版本创建发布纪录。

关于...
... CVS？
如果你的项目使用CVS，在Jakatta Catus项目中你将需要添加一个如repository元素的资源库元素如下所示：

<repository><connection>scm:cvs:pserver:[e-mail]:/home/cvspublic:jakarta-cactus</connection><url>http://cvs.apache.org/viewcvs.cgi/jakarta-cactus/</url></repository>

在使用CVS paserver如果你暴露你的资源库上面的引用是合适的。如果你在SSH之上访问CVS，你就需要按照下面的语法设置你的CVS_RSH环境变量。

<repository><connection>scm:cvs:pserver:[e-mail]:/home/cvspublic:jakarta-cactus</connection><url>http://cvs.apache.org/viewcvs.cgi/jakarta-cactus/</url><developerConnection>scm:cvs:ext:tobrien@somehost:/home/cvs/repository:modulename</developerConnection></repository>


创建项目Web站点
Maven能够创建项目web页，包含项目的有关信息。


我该如何做？
创建一个Maven项目web站点，使用Site插件运行下面的Maven目标：
C:\dev\mavenbook\code\genapp\test-application> maven site
运行Site插件将在test-application/target/docs/index.html目录创建默认的项目站点。如果你加载这个HTML，你将发现这个站点与众不同的Maven感观。图1-5展示了一个轻量的定制web站点，包含定制的组织logo和项目logo。作为替换向你展示了人工的web站点，你能够看出这个站点的项目当前正使用Maven的构建系统-Jaxen。



图1-5.简单的Maven项目站点。

许多Maven站点有一个项目导航部分用于提供链接系统向所有的Maven项目。项目信息包含项目的有关信息，项目的邮件列表，项目的资源控制及问题跟踪（你将在第4章找到所有的这些）。通过在xdocs目录里创建和修改XML标记生成Maven web站点的目录。在图5，项目包含5个项目细节文档：Overview,FAQ,Releases,CVS Access和Status。这些文档因为被包括在xdocs/navigation.xml文件中所以他们被包含在左边的导航栏。xdocs目录是Maven存放XML XDoc格式的项目细节文档的地方。下面是Jaxen的navigation.xml文档的内容：

<?xml version="1.0" encoding="ISO-8859-1"?><project name="jaxen" repository="jaxen" href="http://jaxen.org"><title>jaxen: universal java xpath engine</title><body><links><item name="The Werken Company" href="http://www.werken.com/"/></links><menu name="jaxen"><item name="Overview" href="/index.html"/><item name="FAQ" href="/faq.html"/><item name="Releases" href="/releases.html"/><item name="CVS Access" href="/cvs-usage.html"/><item name="Status" href="/status.html"/></menu></body></project>

link元素放置一个链接http://www.werken.com到页面的右手边，项目的logo之下，menu元素包含了用以显示的左右边的导航区域。菜单中的一个文件是xdocs/index.xml。下面是Jaxen的xdocs/index.xml文件的简短目录：

<?xml version="1.0"?><document url="http://jaxen.org/index.xml"><properties><author email="[e-mail]">bob mcwhirter</author><title>jaxen</title></properties><body><section name="News"><p>Added the slidedeck from my<a href="/pdf/intro-slides.pdf">SD-West presentation</a>.</p><p>Check out these<a href="http://dom4j.org/benchmarks/xpath/index.html">PerformanceBenchmarks</a> comparing dom4j and Jaxen against Xerces and Xalan.</p></section>[...]</document>

一旦你生成了你的项目站点，加载target/docs/index.html到一个浏览器来查看你项目的web站点。

关于...
... 这些文件的语法？
你能在Maven XDoc插件的FAQ（http://maven.apache.org/reference/plugins/xdoc/faq.html）找到navigation.xml文件的更多相关语法和格式信息。并且你也能在Maven XDoc Plug-in page（http://maven.apache.org/reference/plugins/xdoc/index.html）上找到更多有关individual pages格式的信息。这个插件也面也包含更多定制站点生成插件的输出和行为的说明。
看第4章有关多样化报告的更深的分析，这样你句能够把项目活动和结构搞清楚了。


定制站点报告
站点生成创建了许多有用的报告，但依照你的风格，你可能想取出其中的某些报告。


我该如何做？
修改project.xml中的reports元素内容来改变Maven站点生成对报告的生成。下面是reports元素中的几个有效的报告活动：


<reports><report>maven-changelog-plugin</report><report>maven-changes-plugin</report><report>maven-checkstyle-plugin</report><report>maven-clover-plugin</report><report>maven-cruisecontrol-plugin</report><report>maven-developer-activity-plugin</report><report>maven-faq-plugin</report><report>maven-file-activity-plugin</report><report>maven-license-plugin</report><report>maven-linkcheck-plugin</report>Customizing Site Reports 37<report>maven-javadoc-plugin</report><report>maven-jdepend-plugin</report><report>maven-jira-plugin</report><report>maven-junit-report-plugin</report><report>maven-jxr-plugin</report><report>maven-pmd-plugin</report><report>maven-simian-plugin</report><report>maven-tasklist-plugin</report></reports>


从Maven的站点生成中排除一个报告，仅需要移除reports元素中的report的插件元素。Maven项目并未指定reports元素生成一套默认的报告：jdepend，Checkstyle，changes，changelog，developer-activity，file-activity，license，javadoc，jxr，junit，linkcheck和tacklist。当你添加一个reports元素到你项目的project.xml文件，你必须列出所有你希望获得的报告。

刚刚发生了什么？
reports元素列出了所有这些多样的reports，但你可能想了解报告提供的全部这些。表1-1提供了报告的一些摘要描述。


更多全面的插件和报告列表，参见：
Maven插件: http://maven.apache.org/reference/plugins/index.html
Maven插件沙箱: http://maven.apache.org/plugins-sandbox/index.html
Maven 在SourceForge上的插件: http://maven-plugins.sourceforge.net/
第三方Maven插件: http://maven.apache.org/reference/3rdparty.html