項(xiàng)目管理: Maven 讓事情變得簡(jiǎn)單 給您的下一個(gè) Java 構(gòu)建添加項(xiàng)目管理特性

文檔選項(xiàng) 將此頁(yè)作為電子郵件發(fā)送 未顯示需要 JavaScript 的文檔選項(xiàng) 對(duì)此頁(yè)的評(píng)價(jià) 幫助我們改進(jìn)這些內(nèi)容

級(jí)別: 初級(jí)

Charles Chan, 高級(jí)軟件開(kāi)發(fā)人員, Finetix LLC

2003 年 7 月 30 日

盡管 Ant 對(duì)于構(gòu)建 Java 程序而言是事實(shí)上的標(biāo)準(zhǔn)工具，但這個(gè)工具在許多方面都不勝任項(xiàng)目管理任務(wù)。相反，Ant 提供的東西，Maven（出自 Apache Jakarta 項(xiàng)目的高級(jí)項(xiàng)目管理工具）都能提供，而且更多。Java 開(kāi)發(fā)人員 Charles Chan 將介紹 Maven 的特性，并循序漸進(jìn)地指導(dǎo)您進(jìn)行一次完整的 Maven 項(xiàng)目設(shè)置。

目前，絕大多數(shù)開(kāi)發(fā)人員都把 Ant 當(dāng)作 Java 編程項(xiàng)目的標(biāo)準(zhǔn)構(gòu)建工具。遺憾的是，Ant 的項(xiàng)目管理工具（作為 make 的替代工具）不能滿足絕大多數(shù)開(kāi)發(fā)人員的需要。通過(guò)檢查 Ant 構(gòu)建文件，很難發(fā)現(xiàn)項(xiàng)目的相關(guān)性信息和其它元信息（如開(kāi)發(fā)人員／擁有者、版本或站點(diǎn)主頁(yè)）。

Maven 除了以程序構(gòu)建能力為特色之外，還提供 Ant 所缺少的高級(jí)項(xiàng)目管理工具。由于 Maven 的缺省構(gòu)建規(guī)則有較高的可重用性，所以常常用兩三行 Maven 構(gòu)建腳本就可以構(gòu)建簡(jiǎn)單的項(xiàng)目，而使用 Ant 則需要十幾行。事實(shí)上，由于 Maven 的面向項(xiàng)目的方法，許多 Apache Jakarta 項(xiàng)目現(xiàn)在使用 Maven，而且公司項(xiàng)目采用 Maven 的比例在持續(xù)增長(zhǎng)。

Maven vs Ant

那么，Maven 和 Ant 有什么不同呢？在回答這個(gè)問(wèn)題以前，我要強(qiáng)調(diào)一點(diǎn)：Maven 和 Ant 針對(duì)構(gòu)建問(wèn)題的兩個(gè)不同方面。Ant 為 Java 技術(shù)開(kāi)發(fā)項(xiàng)目提供跨平臺(tái)構(gòu)建任務(wù)。Maven 本身描述項(xiàng)目的高級(jí)方面，它從 Ant 借用了絕大多數(shù)構(gòu)建任務(wù)。因此，由于 Maven 和 Ant 代表兩個(gè)差異很大的工具，所以我將只說(shuō)明這兩個(gè)工具的等同組件之間的區(qū)別，如表 1 所示。

表 1. Maven vs Ant

回頁(yè)首

Maven 的主要組件

既然您了解了 Maven 和 Ant 之間的區(qū)別，讓我們來(lái)研究 Maven 的主要組件，如圖 1 所示。

項(xiàng)目對(duì)象模型

項(xiàng)目對(duì)象模型（Project Object Model，POM）描述項(xiàng)目的各個(gè)方面。盡管對(duì)于 POM 的物理表示沒(méi)有內(nèi)在的限制，但 Maven 開(kāi)發(fā)人員通常使用一個(gè) XML 項(xiàng)目文件（project.xml）。該 XML 文件格式由位于 Maven 安裝目錄中的 XML 模式（maven-project.xsd）定義。

通常，project.xml 文件由三個(gè)主要部分組成：

