from：http://www.infoq.com/cn/news/2010/12/xxb-maven-1

坐標(biāo)是什么？為什么要規(guī)劃？

坐標(biāo)是Maven最基本的概念，它就像每個構(gòu)件的身份證號碼，有了它我們就可以在數(shù)以千萬計的構(gòu)件中定位任何一個我們感興趣的構(gòu)件。舉個最簡單的例子，如果沒有坐標(biāo)，使用JUnit的時候，用戶就需要去下載依賴jar包，用依賴的方式，簡單配置使用如junit:junit:4.8.2就可以了。這里第一個junit是groupId，第二個junit是artifactId，4.8.2是version。

Maven的很多其他核心機(jī)制都依賴于坐標(biāo)，其中最顯著的就是倉庫和依賴管理。對于倉庫來說，有了坐標(biāo)就知道在什么位置存儲構(gòu)件的內(nèi)容，例如junit:junit:4.8.2就對應(yīng)倉庫中的路徑/junit/junit/4.8.2/junit-4.8.2.pom和/junit/junit/4.8.2/junit-4.8.2.jar這樣的文件，讀者可以直接訪問中央倉庫地址看到這樣的倉庫布局，或者瀏覽本地倉庫目錄~/.m2/repository/以獲得直觀的體驗。

依賴的配置也是完全基于坐標(biāo)的，例如：

<dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.8.2</version><scope>test</scope> </dependency>

有了正確的坐標(biāo),Maven才能夠在正確的位置找到依賴文件并使用，這里值為test的scope是用來控制該依賴只在測試時可用，與坐標(biāo)無關(guān)。

正因為坐標(biāo)是Maven核心的核心，因此規(guī)劃正確的坐標(biāo)至關(guān)重要，如果你使用了模糊不清的坐標(biāo)，那么你的用戶就很難找到你的構(gòu)件，或者即使找到了，也容易寫錯。錯誤的使用坐標(biāo)，還會造成沖突，如果你也使用junit這樣的groupId，那會發(fā)生什么？下面先看一些不是很規(guī)范的坐標(biāo)使用方式。

坐標(biāo)規(guī)劃的原則

濫用坐標(biāo)、錯用坐標(biāo)的樣例比比皆是，在中央倉庫中我們能看到SpringFramework有兩種坐標(biāo)，其一是直接使用springframework作為groupId，如springframework:spring-beans:1.2.6，另一種是用org.springframework作為groupId，如org.springframework:spring-beans:2.5。細(xì)心看看，前一種方式顯得比較隨意，后一種方式則是基于域名衍生出來的，顯然后者更合理，因為用戶能一眼根據(jù)域名聯(lián)想到其Maven坐標(biāo)，方便尋找。因此新版本的SpringFramework構(gòu)件都使用org.springframework作為groupId。由這個例子我們可以看到坐標(biāo)規(guī)劃一個原則是基于項目域名衍生。其實很多流行的開源項目都破壞了這個原則，例如JUnit，這是因為Maven社區(qū)在最開始接受構(gòu)件并部署到中央倉庫的時候，沒有很很嚴(yán)格的限制，而對于這些流行的項目來說，一時間更改坐標(biāo)會影響大量用戶，因此也算是個歷史遺留問題了。

還有一個常見的問題是將groupId直接匹配到公司或者組織名稱，因為乍一看這是顯而易見的。例如組織是zoo.com，有個項目是dog，那有些人就直接使用groupId com.zoo了。如果項目只有一個模塊，這是沒有什么問題的，但現(xiàn)實世界的項目往往會有很多模塊，Maven的一大長處就是通過多模塊的方式管理項目。那dog項目可能會有很多模塊，我們用坐標(biāo)的哪個部分來定義模塊呢？groupId顯然不對，version也不可能是，那只有artifactId。因此要這里有了另外一個原則，用artifactId來定義模塊，而不是定義項目。接下來，很顯然的，項目就必須用groupId來定義。因此對于dog項目來說，應(yīng)該使用groupId com.zoo.dog，不僅體現(xiàn)出這是zoo.com下的一個項目，而且可以與該組織下的其他項目如com.zoo.cat區(qū)分開來。

除此之外，artifactId的定義也有最佳實踐，我們常常可以看到一個項目有很多的模塊，例如api，dao，service，web等等。Maven項目在默認(rèn)情況下生成的構(gòu)件，其名稱不會是基于artifactId，version和packaging生成的，例如api-1.0.jar，dao-1.0.jar等等，他們不會帶有g(shù)roupId的信息，這會造成一個問題，例如當(dāng)我們把所有這些構(gòu)件放到Web容器下的時候，你會發(fā)現(xiàn)項目dog有api-1.0.jar，項目cat也有api-1.0.jar，這就造成了沖突。更壞的情況是，dog項目有api-1.0.jar，cat項目有api-2.0.jar，其實兩者沒什么關(guān)系，可當(dāng)放在一起的時候，卻很容易讓人混淆。為了讓坐標(biāo)更加清晰，又出現(xiàn)了一個原則，即在定義artiafctId時也加入項目的信息，例如dog項目的api模塊，那就使用artifactId dog-api，其他就是dog-dao，dao-service等等。雖然連字號是不允許出現(xiàn)在Java的包名中的，但Maven沒這個限制。現(xiàn)在dog-api-1.0.jar，cat-2.0.jar被放在一起時，就不容易混淆了。

