Maven實戰：pom.xml與settings.xml

pom.xml與settings.xml

pom.xml與setting.xml，可以說是Maven中最重要的兩個配置文件，決定了Maven的核心功能，雖然之前的文章零零碎碎有提到過pom.xml和settings.xml里面的內容，但都是大略帶過，學習與研究地并不細致，本文的目的就是詳細研究下這兩個Maven重要的配置文件，從這兩個配置文件可以牽出非常多的Maven話題。

Maven坐標

首先談一下為什么要使用Maven坐標。

Maven世界擁有數量非常巨大的構件，也就是平時使用的一些jar、war等文件，在Maven為這些構件引入坐標概念之前，我們無法使用任何一種方式來唯一標識所有這些構件。因此，如果需要使用Spring依賴，那么就去Spring官網尋找；如果需要使用log4j依賴，那么又去Apache官網尋找。又因為各個網站風格迥異，大量時間花費在了搜索和瀏覽網頁的工作上。沒有統一規范與法則，工作就無法自動化，重復性的勞動本來就應該交給機器來做。

Maven定義了這樣一組規則：世界上任何一個構件都可以使用Maven坐標唯一標識，Maven坐標元素包括groupId、artifactId、version、packaging、classifier，現在只要我們提供正確的元素坐標，Maven就能找到對應的構件。至于去哪里下載，Maven本身內置了一個中央倉庫的地址"http://repo1.maven.org/maven2"，該中央倉庫包含了世界上絕大部分流行的開源項目構件，Mavne會在需要的時候去那里下載，當然也可以配置自己的中央倉庫地址，去自己的中央倉庫下載構件。

舉個例子，Spring的context：

<dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>4.2.6.RELEASE</version>
</dependency

看一下下屬的各個元素：

groupId：定義當前Maven項目隸屬的實際項目。由于Maven項目和實際項目未必是一對一的關系，比如SpringFramework這個實際項目可能對應的Maven項目有很多，像core、context、expression等等，因此groupId不應該對應項目隸屬的公司或組織，否則artifact將很難定義
artifactId：定義實際項目中的一個Maven模塊，推薦的做法是使用實際項目名稱作為artifactId的前綴，這樣會很方便去尋找實際構件
version：定義Maven項目當前所處的版本，如上面的spring-context就是4.2.6的，RELEASE表示正式發行版本
packing：定義Maven項目的打包方式，這項不是必須的，沒列出來，不定義默認就是jar的打包方式
classifier：幫助定義構件輸出的一些附屬構件，比如xxx-javadoc.jar、xxx-sources.jar，附屬構件與主構件對應，這項是不能直接定義的

Maven坐標的概念大致上就是這樣，理解Maven坐標，是理解Maven很重要的一步。

傳遞性依賴

什么是傳遞性依賴，以Spring舉一個例子。使用Spring的時候會依賴于其他開源的類庫，此時有兩種做法：

1、下載一個很大的.zip包，里面包含了所有Spring的jar，但是這么做往往就引入了許多不必要的依賴

2、只下載spring相關的.zip包，不包含依賴，實際使用的時候根據出錯信息，加入需要的其他依賴

顯然這兩種做法都非常麻煩，Maven的傳遞性依賴機制很好地解決了這一問題。打開spring-core-4.1.0.RELEASE的pom.xml，我截取一段關鍵部分：

<dependencies><dependency><groupId>commons-codec</groupId><artifactId>commons-codec</artifactId><version>1.9</version><scope>compile</scope><optional>true</optional></dependency><dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.1.3</version><scope>compile</scope></dependency>...
</dependencies>

比如A項目依賴了spring-core，spring-core又依賴了commons-codec和commons-logging，那么commons-codec和commons-logging就是A項目的一個傳遞性依賴。有了傳遞性依賴機制，在使用spring-core的時候就不用去考慮它依賴了什么，也不用擔心引入多余的依賴，Maven會解析各個直接依賴的POM，將那些必要的間接依賴，以傳遞性依賴的形式引入到當前的項目中去。

有了傳遞性依賴機制，一方面大大簡化和方便了依賴聲明，另一方面在大部分情況下我們只需要關心項目的直接依賴是什么而不用考慮這些直接依賴會引入什么傳遞性依賴，不過有時候傳遞性依賴也會有一些問題，此時我們就需要清除地知道該傳遞性依賴是從哪條路徑引入的，這就叫依賴調解，依賴調解主要有兩點原則：

1、A->B->C->X(1.0)，A->D->X(2.0)，此時兩條依賴路徑上有兩個版本的X，此時遵循路徑最近者優先，因此X(2.0)將被解析使用