• 項(xiàng)目管理部分包括項(xiàng)目的組織、開(kāi)發(fā)人員名單、源代碼位置和錯(cuò)誤跟蹤系統(tǒng) URL 等信息。
• 項(xiàng)目相關(guān)性部分包括關(guān)于項(xiàng)目相關(guān)性的信息。當(dāng)前 Maven 實(shí)現(xiàn)（1.0 beta 測(cè)試版 8）僅支持 JAR 文件相關(guān)性。
• 項(xiàng)目構(gòu)建和報(bào)告部分包含項(xiàng)目構(gòu)建信息（如源代碼目錄、單元測(cè)試用例目錄）和要在構(gòu)建中生成的報(bào)告。

清單 1 顯示了帶注釋的樣本 project.xml 文件。因?yàn)?project.xml 文件中的許多元素都是可選的，所以，隨著您對(duì) Maven 理解的加深，可以逐步使用不同的 Maven 特性。 注：在以下代碼中，可選的元素都以“可選的（OPTIONAL）”標(biāo)明。

主文檔包含項(xiàng)目的唯一標(biāo)識(shí)和組標(biāo)識(shí)。事實(shí)證明，當(dāng)項(xiàng)目包括多個(gè)子項(xiàng)目時(shí)，組標(biāo)識(shí)非常有用。所有的子項(xiàng)目應(yīng)共享同一組標(biāo)識(shí)，但每個(gè)子項(xiàng)目應(yīng)有不同的 <id> 。

<?xml version="1.0" encoding="ISO-8859-1"?>

<!-- A project file's root element -->
<project>
  <!-- The POM version. This tag is currently unused. -->
  <pomVersion>3</pomVersion>

  <!-- A project group id. If present, the id serves as the project's
        directory name in the repository -->
  <groupId>crayola-group</groupId>

  <!-- A unique project identifier. The project identifier and its
        version number often generate file/directory names during the
        build. For example, a project JAR file follows the
        <id>-<version> naming convention. -->
  <id>crayola</id>

  <!-- A short name for the project -->
  <name>Crayola Professional</name>

  <!-- The project version number. Maven does not enforce a particular
        version numbering scheme. -->
  <currentVersion>0.0.1</currentVersion>

  ...
  <!-- 
---------------------------------------------------------------- -->
  <!-- Project management section                                -->
  <!-- 
---------------------------------------------------------------- -->
  ...
  <!-- 
---------------------------------------------------------------- -->
  <!-- Project dependency section                                -->
  <!-- 
---------------------------------------------------------------- -->
  ...
  <!-- 
---------------------------------------------------------------- -->
  <!-- Project build and reports section                         -->
  <!-- 
---------------------------------------------------------------- -->
  ...
</project>

項(xiàng)目管理部分（如清單 2 所示）主要包括可選項(xiàng)。在此部分中指定開(kāi)發(fā)人員名單（帶有正確的標(biāo)識(shí)），當(dāng)您希望獲得更改日志（Change Log）報(bào)告和開(kāi)發(fā)活動(dòng)（Development Activity）報(bào)告時(shí)尤其要這么做。

  
...
<!-- 
---------------------------------------------------------------- -->
  <!-- Project management section                                -->
  <!-- 
---------------------------------------------------------------- -->

  <!-- Details of the organization holding the project. Only the name
        is required. -->
  <organization>
    <name>Markers Inc.</name>
    <url>http://w3.markers.com/</url>
    
<logo>http://w3.markers.com/logo/company-logo.gif</logo>
  </organization>

  <!-- (OPTIONAL) Year of inception -->
  <inceptionYear>2003</inceptionYear>

  <!-- (OPTIONAL) Project main package -->
  <package>com.markers.crayola.*</package>

  <!-- (OPTIONAL) Project logo picture (URL) -->
  <logo>http://w3.markers.com/logo/crayola.gif</logo>

  <!-- (OPTIONAL) GUMP repository ID. Useful only if you use GUMP. -->
  <gumpRepositoryId>crayola</gumpRepositoryId>

  <!-- (OPTIONAL) Project description -->
  <description>...</description>

  <!-- (OPTIONAL) Short project description -->
  <shortDescription>...</shortDescription>

  <!-- (OPTIONAL) Project site URL -->
  <url>http://w3.markers.com/crayola</url>

  <!-- (OPTIONAL) Issue-tracking system URL -->
  
<issueTrackingUrl>http://w3.markers.com/jira/crayola</issueTrackingUrl>

  <!-- (OPTIONAL) Project site address. -->
  <siteAddress>w3.markers.com</siteAddress>

  <!-- (OPTIONAL) Project-site deploy directory (physical location) -->
  <siteDirectory>/www/crayola/site/</siteDirectory>

  <!-- (OPTIONAL) Project distribution directory (physical location) -->
  
