Maven一定要會的這幾個知識!

 

一、Maven概念

        Maven是一個項目管理和整合工具。Maven為開發者提供了一套完整的構建生命周期框架。開發團隊幾乎不用花多少時間就能夠自動完成工程的基礎構建配置,因為Maven使用了一個標準的目錄結構和一個默認的構建生命周期。

        若有多個開發團隊環境的情況下,Maven能夠在很短的時間內使得每項工作都按照標準進行。因為大部分的工程配置都非常簡單且可復用,在創建報告、檢查、構建和測試自動配置時,Maven可以讓開發者的工作變得更簡單。

 

Maven的主要目的是為開發者提供:

  • 一個可復用、可維護、更易理解的工程綜合模型,與這個模型交互的插件或工具

  • Maven工程結構和內容定義在一個xml文件中(一般是pom.xml)

 

利用Maven構建項目過程階段:

 

 

二、Maven安裝配置

1. JDK安裝

        Maven是基於Java的工具,所以配置Maven要做的第一件事就是安裝JDK

 

2. Windows安裝

        Maven下載地址://maven.apache.org/download.html

        下載解壓後,添加環境變量即完成

 

3. Linux安裝

        ① 配置yum源

# sudo yum install -y yum-utils
​
# yum-config-manager --add-repo http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo 

         ② 安裝Maven

# yum install -y apache-maven

完成安裝後,通過mvn –version 檢驗安裝版本
 

 

三、Maven初體驗

Maven主要是用來打jar、war包以及管理jar包

1. 原始的javac打包方式

假如我們有一個Hello.java文件,想要將它打成可執行jar包,一般這樣做。

使用 javac 命令和 jar 命令打包:

生成的jar包文件,由兩部分組成,class文件和META-INF目錄,如下:

此時的jar包,是不可直接運行的,需要指定入口main類

進入META-INF目錄,編輯MANIFEST.MF文件,如下:

運行此jar包,得到運行結果:

 

2. maven打包

在pom文件內配置入口類

執行maven打包命令

mvn package

運行生成的jar,結果與原始方式無區別

 

四、POM結構

 

 

五、Maven流程

1. maven的理想

maven像一種什麼設計模式?答案:模板方法模式

自動走完標準的構建流程:清理->編譯->測試->報告->打包->部署

統一入口,所有配置在一個pom里搞定

 

2. maven的約定

 

約定的目錄(不可改):

src/main/java –存放項目的.java文件

src/main/resources –存放項目資源文件。比方spring,hibernate配置文件

src/test/java –存放全部測試.java文件,比方JUnit測試類

src/test/resources —測試資源文件

target —項目輸出位置,編譯完畢後的東西放到這裏面

pom.xml

3. maven的生命周期
maven的構建生命周期,只是一個抽象的規範流程。周期內的每個階段的具體執行,是在插件裏面來實現的。

各個生命周期預設的定義如下:

階段

處理

描述

驗證 validate

驗證項目

驗證項目是否正確且所有必須信息是可用的

編譯 compile

執行編譯

源代碼編譯在此階段完成

測試 Test

測試

使用適當的單元測試框架(例如JUnit)運行測試。

包裝 package

打包

創建JAR/WAR包如在 pom.xml 中定義提及的包

檢查 verify

檢查

對集成測試的結果進行檢查,以保證質量達標

安裝 install

安裝

安裝打包的項目到本地倉庫,以供其他項目使用

部署 deploy

部署

拷貝最終的工程包到遠程倉庫中,以共享給其他開發人員和工程

運行任何一個階段,都會從其所在生命周期的第一個階段開始,順序執行到指定的階段,如:

mvn package(本義:執行default周期的package階段,maven會自動從process-resources階段開始運行到package階段結束)

4. maven的插件

插件plugin是綁定到生命周期,承擔實際功能的組件。mvn運行時,自動關聯插件來運行

下圖是maven默認的各階段對應的插件列表:

生命周期

生命周期階段

​插件目標

執行任務

clean

pre-clean

   
 

clean

maven-clean-plugin:clean

刪除項目的輸出目錄。

 

post-clean

   

site

pre-site

   
 

site

maven-site-plugin:site

 
 

post-site

   
 

site-deploy

maven-site-plugin:deploy

 

default

process-resources

maven-resources-plugin:resources

複製主資源文件至主輸出目錄

 

compile

maven-compiler-plugin:compile

編譯主代碼至主輸出目錄

 

process-test-resources

maven-resources-plugin:testResources

複製測試資源文件至測試輸出目

 

test-compile

maven-compiler-plugin:testCompile

編譯測試代碼至測試輸出目錄

 

test

maven-surefire-plugin:test

執行測試用例

 

package

maven-jar-plugin:jar(ejb:ejb jar:jar rar:rar war:war)

創建項目jar包

 

install

maven-install-plugin:install

將項目輸出構件安裝到本地倉庫

 

deploy

maven-deploy-plugin:deploy

將項目輸出構件部署到遠程倉庫

 

 

六、常用Maven命令

mvn clean  清理

mvn compile 編譯主程序

mvn package 打包

mvn install 安裝jar到本地庫

 

使用maven命令生成項目(idea和eclipse生成項目最終也是依賴maven插件生成的):

mvn archetype:generate -DgroupId=enjoy -DartifactId=simple -DarchetypeArtifactId=maven-archetype-quickstart  -Dversion=1.0

 

mvn archetype:generate -DgroupId=enjoy -DartifactId=simple-web -DarchetypeArtifactId=maven-archetype-webapp -Dversion=1.0  

 

 