2、A->B->Y(1.0)，A->C->Y(2.0)，Y(1.0)和Y(2.0)的依賴長度是一樣的，從Maven2.0.9開始，此時遵循第一聲明者優先，即順序最靠前的那個依賴優先

排除依賴

傳遞性依賴會給項目隱式地引入很多依賴，這極大地簡化了項目依賴的管理，但是有時候這種特性也會帶來問題。比如有種情況：

當前項目依賴A，A由于某些原因依賴了另外一個類庫的SNAPSHOT版本，那么這個SNAPSHOT就會成為當前項目的傳遞性依賴，二SNAPSHOT的不穩定性將直接影響到當前的項目，此時就需要排除該SNAPSHOT，并且在當前項目中聲明該類庫的某個正式發布的版本

排除依賴很簡單，看一下寫法：

<dependency><groupId>com.alibaba.rocketmq</groupId><artifactId>rocketmq-client</artifactId><version>3.2.7</version><exclusions><exclusion><groupId>apache-lang</groupId><artifactId>commons-lang</artifactId></exclusion></exclusions>
</dependency>

這里我引入了rocketmq的依賴，但是我不想依賴rocketmq里面的apache-lang，而想要自己引入依賴，所以我就把apache-lang給排除了。

這里需要注意的是，聲明exclusion的時候只需要groupId和artifactId即可，而不需要version元素，這是因為只需要groupId和artifactId就能唯一定位依賴圖中的某個依賴。換句話說，Maven解析后的依賴中，不可能出現groupId和artifactId相同，但是version不同的兩個依賴。

settings.xml

settings.xml里面是Maven的基本配置，元素比較多，逐一看一下

1、proxy

proxy表示Maven的代理，看一下寫法：

<proxies><proxy><id>optional</id><active>true</active><protocol>http</protocol><username>proxyuser</username><password>proxypass</password><host>proxy.host.net</host><port>80</port><nonProxyHosts>local.net|some.host.com</nonProxyHosts></proxy>
</proxies>

需要proxy是因為很多時候你所在的公司基于安全因素考慮，要求你使用通過安全認證的代理訪問因特網。這種情況下，就需要為Maven配置HTTP代理，才能讓它正常訪問外部倉庫，以下載所需要的資源。proxies下可以配置多個proxy元素，如果聲明了多個proxy元素，則默認情況下第一個被激活的proxy會生效。active為true表示激活該代理，protocol表示使用的代理協議，當然最重要的是指定正確的主機名（host）和端口（port），如果代理服務器需要認證則配置username和password，nonProxyHost元素表示指定哪些主機名不需要代理，可以用"|"分隔多個主機名，也支持通配符"*"。

2、repository

repository表示Maven的中央倉庫，因為盡管默認的遠程倉庫中的構件非常龐大，但是總歸會有不滿足我們需求的時候，這時候就要用到別的中央倉庫了。看一下寫法：

<repository>
    <id>public</id><name>local private nexus</name><url>http://192.168.1.6:8081/nexus/content/groups/public</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots>
</repository>

可以聲明多個repository。id必須是唯一的，尤其注意，Maven自帶的中央倉庫使用的id為central，如果其他倉庫聲明也用該id，就會覆蓋中央倉庫的配置。releases和snapshots比較重要，前者表示開啟倉庫的發布版本下載支持，后者表示關閉倉庫的快照版本下載支持，這樣一來，Maven就會去倉庫下載發布版本的構件而不會下載快照版本的構件了。

3、server

大部分遠程倉庫無須認證就可以訪問，但是有時候處于安全方面的因素考慮，需要提供認證信息才能訪問一些遠程倉庫，處于安全考慮，認證信息一般只放在settings.xml中，server就是認證元素。看一下配置：

<server><id>nexus-releases</id><username>deployment</username><password>deployment</password>
</server>

這里的關鍵是id，這個id必須與需要認證的repository元素的id完全一致才行，換句話說，正式這個id將認證信息和倉庫配置聯系在了一起。

4、mirror

如果倉庫X可以提供倉庫Y存儲的所有內容，那么就可以認為倉庫X是倉庫Y的一個鏡像（mirror），換句話說，任何一個可以從Y中獲取到的構件夠可以從X中獲取到。舉個例子，"http://maven.net.cn/content/groups/public/"是中央倉庫"http://repo1.maven.org/maven2/"在中國的鏡像，由于地理位置的因素，該鏡像往往能夠提供比中央倉庫更快的服務，這就是為什么要使用mirror的原因。

看一下mirror的配置：

<mirror><id>nexus</id><name>internal nexus repository</name><url>http://192.168.1.6:8081/nexus/content/groups/public</url>
    <mirrorOf>*</mirrorOf>
</mirror>