<distributionDirectory>/www/crayola/builds/</distributionDirectory>

  <!-- (OPTIONAL) Project source-repository information -->
  <repository>
    
<connection>
scm:cvs:pserver:anoncvs@cvs.markers.com:/home/cvspublic:crayola
</connection>
    <url>http://cvs.markers.com/viewcvs/crayola/</url>
  </repository>

  <!-- (OPTIONAL) Mailing list information -->
  <mailingLists>
    <mailingList>
      <name>Dev List</name>
      
<subscribe>dev-subscribe@crayola.markers.com</subscribe>
      
<unsubscribe>dev-unsubscribe@crayola.markers.com</unsubscribe>
    </mailingList>
    ...
  </mailingLists>

  <!-- Developers involved in this project -->
  <developers>
    <developer>
      <name>John Smith</name>
      <id>jsmith</id>
      <email>jsmith@markers.com</email>
    </developer>
    ...
  </developers>

將清單 3 中的信息與一個(gè)中央構(gòu)件資源庫(kù)一起使用，將消除幾個(gè)常見(jiàn)的構(gòu)建問(wèn)題（包括錯(cuò)誤配置的 CLASSPATH 或相關(guān)性-版本不匹配）。

  <!-- 
---------------------------------------------------------------- -->
  <!-- Project dependency section                                -->
  <!-- 
---------------------------------------------------------------- -->

  <dependencies>

    <!-- This project depends on the JAR file "commons-beanutils-1.5.jar"
          in the Maven repository's commons-beanutils/jars subdirectory
          (more about repository later). -->
    <dependency>
      <groupId>commons-beanutils</groupId>
      <artifactId>commons-beanutils</artifactId>
      <version>1.5</version>
    </dependency>

    <!-- This project depends on the JAR file "commons-lib-2.1.jar" in
          the Maven repository's markers/jars subdirectory. -->
    <dependency>
      <groupId>markers</groupId>
      <artifactId>commons-lib</artifactId>
      <version>2.1</version>
    </dependency>

  </dependencies>

項(xiàng)目構(gòu)建和報(bào)告部分（如清單 4 所示）包含用于配置某些 Maven 插件的重要構(gòu)建和報(bào)告信息。例如，可以配置 Maven 在站點(diǎn)文檔生成時(shí)包含還是排除某些報(bào)告。

  ...
  <!-- 
---------------------------------------------------------------- -->
  <!-- Project build and reports section                         -->
  <!-- 
---------------------------------------------------------------- -->

  <build>

    <!-- (OPTIONAL) Build notification email address. -->
    <nagEmailAddress>jsmith@markers.com</nagEmailAddress>

    <!-- (OPTIONAL) Defines where the Java source resides. -->
    <sourceDirectory>src/java</sourceDirectory>

    <!-- (OPTIONAL) Defines where the Java source for unit test-cases
          resides. -->
    
