讀古今文學網 > Maven實戰 > 3.1 編寫POM >

3.1 編寫POM

就像Make的Makefile、Ant的build.xml一樣,Maven項目的核心是pom.xml。POM(Project Object Model,項目對像模型)定義了項目的基本信息,用於描述項目如何構建,聲明項目依賴,等等。現在先為Hello World項目編寫一個最簡單的pom.xml。

首先創建一個名為hello-world的文件夾,打開該文件夾,新建一個名為pom.xml的文件,輸入其內容,如代碼清單3-1所示。

代碼清單3-1 Hello World的POM

代碼的第一行是XML頭,指定了該xml文檔的版本和編碼方式。緊接著是project元素,project是所有pom.xml的根元素,它還聲明了一些POM相關的命名空間及xsd元素,雖然這些屬性不是必須的,但使用這些屬性能夠讓第三方工具(如IDE中的XML編輯器)幫助我們快速編輯POM。

根元素下的第一個子元素modelVersion指定了當前POM模型的版本,對於Maven 2及Maven 3來說,它只能是4.0.0。

這段代碼中最重要的是包含groupId、artifactId和version的三行。這三個元素定義了一個項目基本的坐標,在Maven的世界,任何的jar、pom或者war都是以基於這些基本的坐標進行區分的。

groupId定義了項目屬於哪個組,這個組往往和項目所在的組織或公司存在關聯。譬如在googlecode上建立了一個名為myapp的項目,那麼groupId就應該是com.googlecode.myapp,如果你的公司是mycom,有一個項目為myapp,那麼groupId就應該是com.mycom.myapp。本書中所有的代碼都基於groupId com.juvenxu.mvnbook。

artifactId定義了當前Maven項目在組中唯一的ID,我們為這個Hello World項目定義artifactId為hello-world,本書其他章節代碼會分配其他的artifactId。而在前面的groupId為com.googlecode.myapp的例子中,你可能會為不同的子項目(模塊)分配artifactId,如myapp-util、myapp-domain、myapp-web等。

顧名思義,version指定了Hello World項目當前的版本——1.0-SNAPSHOT。SNAPSHOT意為快照,說明該項目還處於開發中,是不穩定的版本。隨著項目的發展,version會不斷更新,如升級為1.0、1.1-SNAPSHOT、1.1、2.0等。6.5節會詳細介紹SNAPSHOT,第13章會介紹如何使用Maven管理項目版本的升級發佈。

最後一個name元素聲明了一個對於用戶更為友好的項目名稱,雖然這不是必須的,但還是推薦為每個POM聲明name,以方便信息交流。

沒有任何實際的Java代碼,我們就能夠定義一個Maven項目的POM,這體現了Maven的一大優點,它能讓項目對像模型最大程度地與實際代碼相獨立,我們可以稱之為解耦,或者正交性。這在很大程度上避免了Java代碼和POM代碼的相互影響。比如當項目需要升級版本時,只需要修改POM,而不需要更改Java代碼;而在POM穩定之後,日常的Java代碼開發工作基本不涉及POM的修改。