七、Maven插件開發

可以自定義插件,來擴展maven的功能。插件的開發步驟如下:

1. 引入maven api依賴

2. 編寫簡單Mojo類(繼承AbstractMojo)

3. 執行插件

mvn com.enjoy:enjoy-plugin:1.0:log

4. 關聯插件到生命周期來執行

構建項目對應的生命周期

 

 

八、Maven坐標與依賴

1. 坐標

——–在數學中, 任何一個坐標可以唯一確定一個「點」

Maven 中坐標是Jar包的唯一標識

坐標元素包括groupId、artifactId、version、packaging:

元素 描述 說明
groupId

定義當前模塊隸屬的實際

Maven項目

中小企業常常直接對應公司、組織
artifactId 定義實際項目中的一個Maven模塊 唯一標識一個模塊
version 定義當前項目所屬版本

SNAPSHOT:表示不穩定版本

LATEST:指最新發佈的版本,可能是個發佈版,也可能是一個snapshot版本

RELEASE:指最後一個發佈版

packaging 定義Maven項目打包方式 有jar(默認)、war、pom、maven-plugin等
dassifier 附屬構建(如javadoc、sources) 須有附加插件的幫助

 

2. 依賴

依賴即:A->B,B->C,C->D這種項目間的依存關係。

在java的jvm內,依賴的最終表現是,項目A啟動時,其依賴的jar包必須都對應放入其classpath路徑內。

 

3. 依賴傳遞

上述過程中,項目Mall歸結起來,依賴的fastjson會有三個版本。

而我們的jvm最終肯定只能接受一個版本的jar,所以必須有所取捨。

maven默認的取捨規則是:

1、路徑最短原則:product和customer里的fastjson引用路徑較短,路徑為兩步;pay項目里的fastjson引用路徑較長,路徑為三步。因此pay中的fastjson被淘汰;

2、同路徑長度下,誰先聲明誰優先:product和customer中的fastjson路徑相同,那麼就看在pom中是先聲明product還是先聲明customer,誰先用誰的。

 

4. 依賴衝突及解決

在依賴傳遞里,我們看到,maven根據自己的規則為我們取捨出了一個版本的jar,但此jar版本選擇可能會與我們的項目預期不符:

例如:我們最終想的版本是fastjson:1.2.30版本(但它在第一步即被淘汰掉了)

當出現此類情況時,我們項目運行可能會出錯(項目中使用到了1.2.30版本的特性),此問題即是我們常遇到的jar包衝突問題。

補救方式:使用exclusions將product和customer中的fastjson包排除掉,用法如下圖:

當發生jar衝突程序報錯時,可以使用mvn命令查出項目最終依賴的jar包樹,看版本是否是我們預期的:

命令:mvn dependency:tree

 

5. 依賴範圍scope

mvn在運行時,生命周期的不同階段,會有不同的依賴範圍,一般有以下依賴範圍scope:

– compile:默認範圍,用於編譯(依賴的jar在打包時會包含進去)      

– provided:類似於編譯,但支持你期待jdk或者容器提供,類似於classpath(依賴的jar在打包時不會包含進去)

– runtime:在執行時需要使用(依賴的jar在打包時會包含進去)

– test:用於test任務時使用(依賴的jar在打包時不會包含進去)

– system:需要外在提供相應的元素。通過systemPath來取得(一般禁止使用)

每個scope實際上是配置了一個不同的classpath,jvm根據選擇不同的classpath來達到依賴不同

 

 

九、環境激活-profiles使用

在springmvc項目中,開發/測試/線上三個不同環境,配置文件往往也不同。

打包時需要對配置文件做出選擇(maven提供了profiles機制供我們使用)。

1. profiles的場景

這個選擇,實際發生在default生命周期的resource階段(maven-resources-plugin執行過程里)

 

2. 定義profiles

為了指導插件將對應的resource文件打入classpath里,先定出profiles

此定義即指,當mvn命令執行時,我們需要通過 -P dev或者-P test方式傳入我們的意圖:

dev/test選擇,會導致properties里的變量值含義不同,我們主要關注package.environment變量

 

3. 資源插件的配置指定

配置maven-resources-plugin插件執行時,要複製的目錄資源

 

4. mvn約定的資源中需要過濾掉環境目錄

需要將mvn約定的資源目錄里,過濾掉環境目錄

 

5. 小屬性更輕便的用法

對於簡單的屬性,我們可以選擇更輕便的用法

① 直接在環境中定義屬性值

② 項目屬性文件配置

③ 約定的資源啟用替換過濾

最後有對pom.xml裏面各標籤有疑惑的小夥伴,下面附上pom.xml文件標籤的詳細注釋解釋,可以花時間好好去看一下對應的標籤的作用是什麼。