<unitTestSourceDirectory>test/java</unitTestSourceDirectory>

    <!-- (OPTIONAL) Unit test-case file pattern. -->
    <unitTest>
      <includes>
        <include>**/*Test.java</include>
      </includes>
    </unitTest>

    <!-- (OPTIONAL) Resources packaged inside the JAR file. -->
    <resources/>

    <!-- (OPTIONAL) The reports tag lets you select which reports you
          want generated for your site. In this case, only the checkstyle
          report will generate. -->
  </build>

  <reports>
    <report>
      maven-checkstyle-plugin
    </report>
  </reports>

項(xiàng)目依靠庫(kù)來(lái)實(shí)現(xiàn)其功能。例如，您的項(xiàng)目可能依靠 log4j 進(jìn)行日志記錄，依靠 Xalan 進(jìn)行 XSLT 轉(zhuǎn)換。對(duì)于 J2EE 項(xiàng)目，Web 組件可能依靠 EJB 組件來(lái)執(zhí)行業(yè)務(wù)操作。Maven 可以讓您用它的 POM 來(lái)表示不同的相關(guān)性。您可以用表 2 所示的標(biāo)記在 project.xml 文件中描述每一個(gè)相關(guān)性。

表 2. 項(xiàng)目相關(guān)性部分

資源庫(kù)

資源庫(kù)是另一個(gè)主要的 Maven 組件。在有多個(gè)項(xiàng)目的基于 Java 的站點(diǎn)中，由第三方庫(kù)組成的中央資源庫(kù)常常確保項(xiàng)目之間的一致性。Maven 使資源庫(kù)的結(jié)構(gòu)符合標(biāo)準(zhǔn)，并且支持駐留在因特網(wǎng)或內(nèi)部網(wǎng)上的遠(yuǎn)程資源庫(kù)。清單 5 顯示了資源庫(kù)的常規(guī)結(jié)構(gòu)。

repository
|-- ant                   <-- project group ID -->
|   `-- jars              <-- artifact type, followed by 's', 
|                         <-- e.g. jars, wars, ears -->
|       `-- ant-1.5.1.jar <-- actual artifact -->
...

要?jiǎng)?chuàng)建遠(yuǎn)程資源庫(kù)，只需將這個(gè)資源庫(kù)的目錄部署在網(wǎng)站中。Maven 建議使用遠(yuǎn)程資源庫(kù)以便于集中維護(hù)，您將會(huì)最大程度地實(shí)現(xiàn)項(xiàng)目之間資源的共享。為避免每次構(gòu)建時(shí)都要下載文件，Maven 在首次下載必需的相關(guān)性資源時(shí)就自動(dòng)地將其高速緩存在本地資源庫(kù)中。Maven 將表 3 中所示的特性用于遠(yuǎn)程資源庫(kù)和本地資源庫(kù)。

表 3. 用于遠(yuǎn)程資源庫(kù)和本地資源庫(kù)的特性

Maven 中的 Ant 任務(wù) Maven 中的 goal 可在其定義中包含任何有效的 Ant 任務(wù)，這一點(diǎn)有助于您快速掌握 Maven 以及保護(hù)您的 Ant 投入。

goal

Maven 中的 goal 類似 Ant 中的 target 。兩者都包含實(shí)現(xiàn) goal（或 target）時(shí)會(huì)執(zhí)行的任務(wù)。要在命令行中實(shí)現(xiàn)特定的 goal，可輸入 maven <goal> 。

要列出所有已定義的 goal，可使用 maven -g 。表 4 列出了常用的 goal。

表 4. 常用的 goal

Maven 的 goal 是可擴(kuò)展和可重用的。知道了這一點(diǎn)后，在編寫(xiě)自己的 goal 之前，可先在 Maven 站點(diǎn)上或 ${MAVEN_HOME}/plugins 中查看 Maven 插件列表。另一個(gè)關(guān)于免費(fèi) Maven 插件的較佳資源是 SourceForge 上的 Maven 插件項(xiàng)目。（以上各項(xiàng)的鏈接可在 參考資料中獲得）。

如果仍不能找到符合您要求的 goal，Maven 給您兩種選擇：

• 編寫(xiě) <preGoal> 或 <postGoal> 來(lái)擴(kuò)展標(biāo)準(zhǔn) goal
• 編寫(xiě)自己的 goal

無(wú)論選擇哪種，都要在項(xiàng)目目錄中創(chuàng)建名為 maven.xml 的特殊文件。清單 6 顯示了框架 maven.xml。

      <?xml version="1.0" encoding="ISO-8859-1"?>
      <project xmlns:j="jelly:core">
        ...
        <goal name=...>
          ... build rules, e.g.
          <mkdir dir="${test.result.dir}"/>
          <echo>Executing JUnit tests</echo>
          ...
        </goal>
        ...
        <preGoal name=...>
          ...
        </preGoal>

        <postGoal name=...>
          ...
        </postGoal>

      </project>

熟悉 Ant 的開(kāi)發(fā)人員會(huì)發(fā)現(xiàn) Maven 的 goal（同樣還有 preGoal 和 postGoal ）可在其定義中包含任何有效的 Ant 任務(wù)，這有助于快速學(xué)習(xí) Maven 并保護(hù)在 Ant 上的投入。為了給 Ant 任務(wù)添加動(dòng)態(tài)性，Maven 也使用 Jelly 腳本編制語(yǔ)言?！?基礎(chǔ) Jelly 編程”用一個(gè)樣本 maven.xml 文件介紹 Jelly 腳本編制語(yǔ)言。

編寫(xiě) <preGoal> 和 <postGoal>
Ant 的 <target> 與 makefile 規(guī)則的相似之處在于：定義了規(guī)則以后，前提條件和后置條件是固定的。這使得在多個(gè)項(xiàng)目間重用構(gòu)建規(guī)則變得更加困難。例如，某個(gè)項(xiàng)目中的 compile target 可能依靠 XDoclet 生成源文件，而另一個(gè) compile target 可能不包括任何先決條件。為了克服這種限制，Maven 提供了兩個(gè)特殊標(biāo)記： <preGoal> 和 <postGoal> 。從標(biāo)記的名稱可以看出： preGoal 定義在指定的 goal 之前執(zhí)行的構(gòu)建規(guī)則。另一方面， postGoal 定義實(shí)現(xiàn)指定 goal 之后要執(zhí)行的構(gòu)建規(guī)則。例如，清單 7 中的 preGoal 指示 Maven 在編譯源代碼之前用 XDoclet 生成源文件。

        <preGoal name="java:compile">
          <attainGoal name="xdoclet:ejbdoclet"/>
        </preGoal>

Maven 還提供與 Ant 的 <antcall> 標(biāo)記相似的 <attainGoal> 標(biāo)記，以便在確有必要直接實(shí)現(xiàn) goal 的情況（如上例）下使用。

編寫(xiě)自己的 goal
如果 goal 是特定于項(xiàng)目的，則可在 maven.xml 文件中定義自己的 goal。這些自定義的 goal 會(huì)覆蓋其它同名的 goal。如果項(xiàng)目包括子項(xiàng)目，子項(xiàng)目也繼承這些 goal。

編寫(xiě)插件
為了在項(xiàng)目間共享 goal，可在 Maven 安裝插件目錄（ ${MAVEN_HOME}/plugins ）中將其打包為插件。典型的 Maven 插件包含 project.xml 和 plugin.jelly 文件。project.xml 文件描述插件的 POM；plugin.jelly 類似 maven.xml 且包含該插件所展示的 goal。插件可以有自己的資源和相關(guān)性信息。預(yù)先定義的變量 ${plugin.dir} 讓用戶引用插件目錄中的資源。例如，在清單 8 中所示的插件結(jié)構(gòu)中， ${plugin.dir}/dtd/web-app_2_3.dtd 可訪問(wèn) plugin.jelly 中的 web-app_2_3.dtd 。

    ejbjar-plugin-1.0
    |-- dtd
    |   |-- application_1_3.dtd
    |   |-- ejb-jar_2_0.dtd
    |   |-- web-app_2_3.dtd
    |-- plugin.jelly
    `-- project.xml

回頁(yè)首

安裝 Maven

最近發(fā)行的 Maven 1.0-beta-8 基本上是 1.0 的功能完善版。因?yàn)?Maven 開(kāi)發(fā)社區(qū)每天都在修正錯(cuò)誤，如果您遇到任何無(wú)法正常工作的問(wèn)題，則立即從 CVS（Concurrent Version System，并發(fā)版本控制系統(tǒng)）獲得最新 Maven 版本，然后自行構(gòu)建（請(qǐng)參閱 參考資料以獲得指示信息）。下載了最新的 Maven 源代碼之后，可通過(guò)調(diào)用以下命令來(lái)構(gòu)建 Maven：

      ant -f build-bootstrap.xml

      (set MAVEN_HOME to where you want Maven to reside and
      use Ant 1.5.1 to perform the build)

如果在防火墻之后操作，請(qǐng)正確設(shè)置以下特性： maven.proxy.host 、 maven.proxy.port 、 maven.proxy.username 和 maven.proxy.password 。缺省情況下，Maven 資源庫(kù)駐留在 ${MAVEN_HOME}/repository 中；通過(guò)將 maven.repo.local 特性設(shè)置為新位置，可以更改 Maven 資源庫(kù)的位置。

樣本項(xiàng)目文件 請(qǐng)參閱在這個(gè)樣本 J2EE 項(xiàng)目中使用的 Maven 項(xiàng)目文件。

回頁(yè)首

樣本 J2EE 項(xiàng)目

掌握了到目前為止所學(xué)的知識(shí)后，就可以著手使用 Maven 了。本節(jié)描述如何用 Maven 設(shè)置一個(gè)樣本 J2EE 項(xiàng)目。

項(xiàng)目目錄布局

在進(jìn)行詳細(xì)介紹之前，我先說(shuō)明一下項(xiàng)目的目錄布局。盡管不作要求，但事實(shí)證明一致的跨項(xiàng)目目錄布局非常有用，因?yàn)槭煜ち艘粋€(gè)項(xiàng)目的開(kāi)發(fā)人員可以輕松地瀏覽其它項(xiàng)目。更重要的是，一致的目錄布局可讓您編寫(xiě)通用的構(gòu)建規(guī)則。

Maven 的目錄布局指南（請(qǐng)參閱 參考資料）適用于絕大多數(shù)項(xiàng)目。作為演示，我使用略微不同的布局，如清單 9 所示。

 project
 |
 |-- LICENSE.txt
 |-- project.properties
 |-- maven.xml
 |-- project.xml
 |-- src
 |   `-- java
 |       `-- com/....
 |   `-- conf
 |       `-- Configuration files for staging environments.
 |-- test
 |   `-- java
 |       `-- com/....
 |   `-- conf
 |       `-- Configuration files for unit testing environments.
 `-- xdocs
     `-- index.xml

一個(gè) J2EE 項(xiàng)目通常生成 WAR 文件、EJB JAR 文件和 EAR 文件。因?yàn)槊糠N文件都包括自己的相關(guān)性信息和源文件，所以應(yīng)將其作為單獨(dú)項(xiàng)目來(lái)構(gòu)建。通常，通過(guò)將子項(xiàng)目存儲(chǔ)為主項(xiàng)目的子目錄，來(lái)構(gòu)造這一項(xiàng)目／子項(xiàng)目關(guān)系。我們的布局如清單 10 所示。

j2ee-project
|
|-- project.xml       - Produces the EAR file
|
|-- util-subproject
|   |
|   `-- project.xml   - Produces the Utility JAR file
|
|-- ejb-subproject
|   |
|   `-- project.xml   - Produces the EJB JAR file
|
`-- web-subproject
    |
    `-- project.xml   - Produces the WAR file

項(xiàng)目繼承

項(xiàng)目繼承讓 POM 以類似于對(duì)象繼承的方式從主 POM 繼承 ― 由于這些項(xiàng)目之間的細(xì)微差別（主要是相關(guān)性的差別），這一特性在此尤為重要。項(xiàng)目管理部分可在主 project.xml 中集中維護(hù)。要使用項(xiàng)目繼承，可使用 project.xml 中的 <extend> 標(biāo)記（請(qǐng)參閱“ 樣本項(xiàng)目文件”中的清單 2）。

樣本項(xiàng)目的 goal

既然已經(jīng)定義了 POM，就可以編寫(xiě)它們的 goal。因?yàn)檫@些 goal 使用 POM 中定義的特性，所以在繼續(xù)之前應(yīng)該首先理解“ 樣本項(xiàng)目文件”中的 project.xml 文件。

Utility 子項(xiàng)目

由于 Utility 子項(xiàng)目生成一個(gè)包含源目錄中類的 JAR 文件 ― 由缺省的 jar:jar goal 即可滿足要求，因此這里不需要定制的 goal。

因?yàn)?Web 子項(xiàng)目和 EJB 子項(xiàng)目都依靠 Utility 子項(xiàng)目，所以，在構(gòu)建 Web 子項(xiàng)目和 EJB 子項(xiàng)目之前，應(yīng)該調(diào)用 jar:install goal 以將 Utility 子項(xiàng)目 JAR 文件部署到本地資源庫(kù)。這樣，WAR 子項(xiàng)目和 EJB 子項(xiàng)目就可以正確地解析相關(guān)性。

Web 子項(xiàng)目

Web 子項(xiàng)目生成一個(gè) WAR 文件，該文件包含源目錄的類、 jsp 目錄中的 JSP 文件和 conf 目錄中的 web.xml 文件。缺省 war:war goal 有更簡(jiǎn)單的關(guān)于項(xiàng)目目錄布局的視圖。要重用該 goal，可如下定制其行為：

1. 在項(xiàng)目的 project.properties 文件中，將特性 maven.war.src 和 maven.war.webxml 分別設(shè)置為 ${maven.build.dir}/webapp 和 ${maven.src.dir}/conf/web.xml 。這告訴 war:war 在哪里查找 Web 來(lái)源（JSP 頁(yè)面、HTML 靜態(tài)頁(yè)面和圖像等）和 web.xml 文件。
   
2. 定義一個(gè)將所有 JSP 文件復(fù)制到 ${maven.build.dir}/webapp 目錄中的 preGoal 。以下 maven.xml 可實(shí)現(xiàn)這一效果：

   <?xml version="1.0" encoding="ISO-8859-1"?> <project> <preGoal name="war:init"> <copy todir="${maven.build.dir}/webapp"> <fileset dir="${maven.src.dir}/jsp" include="*.jsp"/> </copy> </preGoal> </project>

   
   

當(dāng)調(diào)用 war:war goal 時(shí)，請(qǐng)注意 Utility JAR 文件和 commons-beanutils JAR 文件都被打包到 WAR 文件。通過(guò)查看 project.xml 文件的相關(guān)性部分中的 war.bundle.jar 特性，Maven 知道要在 WAR 文件中包括哪個(gè)文件。

EJB 子項(xiàng)目

給 EJB JAR 文件打包和給 JAR 文件打包相似。如果項(xiàng)目設(shè)置與缺省 ejb goal 不匹配，可應(yīng)用以上“Web 子項(xiàng)目”一節(jié)中所描述的技術(shù)。在這個(gè)特定例子中，將 ejb-jar.xml 從 conf 目錄復(fù)制到 ${maven.build.dir}/ejb/META-INF 目錄，并將 maven.ejb.src 特性設(shè)置為 ${maven.build.dir}/ejb 。

要將相關(guān)性 JAR 文件添加到 EJB JAR 的清單類路徑（manifest classpath）中，可在相關(guān)性部分中使用 ejb.manifest.classpath 特性。

主（EAR）項(xiàng)目

在成功編譯并部署了子項(xiàng)目（使用 jar:install 、 war:install 和 ejb:install goal）之后，即可創(chuàng)建最終的 EAR 文件。相關(guān)性特性 ear.bundle.jar 、 ear.bundle.ejb 和 ear.bundle.war 告訴 ear 插件要在 EAR 文件中包括哪些文件。（對(duì)于 Maven 1.0-beta-8，WAR 文件不是受支持的相關(guān)性類型，因此 EAR 插件不能正確地給 WAR 文件打包。解決辦法：使用 postGoal 手工更新 EAR 文件。）

reactor：自動(dòng)構(gòu)建子項(xiàng)目

構(gòu)建 J2EE 項(xiàng)目需要大量的工作。事實(shí)證明，每次項(xiàng)目更改時(shí)重復(fù)同樣的過(guò)程耗費(fèi)時(shí)間而且容易出錯(cuò)。為幫助解決這些問(wèn)題，Maven 的 reactor 功能部件以正確的順序自動(dòng)構(gòu)建子項(xiàng)目，這樣就節(jié)省了時(shí)間且減少了錯(cuò)誤。

清單 11 的 maven.xml 演示了定義 reactor 的方法。

<?xml version="1.0" encoding="ISO-8859-1"?>
<project default="all"
         xmlns:m="jelly:maven">

  <goal name="all">
    <m:reactor basedir="${basedir}"
               includes="*/project.xml"
               goals="install"
               banner="Building"
               ignoreFailures="false"/>
  </goal>