關(guān)于坐標(biāo)，我們還沒談到version，這里不再詳述因為讀者可以從Maven: The Complete Guide中找到詳細(xì)的解釋，簡言之就是使用這樣一個格式：

<主版本>.<次版本>.<增量版本>-<限定符>

其中主版本主要表示大型架構(gòu)變更，次版本主要表示特性的增加，增量版本主要服務(wù)于bug修復(fù)，而限定符如alpha、beta等等是用來表示里程碑。當(dāng)然不是每個項目的版本都要用到這些4個部分，根據(jù)需要選擇性的使用即可。在此基礎(chǔ)上Maven還引入了SNAPSHOT的概念，用來表示活動的開發(fā)狀態(tài)，由于不涉及坐標(biāo)規(guī)劃，這里不進(jìn)行詳述。不過有點要提醒的是，由于SNAPSHOT的存在，自己顯式地在version中使用時間戳字符串其實沒有必要。

Classifier

Classifier可能是最容易被忽略的Maven特性，但它確實非常重要，我們也需要它來幫助規(guī)劃坐標(biāo)。設(shè)想這樣一個情況，有一個jar項目，就說是?dog-cli-1.0.jar?吧，運(yùn)行它用戶就能在命令行上畫一只小狗出來。現(xiàn)在用戶的要求是希望你能提供一個zip包，里面不僅包含這個可運(yùn)行的jar，還得包含源代碼和文檔，換句話說，這是比較正式的分發(fā)包。這個文件名應(yīng)該是怎樣的呢？dog-cli-1.0.zip？不夠清楚，僅僅從擴(kuò)展名很難分辨什么是Maven默認(rèn)生成的構(gòu)件，什么是額外配置生成分發(fā)包。如果能是dog-cli-1.0-dist.zip就最好了。這里的dist就是classifier，默認(rèn)Maven只生成一個構(gòu)件，我們稱之為主構(gòu)件，那當(dāng)我們希望Maven生成其他附屬構(gòu)件的時候，就能用上classifier。常見的classifier還有如dog-cli-1.0-sources.jar表示源碼包，dog-cli-1.0-javadoc.jar表示JavaDoc包等等。制作classifier的方式多種多樣，其中最重要的一種是使用Maven Assembly Plugin，感興趣的讀者可以進(jìn)一步研究。

小結(jié)

本文是InfoQ Maven專欄的第一篇，討論的是Maven坐標(biāo)的規(guī)劃，包括如何正確的使用groupId、artifactId、version，以及classfier。筆者在維護(hù)Maven中央倉庫的工作過程中遇到過各種各樣模糊的甚至是錯誤的坐標(biāo)，它們的存在給廣大Maven用戶帶來的極大的不便。本文拋出一些較好的實踐，幫助大家更好的使用Maven。如果讀者有相關(guān)的經(jīng)驗總結(jié)，也請不吝分享。

關(guān)于作者

許曉斌（Juven Xu），國內(nèi)社區(qū)公認(rèn)的Maven技術(shù)專家、Maven中文用戶組創(chuàng)始人、Maven技術(shù)的先驅(qū)和積極推動者。對Maven有深刻的認(rèn)識，實戰(zhàn)經(jīng)驗豐富，不僅撰寫了大量關(guān)于Maven的技術(shù)文章，而且還翻譯了開源書籍《Maven權(quán)威指南》，對Maven技術(shù)在國內(nèi)的普及和發(fā)展做出了很大的貢獻(xiàn)。就職于Maven之父的公司，負(fù)責(zé)維護(hù)Maven中央倉庫，是Maven倉庫管理器Nexus（著名開源軟件）的核心開發(fā)者之一，曾多次受邀到淘寶等大型企業(yè)開展Maven方面的培訓(xùn)。此外，他還是開源技術(shù)的積極倡導(dǎo)者和推動者，擅長Java開發(fā)和敏捷開發(fā)實踐。他的個人網(wǎng)站是：http://www.juvenxu.com。

【編者按】InfoQ中文站有幸邀請到Sonotype（Maven背后的公司）在中國唯一的員工、《Maven實戰(zhàn)》的作者許曉斌先生，在InfoQ中文站開辟M(fèi)aven的專欄，為開發(fā)者帶來一些Maven的高級話題，以及他積累多年的Maven經(jīng)驗分享。

總結(jié)

以上是生活随笔為你收集整理的许晓斌_Maven实战（一）——坐标规划的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。