轉載地址：juvenshun.VEvb.com/blog/305865
“分天下為三十六郡，郡置守，尉，監” —— 《史記·秦始皇本紀》
所有用Maven管理的真實的項目都應該是分模塊的，每個模塊都對應著一個pom.xml。它們之間通過繼承和聚合（也稱作多模塊，multi-module）相互關聯。那么，為什么要這么做呢？我們明明在開發一個項目，劃分模塊后，導入Eclipse變成了N個項目，這會帶來復雜度，給開發帶來不便。
為了解釋原因，假設有這樣一個項目，很常見的java Web應用。在這個應用中，我們分了幾層：
對應的，在一個項目中，我們會看到一些包名：
org.myorg.app.dao org.myorg.app.service org.myorg.app.web org.myorg.app.util
這樣整個項目的框架就清晰了，但隨著項目的進行，你可能會遇到如下問題：
我們會發現，其實這里實際上沒有遵守一個設計模式原則：“高內聚，低耦合”。雖然我們通過包名劃分了層次，并且你還會說，這些包的依賴都是單向的，沒有包的環依賴。這很好，但還不夠，因為就構建層次來說，所有東西都被耦合在一起了。因此我們需要使用Maven劃分模塊。
一個簡單的Maven模塊結構是這樣的：
---- app-parent
|-- pom.xml (pom)
|
|-- app-util
| |-- pom.xml (jar)
|
|-- app-dao
| |-- pom.xml (jar)
|
|-- app-service
| |-- pom.xml (jar)
|
|-- app-web
|-- pom.xml (war)
上述簡單示意圖中，有一個父項目(app-parent)聚合很多子項目（app-util, app-dao, app-service, app-web）。每個項目，不管是父子，都含有一個pom.xml文件。而且要注意的是，小括號中標出了每個項目的打包類型。父項目是pom,也只能是pom。子項目有jar，或者war。根據它包含的內容具體考慮。
這些模塊的依賴關系如下：
app-dao --> app-util
app-service --> app-dao
app-web --> app-service
注意依賴的傳遞性（大部分情況是傳遞的，除非你配置了特殊的依賴scope），app-dao依賴于app-util，app-service依賴于app-dao，于是app-service也依賴于app-util。同理，app-web依賴于app-dao,app-util。
用項目層次的劃分替代包層次的劃分能給我們帶來如下好處：
接下來討論一下POM配置細節，實際上非常簡單，先看app-parent的pom.xml：
Xml代碼
<PRoject xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.myorg.myapp</groupId> <artifactId>app-parent</artifactId> <packaging>pom</packaging> <version>1.0-SNAPSHOT</version> <modules> <module>app-util</module> <module>app-dao</module> <module>app-service</module> <module>app-web</module> </modules> </project>
Maven的坐標GAV（groupId, artifactId, version）在這里進行配置，這些都是必須的。特殊的地方在于，這里的packaging為pom。所有帶有子模塊的項目的packaging都為pom。packaging如果不進行配置，它的默認值是jar，代表Maven會將項目打成一個jar包。
該配置重要的地方在于modules，例子中包含的子模塊有app-util, app-dao, app-service, app-war。在Maven build app-parent的時候，它會根據子模塊的相互依賴關系整理一個build順序，然后依次build。
這就是一個父模塊大概需要的配置，接下來看一下子模塊符合配置繼承父模塊。、
Xml代碼<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <parent> <artifactId>app-parent</artifactId> <groupId>org.myorg.myapp</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>app-util</artifactId> <dependencies> <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> <version>2.4</version> </dependency> </dependencies> </project>
app-util模塊繼承了app-parent父模塊，因此這個POM的一開始就聲明了對app-parent的引用，該引用是通過Maven坐標GAV實現的。而關于項目app-util本身，它卻沒有聲明完整GAV，這里我們只看到了artifactId。這個POM并沒有錯，groupId和version默認從父模塊繼承了。實際上子模塊從父模塊繼承一切東西，包括依賴，插件配置等等。
此外app-util配置了一個對于commons-lang的簡單依賴，這是最簡單的依賴配置形式。大部分情況，也是通過GAV引用的。
再看一下app-dao，它也是繼承于app-parent，同時依賴于app-util：
Xml代碼<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <parent> <artifactId>app-parent</artifactId> <groupId>org.myorg.myapp</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>app-dao</artifactId> <dependencies> <dependency> <groupId>org.myorg.myapp</groupId> <artifactId>app-util</artifactId> <version>${project.version}</version> </dependency> </dependencies> </project> 該配置和app-util的配置幾乎沒什么差別，不同的地方在于，依賴變化了，app-dao依賴于app-util。這里要注意的是version的值為${project.version}，這個值是一個屬性引用，指向了POM的project/version的值，也就是這個POM對應的version。由于app-dao的version繼承于app-parent，因此它的值就是1.0-SNAPSHOT。而app-util也繼承了這個值，因此在所有這些項目中，我們做到了保持版本一致。
這里還需要注意的是，app-dao依賴于app-util，而app-util又依賴于commons-lang，根據傳遞性，app-dao也擁有了對于commons-lang的依賴。
app-service我們跳過不談，它依賴于app-dao。我們最后看一下app-web：
Xml代碼 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <parent> <artifactId>app-parent</artifactId> <groupId>org.myorg.myapp</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>app-web</artifactId> <packaging>war</packaging> <dependencies> <dependency> <groupId>org.myorg.myapp</groupId> <artifactId>app-service</artifactId> <version>${project.version}</version> </dependency> </dependencies> </project> app-web依賴于app-service，因此配置了對其的依賴。
由于app-web是我們最終要部署的應用，因此它的packaging是war。為此，你需要有一個目錄src/main/webapp。并在這個目錄下擁有web應用需要的文件，如/WEB-INF/web.xml。沒有web.xml，Maven會報告build失敗，此外你可能還會有這樣一些子目錄：/js, /img, /CSS ... 。
看看Maven是如何build整個項目的，我們在 app-parent 根目錄中運行 mvn clean install ，輸出的末尾會有大致這樣的內容：
...
...
[INFO] [war:war][INFO] Packaging webapp[INFO] Assembling webapp[app-web] in [/home/juven/workspaces/ws-others/myapp/app-web/target/app-web-1.0-SNAPSHOT][INFO] Processing war project[INFO] Webapp assembled in[50 msecs][INFO] Building war: /home/juven/workspaces/ws-others/myapp/app-web/target/app-web-1.0-SNAPSHOT.war[INFO] [install:install][INFO] Installing /home/juven/workspaces/ws-others/myapp/app-web/target/app-web-1.0-SNAPSHOT.war to /home/juven/.m2/repository/org/myorg/myapp/app-web/1.0-SNAPSHOT/app-web-1.0-SNAPSHOT.war[INFO][INFO][INFO] ------------------------------------------------------------------------[INFO] Reactor Summary:[INFO] ------------------------------------------------------------------------[INFO] app-parent ............................................ SUCCESS [1.191s][INFO] app-util .............................................. SUCCESS [1.274s][INFO] app-dao ............................................... SUCCESS [0.583s][INFO] app-service ........................................... SUCCESS [0.593s][INFO] app-web ............................................... SUCCESS [0.976s][INFO] ------------------------------------------------------------------------[INFO] ------------------------------------------------------------------------[INFO] BUILD SUCCESSFUL[INFO] ------------------------------------------------------------------------[INFO] Total time: 4 seconds[INFO] Finished at: Sat Dec 27 08:20:18 PST 2008[INFO] Final Memory: 3M/17M[INFO] ------------------------------------------------------------------------
注意Reactor Summary，整個項目根據我們希望的順序進行build。Maven根據我們的依賴配置，智能的安排了順序，app-util, app-dao, app-service, app-web。
最后，你可以在 app-web/target 目錄下找到文件 app-web-1.0-SNAPSHOT.war ，打開這個war包，在 /WEB-INF/lib 目錄看到了 commons-lang-2.4.jar，以及對應的app-util, app-dao, app-service 的jar包。Maven自動幫你處理了打包的事情，并且根據你的依賴配置幫你引入了相應的jar文件。
使用多模塊的Maven配置，可以幫助項目劃分模塊，鼓勵重用，防止POM變得過于龐大，方便某個模塊的構建，而不用每次都構建整個項目，并且使得針對某個模塊的特殊控制更為方便。本文同時給出了一個實際的配置樣例，展示了如何使用Maven配置多模塊項目。
新聞熱點
疑難解答