</project>

該 reactor 首先在 basedir 目錄下搜索 project.xml 文件，然后調(diào)用 install goal。執(zhí)行的順序取決于每個(gè)項(xiàng)目中的相關(guān)性部分。此外，通?？梢栽谥黜?xiàng)目的 maven.xml 文件中定義 reactor。因?yàn)?goal 在子項(xiàng)目中繼承，所以選擇 goal 的名稱時(shí)要當(dāng)心。

回頁(yè)首

參與其中

盡管 Maven 是功能豐富的產(chǎn)品，但它仍處于 beta 測(cè)試版階段。因此錯(cuò)誤可能在任何地方突然出現(xiàn)。別慌。要找到解決錯(cuò)誤的答案，最好的辦法是搜索 Maven 的郵件列表歸檔（請(qǐng)參閱 參考資料）以了解相關(guān)的通告。如果沒(méi)有任何發(fā)現(xiàn)，試著將問(wèn)題公布到郵件列表，以便得到別人的建議。郵件列表上列出的人一般都樂(lè)于給予幫助。

要正式地報(bào)告錯(cuò)誤，請(qǐng)?jiān)L問(wèn) Maven 項(xiàng)目的問(wèn)題跟蹤系統(tǒng)（請(qǐng)參閱 參考資料）。