<project xmlns="//maven.apache.org/POM/4.0.0"
         xmlns:xsi="//www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="//maven.apache.org/POM/4.0.0 //maven.apache.org/maven-v4_0_0.xsd ">
 
    <!-- 父項目的坐標。如果項目中沒有規定某個元素的值,那麼父項目中的對應值即為項目的默認值。
         坐標包括group ID,artifact ID和 version。 -->
    <parent>
        <!-- 被繼承的父項目的構件標識符 -->
        <artifactId>xxx</artifactId>
 
        <!-- 被繼承的父項目的全球唯一標識符 -->
        <groupId>xxx</groupId>
 
        <!-- 被繼承的父項目的版本 -->
        <version>xxx</version>
 
        <!-- 父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認值是../pom.xml。
             Maven首先在構建當前項目的地方尋找父項目的pom,其次在文件系統的這個位置(relativePath位置),
             然後在本地倉庫,最後在遠程倉庫尋找父項目的pom。 -->
        <relativePath>xxx</relativePath>
    </parent>
 
    <!-- 聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,
         這是為了當Maven引入了新的特性或者其他模型變更的時候,確保穩定性。 -->
    <modelVersion> 4.0.0 </modelVersion>
 
    <!-- 項目的全球唯一標識符,通常使用全限定的包名區分該項目和其他項目。並且構建時生成的路徑也是由此生成,
         如com.mycompany.app生成的相對路徑為:/com/mycompany/app -->
    <groupId>xxx</groupId>
 
    <!-- 構件的標識符,它和group ID一起唯一標識一個構件。換句話說,你不能有兩個不同的項目擁有同樣的artifact ID
         和groupID;在某個特定的group ID下,artifact ID也必須是唯一的。構件是項目產生的或使用的一個東西,Maven
         為項目產生的構件包括:JARs,源碼,二進制發佈和WARs等。 -->
    <artifactId>xxx</artifactId>
 
    <!-- 項目產生的構件類型,例如jar、war、ear、pom。插件可以創建他們自己的構件類型,所以前面列的不是全部構件類型 -->
    <packaging> jar </packaging>
 
    <!-- 項目當前版本,格式為:主版本.次版本.增量版本-限定版本號 -->
    <version> 1.0-SNAPSHOT </version>
 
    <!-- 項目的名稱, Maven產生的文檔用 -->
    <name> xxx-maven </name>
 
    <!-- 項目主頁的URL, Maven產生的文檔用 -->
    <url> //maven.apache.org </url>
 
    <!-- 項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略,
         就可以包含HTML標籤), 不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面,你應該修改你自己的
         索引頁文件,而不是調整這裡的文檔。 -->
    <description> A maven project to study maven. </description>
 
    <!-- 描述了這個項目構建環境中的前提條件。 -->
    <prerequisites>
        <!-- 構建該項目或使用該插件所需要的Maven的最低版本 -->
        <maven></maven>
    </prerequisites>
 
    <!-- 項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例為 jira -->
    <issueManagement>
        <!-- 問題管理系統(例如jira)的名字, -->
        <system> jira </system>
 
        <!-- 該項目使用的問題管理系統的URL -->
        <url> //jira.baidu.com/banseon </url>
    </issueManagement>
 
    <!-- 項目持續集成信息 -->
    <ciManagement>
        <!-- 持續集成系統的名字,例如continuum -->
        <system></system>
 
        <!-- 該項目使用的持續集成系統的URL(如果持續集成系統有web接口的話)。 -->
        <url></url>
 
        <!-- 構建完成時,需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告) -->
        <notifiers>
            <!-- 配置一種方式,當構建中斷時,以該方式通知用戶/開發者 -->
            <notifier>
                <!-- 傳送通知的途徑 -->
                <type></type>
 
                <!-- 發生錯誤時是否通知 -->
                <sendOnError></sendOnError>
 
                <!-- 構建失敗時是否通知 -->
                <sendOnFailure></sendOnFailure>
 
                <!-- 構建成功時是否通知 -->
                <sendOnSuccess></sendOnSuccess>
 
                <!-- 發生警告時是否通知 -->
                <sendOnWarning></sendOnWarning>
 
                <!-- 不贊成使用。通知發送到哪裡 -->
                <address></address>
 
                <!-- 擴展配置項 -->
                <configuration></configuration>
            </notifier>
        </notifiers>
    </ciManagement>
 
    <!-- 項目創建年份,4位數字。當產生版權信息時需要使用這個值。 -->
    <inceptionYear />
 
    <!-- 項目相關郵件列表信息 -->
    <mailingLists>
        <!-- 該元素描述了項目相關的所有郵件列表。自動產生的網站引用這些信息。 -->
        <mailingList>
            <!-- 郵件的名稱 -->
            <name> Demo </name>
 
            <!-- 發送郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->
            <post> [email protected] </post>
 
            <!-- 訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->
            <subscribe> [email protected] </subscribe>
 
            <!-- 取消訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->
            <unsubscribe> [email protected] </unsubscribe>
 
            <!-- 你可以瀏覽郵件信息的URL -->
            <archive> http:/hi.baidu.com/banseon/demo/dev/ </archive>
        </mailingList>
    </mailingLists>
 
    <!-- 項目開發者列表 -->
    <developers>
        <!-- 某個項目開發者的信息 -->
        <developer>
            <!-- SCM里項目開發者的唯一標識符 -->
            <id> HELLO WORLD </id>
 
            <!-- 項目開發者的全名 -->
            <name> banseon </name>
 
            <!-- 項目開發者的email -->
            <email> [email protected] </email>
 
            <!-- 項目開發者的主頁的URL -->
            <url></url>
 
            <!-- 項目開發者在項目中扮演的角色,角色元素描述了各種角色 -->
            <roles>
                <role> Project Manager </role>
                <role> Architect </role>
            </roles>
 
            <!-- 項目開發者所屬組織 -->
            <organization> demo </organization>
 
            <!-- 項目開發者所屬組織的URL -->
            <organizationUrl> //hi.baidu.com/xxx </organizationUrl>
 
            <!-- 項目開發者屬性,如即時消息如何處理等 -->
            <properties>
                <dept> No </dept>
            </properties>
 
            <!-- 項目開發者所在時區, -11到12範圍內的整數。 -->
            <timezone> -5 </timezone>
        </developer>
    </developers>
 
    <!-- 項目的其他貢獻者列表 -->
    <contributors>
        <!-- 項目的其他貢獻者。參見developers/developer元素 -->
        <contributor>
            <!-- 項目貢獻者的全名 -->
            <name></name>
 
            <!-- 項目貢獻者的email -->
            <email></email>
 
            <!-- 項目貢獻者的主頁的URL -->
            <url></url>
 
            <!-- 項目貢獻者所屬組織 -->
            <organization></organization>
 
            <!-- 項目貢獻者所屬組織的URL -->
            <organizationUrl></organizationUrl>
 
            <!-- 項目貢獻者在項目中扮演的角色,角色元素描述了各種角色 -->
            <roles>
                <role> Project Manager </role>
                <role> Architect </role>
            </roles>
 
            <!-- 項目貢獻者所在時區, -11到12範圍內的整數。 -->
            <timezone></timezone>
 
            <!-- 項目貢獻者屬性,如即時消息如何處理等 -->
            <properties>
                <dept> No </dept>
            </properties>
        </contributor>
    </contributors>
 
    <!-- 該元素描述了項目所有License列表。 應該只列出該項目的license列表,不要列出依賴項目的 license列表。
         如果列出多個license,用戶可以選擇它們中的一個而不是接受所有license。 -->
    <licenses>
        <!-- 描述了項目的license,用於生成項目的web站點的license頁面,其他一些報表和validation也會用到該元素。 -->
        <license>
            <!-- license用於法律上的名稱 -->
            <name> Apache 2 </name>
 
            <!-- 官方的license正文頁面的URL -->
            <url> //www.baidu.com/banseon/LICENSE-2.0.txt </url>
 
            <!-- 項目分發的主要方式:
                    repo,可以從Maven庫下載
                    manual, 用戶必須手動下載和安裝依賴 -->
            <distribution> repo </distribution>
 
            <!-- 關於license的補充信息 -->
            <comments> A business-friendly OSS license </comments>
        </license>
    </licenses>
 
    <!-- SCM(Source Control Management)標籤允許你配置你的代碼庫,供Maven web站點和其它插件使用。 -->
    <scm>
        <!-- SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該連接只讀。 -->
        <connection>
            scm:svn://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
        </connection>
 
        <!-- 給開發者使用的,類似connection元素。即該連接不僅僅只讀 -->
        <developerConnection>
            scm:svn://svn.baidu.com/banseon/maven/banseon/dao-trunk
        </developerConnection>
 
        <!-- 當前代碼的標籤,在開發階段默認為HEAD -->
        <tag></tag>
 
        <!-- 指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。 -->
        <url> //svn.baidu.com/banseon </url>
    </scm>
 
    <!-- 描述項目所屬組織的各種屬性。Maven產生的文檔用 -->
    <organization>
        <!-- 組織的全名 -->
        <name> demo </name>
 
        <!-- 組織主頁的URL -->
        <url> //www.baidu.com/banseon </url>
    </organization>
 
    <!-- 構建項目需要的信息 -->
    <build>
        <!-- 該元素設置了項目源碼目錄,當構建項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對
             於pom.xml的相對路徑。 -->
        <sourceDirectory></sourceDirectory>
 
        <!-- 該元素設置了項目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數情況下,該目錄下的內容會
             被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。 -->
        <scriptSourceDirectory></scriptSourceDirectory>
 
        <!-- 該元素設置了項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄里的源碼。
             該路徑是相對於pom.xml的相對路徑。 -->
        <testSourceDirectory></testSourceDirectory>
 
        <!-- 被編譯過的應用程序class文件存放的目錄。 -->
        <outputDirectory></outputDirectory>
 
        <!-- 被編譯過的測試class文件存放的目錄。 -->
        <testOutputDirectory></testOutputDirectory>
 
        <!-- 使用來自該項目的一系列構建擴展 -->
        <extensions>
            <!-- 描述使用到的構建擴展。 -->
            <extension>
                <!-- 構建擴展的groupId -->
                <groupId></groupId>
 
                <!-- 構建擴展的artifactId -->
                <artifactId></artifactId>
 
                <!-- 構建擴展的版本 -->
                <version></version>
            </extension>
        </extensions>
 
        <!-- 當項目沒有規定目標(Maven2 叫做階段)時的默認值 -->
        <defaultGoal></defaultGoal>
 
        <!-- 這個元素描述了項目相關的所有資源路徑列表,例如和項目相關的屬性文件,這些資源被包含在
             最終的打包文件里。 -->
        <resources>
            <!-- 這個元素描述了項目相關或測試相關的所有資源路徑 -->
            <resource>
                <!-- 描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。
                     舉個例子,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設置為
                    org/apache/maven/messages。然而,如果你只是想把資源放到源碼目錄結構里,就不需要該配置。 -->
                <targetPath></targetPath>
 
                <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性,文件在filters元素
                     里列出。 -->
                <filtering></filtering>
 
                <!-- 描述存放資源的目錄,該路徑相對POM路徑 -->
                <directory></directory>
 
                <!-- 包含的模式列表,例如**/*.xml. -->
                <includes>
                    <include></include>
                </includes>
 
                <!-- 排除的模式列表,例如**/*.xml -->
                <excludes>
                    <exclude></exclude>
                </excludes>
            </resource>
        </resources>
 
        <!-- 這個元素描述了單元測試相關的所有資源路徑,例如和單元測試相關的屬性文件。 -->
        <testResources>
            <!-- 這個元素描述了測試相關的所有資源路徑,參見build/resources/resource元素的說明 -->
            <testResource>
                <!-- 描述了測試相關的資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。
                     舉個例子,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設置為
                    org/apache/maven/messages。然而,如果你只是想把資源放到源碼目錄結構里,就不需要該配置。 -->
                <targetPath></targetPath>
 
                <!-- 是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性,文件在filters元素
                     里列出。 -->
                <filtering></filtering>
 
                <!-- 描述存放測試相關的資源的目錄,該路徑相對POM路徑 -->
                <directory></directory>
 
                <!-- 包含的模式列表,例如**/*.xml. -->
                <includes>
                    <include></include>
                </includes>
 
                <!-- 排除的模式列表,例如**/*.xml -->
                <excludes>
                    <exclude></exclude>
                </excludes>
            </testResource>
        </testResources>
 
        <!-- 構建產生的所有文件存放的目錄 -->
        <directory></directory>
 
        <!-- 產生的構件的文件名,默認值是${artifactId}-${version}。 -->
        <finalName></finalName>
 
        <!-- 當filtering開關打開時,使用到的過濾器屬性文件列表 -->
        <filters></filters>
 
        <!-- 子項目可以引用的默認插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本
             地配置都會覆蓋這裡的配置 -->
        <pluginManagement>
            <!-- 使用的插件列表 。 -->
            <plugins>
                <!-- plugin元素包含描述插件所需要的信息。 -->
                <plugin>
                    <!-- 插件在倉庫里的group ID -->
                    <groupId></groupId>
 
                    <!-- 插件在倉庫里的artifact ID -->
                    <artifactId></artifactId>
 
                    <!-- 被使用的插件的版本(或版本範圍) -->
                    <version></version>
 
                    <!-- 是否從該插件下載Maven擴展(例如打包和類型處理器),由於性能原因,只有在真需要下載時,該
                         元素才被設置成enabled。 -->
                    <extensions>true/false</extensions>
 
                    <!-- 在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 -->
                    <executions>
                        <!-- execution元素包含了插件執行需要的信息 -->
                        <execution>
                            <!-- 執行目標的標識符,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標 -->
                            <id></id>
 
                            <!-- 綁定了目標的構建生命周期階段,如果省略,目標會被綁定到源數據里配置的默認階段 -->
                            <phase></phase>
 
                            <!-- 配置的執行目標 -->
                            <goals></goals>
 
                            <!-- 配置是否被傳播到子POM -->
                            <inherited>true/false</inherited>
 
                            <!-- 作為DOM對象的配置 -->
                            <configuration></configuration>
                        </execution>
                    </executions>
 
                    <!-- 項目引入插件所需要的額外依賴 -->
                    <dependencies>
                        <!-- 參見dependencies/dependency元素 -->
                        <dependency>
                        </dependency>
                    </dependencies>
 
                    <!-- 任何配置是否被傳播到子項目 -->
                    <inherited>true/false</inherited>
 
                    <!-- 作為DOM對象的配置 -->
                    <configuration></configuration>
                </plugin>
            </plugins>
        </pluginManagement>
 
        <!-- 該項目使用的插件列表 。 -->
        <plugins>
            <!-- plugin元素包含描述插件所需要的信息。 -->
            <plugin>
                <!-- 插件在倉庫里的group ID -->
                <groupId></groupId>
 
                <!-- 插件在倉庫里的artifact ID -->
                <artifactId></artifactId>
 
                <!-- 被使用的插件的版本(或版本範圍) -->
                <version></version>
 
                <!-- 是否從該插件下載Maven擴展(例如打包和類型處理器),由於性能原因,只有在真需要下載時,該
                     元素才被設置成enabled。 -->
                <extensions>true/false</extensions>
 
                <!-- 在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 -->
                <executions>
                    <!-- execution元素包含了插件執行需要的信息 -->
                    <execution>
                        <!-- 執行目標的標識符,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標 -->
                        <id></id>
 
                        <!-- 綁定了目標的構建生命周期階段,如果省略,目標會被綁定到源數據里配置的默認階段 -->
                        <phase></phase>
 
                        <!-- 配置的執行目標 -->
                        <goals></goals>
 
                        <!-- 配置是否被傳播到子POM -->
                        <inherited>true/false</inherited>
 
                        <!-- 作為DOM對象的配置 -->
                        <configuration></configuration>
                    </execution>
                </executions>
 
                <!-- 項目引入插件所需要的額外依賴 -->
                <dependencies>
                    <!-- 參見dependencies/dependency元素 -->
                    <dependency>
                    </dependency>
                </dependencies>
 
                <!-- 任何配置是否被傳播到子項目 -->
                <inherited>true/false</inherited>
 
                <!-- 作為DOM對象的配置 -->
                <configuration></configuration>
            </plugin>
        </plugins>
    </build>
 
    <!-- 在列的項目構建profile,如果被激活,會修改構建處理 -->
    <profiles>
        <!-- 根據環境參數或命令行參數激活某個構建處理 -->
        <profile>
            <!-- 構建配置的唯一標識符。即用於命令行激活,也用於在繼承時合併具有相同標識符的profile。 -->
            <id></id>
 
            <!-- 自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自於它能夠
                 在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元
                 素並不是激活profile的唯一方式。 -->
            <activation>
                <!-- profile默認是否激活的標誌 -->
                <activeByDefault>true/false</activeByDefault>
 
                <!-- 當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本
                     不是以1.4開頭的JDK。 -->
                <jdk>jdk版本,如:1.7</jdk>
 
                <!-- 當匹配的操作系統屬性被檢測到,profile被激活。os元素可以定義一些操作系統相關的屬性。 -->
                <os>
                    <!-- 激活profile的操作系統的名字 -->
                    <name> Windows XP </name>
 
                    <!-- 激活profile的操作系統所屬家族(如 'windows') -->
                    <family> Windows </family>
 
                    <!-- 激活profile的操作系統體系結構 -->
                    <arch> x86 </arch>
 
                    <!-- 激活profile的操作系統版本 -->
                    <version> 5.1.2600 </version>
                </os>
 
                <!-- 如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile
                     就會被激活。如果值字段是空的,那麼存在屬性名稱字段就會激活profile,否則按區分大小寫方式匹
                     配屬性值字段 -->
                <property>
                    <!-- 激活profile的屬性的名稱 -->
                    <name> mavenVersion </name>
 
                    <!-- 激活profile的屬性的值 -->
                    <value> 2.0.3 </value>
                </property>
 
                <!-- 提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活
                     profile。另一方面,exists則會檢查文件是否存在,如果存在則激活profile。 -->
                <file>
                    <!-- 如果指定的文件存在,則激活profile。 -->
                    <exists> /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </exists>
 
                    <!-- 如果指定的文件不存在,則激活profile。 -->
                    <missing> /usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </missing>
                </file>
            </activation>
 
            <!-- 構建項目所需要的信息。參見build元素 -->
            <build>
                <defaultGoal />
                <resources>
                    <resource>
                        <targetPath></targetPath>
                        <filtering></filtering>
                        <directory></directory>
                        <includes>
                            <include></include>
                        </includes>
                        <excludes>
                            <exclude></exclude>
                        </excludes>
                    </resource>
                </resources>
                <testResources>
                    <testResource>
                        <targetPath></targetPath>
                        <filtering></filtering>
                        <directory></directory>
                        <includes>
                            <include></include>
                        </includes>
                        <excludes>
                            <exclude></exclude>
                        </excludes>
                    </testResource>
                </testResources>
                <directory></directory>
                <finalName></finalName>
                <filters></filters>
                <pluginManagement>
                    <plugins>
                        <!-- 參見build/pluginManagement/plugins/plugin元素 -->
                        <plugin>
                            <groupId></groupId>
                            <artifactId></artifactId>
                            <version></version>
                            <extensions>true/false</extensions>
                            <executions>
                                <execution>
                                    <id></id>
                                    <phase></phase>
                                    <goals></goals>
                                    <inherited>true/false</inherited>
                                    <configuration></configuration>
                                </execution>
                            </executions>
                            <dependencies>
                                <!-- 參見dependencies/dependency元素 -->
                                <dependency>
                                </dependency>
                            </dependencies>
                            <goals></goals>
                            <inherited>true/false</inherited>
                            <configuration></configuration>
                        </plugin>
                    </plugins>
                </pluginManagement>
                <plugins>
                    <!-- 參見build/pluginManagement/plugins/plugin元素 -->
                    <plugin>
                        <groupId></groupId>
                        <artifactId></artifactId>
                        <version></version>
                        <extensions>true/false</extensions>
                        <executions>
                            <execution>
                                <id></id>
                                <phase></phase>
                                <goals></goals>
                                <inherited>true/false</inherited>
                                <configuration></configuration>
                            </execution>
                        </executions>
                        <dependencies>
                            <!-- 參見dependencies/dependency元素 -->
                            <dependency>
                            </dependency>
                        </dependencies>
                        <goals></goals>
                        <inherited>true/false</inherited>
                        <configuration></configuration>
                    </plugin>
                </plugins>
            </build>
 
            <!-- 模塊(有時稱作子項目) 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的
                 相對路徑 -->
            <modules>
                <!--子項目相對路徑-->
                <module></module>
            </modules>
 
            <!-- 發現依賴和擴展的遠程倉庫列表。 -->
            <repositories>
                <!-- 參見repositories/repository元素 -->
                <repository>
                    <releases>
                        <enabled><enabled>
                        <updatePolicy></updatePolicy>
                        <checksumPolicy></checksumPolicy>
                    </releases>
                    <snapshots>
                        <enabled><enabled>
                        <updatePolicy></updatePolicy>
                        <checksumPolicy></checksumPolicy>
                    </snapshots>
                    <id></id>
                    <name></name>
                    <url></url>
                    <layout></layout>
                </repository>
            </repositories>
 
            <!-- 發現插件的遠程倉庫列表,這些插件用於構建和報表 -->
            <pluginRepositories>
                <!-- 包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 -->
                <pluginRepository>
                    <releases>
                        <enabled><enabled>
                        <updatePolicy></updatePolicy>
                        <checksumPolicy></checksumPolicy>
                    </releases>
                    <snapshots>
                        <enabled><enabled>
                        <updatePolicy></updatePolicy>
                        <checksumPolicy></checksumPolicy>
                    </snapshots>
                    <id></id>
                    <name></name>
                    <url></url>
                    <layout></layout>
                </pluginRepository>
            </pluginRepositories>
 
            <!-- 該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的
                 倉庫中下載。要獲取更多信息,請看項目依賴機制。 -->
            <dependencies>
                <!-- 參見dependencies/dependency元素 -->
                <dependency>
                </dependency>
            </dependencies>
 
            <!-- 不贊成使用. 現在Maven忽略該元素. -->
            <reports></reports>
 
            <!-- 該元素包括使用報表插件產生報表的規範。當用戶執行「mvn site」,這些報表就會運行。 在頁面導航欄能看
                 到所有報表的鏈接。參見reporting元素 -->
            <reporting></reporting>
 
            <!-- 參見dependencyManagement元素 -->
            <dependencyManagement>
                <dependencies>
                    <!-- 參見dependencies/dependency元素 -->
                    <dependency>
                    </dependency>
                </dependencies>
            </dependencyManagement>
 
            <!-- 參見distributionManagement元素 -->
            <distributionManagement>
            </distributionManagement>
 
            <!-- 參見properties元素 -->
            <properties />
        </profile>
    </profiles>
 
    <!-- 模塊(有時稱作子項目) 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 -->
    <modules>
        <!--子項目相對路徑-->
        <module></module>
    </modules>
 
    <!-- 發現依賴和擴展的遠程倉庫列表。 -->
    <repositories>
        <!-- 包含需要連接到遠程倉庫的信息 -->
        <repository>
            <!-- 如何處理遠程倉庫里發佈版本的下載 -->
            <releases>
                <!-- true或者false表示該倉庫是否為下載某種類型構件(發佈版,快照版)開啟。 -->
                <enabled><enabled>
 
                <!-- 該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這裡的選項是:always(一直),
                     daily(默認,每日),interval:X(這裡X是以分鐘為單位的時間間隔),或者never(從不)。 -->
                <updatePolicy></updatePolicy>
 
                <!-- 當Maven驗證構件校驗文件失敗時該怎麼做:ignore(忽略),fail(失敗),或者warn(警告)。 -->
                <checksumPolicy></checksumPolicy>
            </releases>
 
            <!-- 如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,
                 為每種類型的構件採取不同的策略。例如,可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 -->
            <snapshots>
                <enabled><enabled>
                <updatePolicy></updatePolicy>
                <checksumPolicy></checksumPolicy>
            </snapshots>
 
            <!-- 遠程倉庫唯一標識符。可以用來匹配在settings.xml文件里配置的遠程倉庫 -->
            <id> banseon-repository-proxy </id>
 
            <!-- 遠程倉庫名稱 -->
            <name> banseon-repository-proxy </name>
 
            <!-- 遠程倉庫URL,按protocol://hostname/path形式 -->
            <url> //192.168.1.169:9999/repository/ </url>
 
            <!-- 用於定位和排序構件的倉庫布局類型-可以是default(默認)或者legacy(遺留)。Maven 2為其倉庫提供了一個默認
                 的布局;然而,Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default(默認)還是legacy(遺留)。 -->
            <layout> default </layout>
        </repository>
    </repositories>
 
    <!-- 發現插件的遠程倉庫列表,這些插件用於構建和報表 -->
    <pluginRepositories>
        <!-- 包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 -->
        <pluginRepository>
        </pluginRepository>
    </pluginRepositories>
 
    <!-- 該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。
         要獲取更多信息,請看項目依賴機制。 -->
    <dependencies>
        <dependency>
            <!-- 依賴的group ID -->
            <groupId> org.apache.maven </groupId>
 
            <!-- 依賴的artifact ID -->
            <artifactId> maven-artifact </artifactId>
 
            <!-- 依賴的版本號。 在Maven 2里, 也可以配置成版本號的範圍。 -->
            <version> 3.8.1 </version>
 
            <!-- 依賴類型,默認類型是jar。它通常表示依賴的文件的擴展名,但也有例外。一個類型可以被映射成另外一個擴展
                 名或分類器。類型經常和使用的打包方式對應,儘管這也有例外。一些類型的例子:jar,war,ejb-client和test-jar。
                 如果設置extensions為 true,就可以在plugin里定義新的類型。所以前面的類型的例子不完整。 -->
            <type> jar </type>
 
            <!-- 依賴的分類器。分類器可以區分屬於同一個POM,但不同構建方式的構件。分類器名被附加到文件名的版本號後面。例如,
                 如果你想要構建兩個單獨的構件成JAR,一個使用Java 1.4編譯器,另一個使用Java 6編譯器,你就可以使用分類器來生
                 成兩個單獨的JAR構件。 -->
            <classifier></classifier>
 
            <!-- 依賴範圍。在項目發佈過程中,幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。
                - compile :默認範圍,用於編譯
                - provided:類似於編譯,但支持你期待jdk或者容器提供,類似於classpath
                - runtime: 在執行時需要使用
                - test: 用於test任務時使用
                - system: 需要外在提供相應的元素。通過systemPath來取得
                - systemPath: 僅用於範圍為system。提供相應的路徑
                - optional: 當項目自身被依賴時,標註依賴是否傳遞。用於連續依賴時使用 -->
            <scope> test </scope>
 
            <!-- 僅供system範圍使用。注意,不鼓勵使用這個元素,並且在新的版本中該元素可能被覆蓋掉。該元素為依賴規定了文件
                 系統上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑,例如${java.home}。 -->
            <systemPath></systemPath>
 
            <!-- 當計算傳遞依賴時, 從依賴構件列表裡,列出被排除的依賴構件集。即告訴maven你只依賴指定的項目,不依賴項目的
                 依賴。此元素主要用於解決版本衝突問題 -->
            <exclusions>
                <exclusion>
                    <artifactId> spring-core </artifactId>
                    <groupId> org.springframework </groupId>
                </exclusion>
            </exclusions>
 
            <!-- 可選依賴,如果你在項目B中把C依賴聲明為可選,你就需要在依賴於B的項目(例如項目A)中顯式的引用對C的依賴。
                 可選依賴阻斷依賴的傳遞性。 -->
            <optional> true </optional>
        </dependency>
    </dependencies>
 
    <!-- 不贊成使用. 現在Maven忽略該元素. -->
    <reports></reports>
 
    <!-- 該元素描述使用報表插件產生報表的規範。當用戶執行「mvn site」,這些報表就會運行。 在頁面導航欄能看到所有報表的鏈接。 -->
    <reporting>
        <!-- true,則,網站不包括默認的報表。這包括「項目信息」菜單中的報表。 -->
        <excludeDefaults />
 
        <!-- 所有產生的報表存放到哪裡。默認值是${project.build.directory}/site。 -->
        <outputDirectory />
 
        <!-- 使用的報表插件和他們的配置。 -->
        <plugins>
            <!-- plugin元素包含描述報表插件需要的信息 -->
            <plugin>
                <!-- 報表插件在倉庫里的group ID -->
                <groupId></groupId>
                <!-- 報表插件在倉庫里的artifact ID -->
                <artifactId></artifactId>
 
                <!-- 被使用的報表插件的版本(或版本範圍) -->
                <version></version>
 
                <!-- 任何配置是否被傳播到子項目 -->
                <inherited>true/false</inherited>
 
                <!-- 報表插件的配置 -->
                <configuration></configuration>
 
                <!-- 一組報表的多重規範,每個規範可能有不同的配置。一個規範(報表集)對應一個執行目標 。例如,
                     有1,2,3,4,5,6,7,8,9個報表。1,2,5構成A報表集,對應一個執行目標。2,5,8構成B報
                     表集,對應另一個執行目標 -->
                <reportSets>
                    <!-- 表示報表的一個集合,以及產生該集合的配置 -->
                    <reportSet>
                        <!-- 報表集合的唯一標識符,POM繼承時用到 -->
                        <id></id>
 
                        <!-- 產生報表集合時,被使用的報表的配置 -->
                        <configuration></configuration>
 
                        <!-- 配置是否被繼承到子POMs -->
                        <inherited>true/false</inherited>
 
                        <!-- 這個集合里使用到哪些報表 -->
                        <reports></reports>
                    </reportSet>
                </reportSets>
            </plugin>
        </plugins>
    </reporting>
 
    <!-- 繼承自該項目的所有子項目的默認依賴信息。這部分的依賴信息不會被立即解析,而是當子項目聲明一個依賴
        (必須描述group ID和artifact ID信息),如果group ID和artifact ID以外的一些信息沒有描述,則通過
            group ID和artifact ID匹配到這裡的依賴,並使用這裡的依賴信息。 -->
    <dependencyManagement>
        <dependencies>
            <!-- 參見dependencies/dependency元素 -->
            <dependency>
            </dependency>
        </dependencies>
    </dependencyManagement>
 
    <!-- 項目分發信息,在執行mvn deploy後表示要發佈的位置。有了這些信息就可以把網站部署到遠程服務器或者
         把構件部署到遠程倉庫。 -->
    <distributionManagement>
        <!-- 部署項目產生的構件到遠程倉庫需要的信息 -->
        <repository>
            <!-- 是分配給快照一個唯一的版本號(由時間戳和構建流水號)?還是每次都使用相同的版本號?參見
                 repositories/repository元素 -->
            <uniqueVersion />
            <id> banseon-maven2 </id>
            <name> banseon maven2 </name>
            <url> file://${basedir}/target/deploy </url>
            <layout></layout>
        </repository>
 
        <!-- 構件的快照部署到哪裡?如果沒有配置該元素,默認部署到repository元素配置的倉庫,參見
             distributionManagement/repository元素 -->
        <snapshotRepository>
            <uniqueVersion />
            <id> banseon-maven2 </id>
            <name> Banseon-maven2 Snapshot Repository </name>
            <url> scp://svn.baidu.com/banseon:/usr/local/maven-snapshot </url>
            <layout></layout>
        </snapshotRepository>
 
        <!-- 部署項目的網站需要的信息 -->
        <site>
            <!-- 部署位置的唯一標識符,用來匹配站點和settings.xml文件里的配置 -->
            <id> banseon-site </id>
 
            <!-- 部署位置的名稱 -->
            <name> business api website </name>
 
            <!-- 部署位置的URL,按protocol://hostname/path形式 -->
            <url>
                scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web
            </url>
        </site>
 
        <!-- 項目下載頁面的URL。如果沒有該元素,用戶應該參考主頁。使用該元素的原因是:幫助定位
             那些不在倉庫里的構件(由於license限制)。 -->
        <downloadUrl />
 
        <!-- 如果構件有了新的group ID和artifact ID(構件移到了新的位置),這裡列出構件的重定位信息。 -->
        <relocation>
            <!-- 構件新的group ID -->
            <groupId></groupId>
 
            <!-- 構件新的artifact ID -->
            <artifactId></artifactId>
 
            <!-- 構件新的版本號 -->
            <version></version>
 
            <!-- 顯示給用戶的,關於移動的額外信息,例如原因。 -->
            <message></message>
        </relocation>
 
        <!-- 給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素,因為這是工具自動更新的。有效的值
             有:none(默認),converted(倉庫管理員從Maven 1 POM轉換過來),partner(直接從夥伴Maven
             2倉庫同步過來),deployed(從Maven 2實例部署),verified(被核實時正確的和最終的)。 -->
        <status></status>
    </distributionManagement>
 
    <!-- 以值替代名稱,Properties可以在整個POM中使用,也可以作為觸發條件(見settings.xml配置文件里
         activation元素的說明)。格式是<name>value</name>。 -->
    <properties>
        <name>value</name>
    </properties>
</project>

更多精彩敬請關注公眾號

Java極客思維

微信掃一掃,關注公眾號