一旦熟悉了 Maven，您可能會(huì)在插件的實(shí)現(xiàn)中找到絕大多數(shù)答案。當(dāng)您達(dá)到專家水平并且相信 Maven 大有前途的時(shí)候，請(qǐng)向社區(qū)提供補(bǔ)丁，幫助 Maven 成長(zhǎng)。

回頁(yè)首

結(jié)束語(yǔ)

隨著如今的項(xiàng)目變得越來(lái)越復(fù)雜，我們需要能幫助我們表示并管理這些復(fù)雜性的工具。Maven 將項(xiàng)目對(duì)象模型與功能強(qiáng)大的 XML 腳本編制語(yǔ)言相結(jié)合，為我們提供了這樣的工具。在本文中，您已經(jīng)了解如何定義 POM 以及如何使用 Maven 的 goal 機(jī)制構(gòu)建項(xiàng)目。我們還研究了使用 Jelly 定制構(gòu)建行為的不同方法。最后，利用一個(gè)樣本 J2EE 項(xiàng)目，我們將概念在實(shí)際中加以應(yīng)用。希望您下載 Maven 以推動(dòng)其發(fā)展。

作者感謝 Jason van Zyl 對(duì)本文的評(píng)審。

回頁(yè)首

參考資料

• 您可以參閱本文在 developerWorks 全球站點(diǎn)上的 英文原文.
  
  
• 有關(guān) Maven 及其各種插件的更多信息，請(qǐng)?jiān)L問(wèn) Maven網(wǎng)站。您將在那里發(fā)現(xiàn)有用的參考資料，包括：
  • 推薦的 目錄布局
  • 內(nèi)置插件文檔
  • 郵件列表
  • 使用 Maven 的 項(xiàng)目列表
  • Maven CVS 資源庫(kù)
  • Maven User Guide，針對(duì) 1.0-beta-8 更新
  
  
  
• Sourceforge.net 的 Maven 插件項(xiàng)目提供免費(fèi) Maven 插件。
  
  
  
• Maven 的 問(wèn)題跟蹤系統(tǒng)可用于報(bào)告和查詢錯(cuò)誤。
  
  
  
• Jelly 網(wǎng)站對(duì) Jelly 標(biāo)記的出色引用是該站點(diǎn)的一大亮點(diǎn)。
  
  
  
• Maven 的 API 文檔在您使用 Jelly 編寫(xiě)構(gòu)建規(guī)則時(shí)會(huì)非常有用。
  
  
  
• Ant 網(wǎng)站提供對(duì) Ant 任務(wù)的出色引用。在 Maven 中可使用絕大多數(shù) Ant 任務(wù)。
  
  
  
• 教程“ Using JavaScript with Ant”向您演示如何用 JavaScript 編寫(xiě)動(dòng)態(tài) Ant 任務(wù)。
  
  
  
• Krysalis Centipede是另一個(gè)基于 Ant 的構(gòu)建系統(tǒng)。
  
  
  
• 在“ Extending Ant to support interactive builds”（ developerWorks，2001 年 11 月）中，Anthony Young-Garner 向您演示如何在構(gòu)建中加入交互式支持，以便為最終用戶提供更順暢、更靈活的體驗(yàn)。
  
  
  
• Malcolm Davis 撰寫(xiě)的“ 利用 Ant 和 JUnit 進(jìn)行增量開(kāi)發(fā)”（ developerWorks，2000 年 11 月）建議用單元測(cè)試改進(jìn)代碼。
  
  
  
• GUMP是連續(xù)集成相互從屬的項(xiàng)目的工具。
  
  
  
• “ Automated builds with VisualAge for Java and Ant”（ WebSphere 開(kāi)發(fā)者園地，2001 年 1 月）介紹如何為項(xiàng)目創(chuàng)建自動(dòng)化構(gòu)建。
  
  
  
• 您將在 developerWorksJava 技術(shù)專區(qū) 找到涉及 Java 編程各個(gè)方面的數(shù)百篇文章。
  
  

回頁(yè)首

關(guān)于作者

	Charles Chan 是 Finetix LLC 的一名顧問(wèn)。Charles 的興趣包括分布式系統(tǒng)、高性能計(jì)算、國(guó)際化和軟件設(shè)計(jì)模式。在業(yè)余時(shí)間，他為開(kāi)放源碼社區(qū)撰稿?？梢酝ㄟ^(guò) charlesc@ibiblio.org 與 Charles 聯(lián)系。