Maven之pom.xml配置文件詳解

時間 2019-12-14
標籤 maven pom.xml pom xml 配置文件詳解欄目 Maven 简体版
原文原文鏈接
Maven之pom.xml配置文件詳解

2019-06-05html
1、什麼是pom?

POM是項目對象模型(Project Object Model)的簡稱,它是Maven項目中的文件，使用XML表示，名稱叫作pom.xml。做用相似ant的build.xml文件，功能更強大。該文件用於管理：源代碼、配置文件、開發者的信息和角色、問題追蹤系統、組織信息、項目受權、項目的url、項目的依賴關係等等。事實上，在Maven世界中，project能夠什麼都沒有，甚至沒有代碼，可是必須包含pom.xml文件。java
2、概覽

下面是一個POM項目中的pom.xml文件中包含的元素。注意，其中的modelVersion是4.0.0，這是當前僅有的能夠被Maven2&3同時支持的POM版本，它是必須的。mysql
<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 "> 

    <!-- 父項目的座標。若是項目中沒有規定某個元素的值，那麼父項目中的對應值即爲項目的默認值。
         座標包括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> http://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> http://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> banseon@126.com </post> 

            <!-- 訂閱郵件的地址或連接，若是是郵件地址，建立文檔時，mailto: 連接會被自動建立 --> 
            <subscribe> banseon@126.com </subscribe> 

            <!-- 取消訂閱郵件的地址或連接，若是是郵件地址，建立文檔時，mailto: 連接會被自動建立 --> 
            <unsubscribe> banseon@126.com </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> banseon@126.com </email> 

            <!-- 項目開發者的主頁的URL --> 
            <url></url> 

            <!-- 項目開發者在項目中扮演的角色，角色元素描述了各類角色 --> 
            <roles> 
                <role> Project Manager </role> 
                <role> Architect </role> 
            </roles> 

            <!-- 項目開發者所屬組織 --> 
            <organization> demo </organization> 

            <!-- 項目開發者所屬組織的URL --> 
            <organizationUrl> http://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> http://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:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
        </connection> 

        <!-- 給開發者使用的，相似connection元素。即該鏈接不只僅只讀 --> 
        <developerConnection> 
            scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk 
        </developerConnection> 

        <!-- 當前代碼的標籤，在開發階段默認爲HEAD --> 
        <tag></tag> 

        <!-- 指向項目的可瀏覽SCM庫（例如ViewVC或者Fisheye）的URL。 --> 
        <url> http://svn.baidu.com/banseon </url> 
    </scm> 

    <!-- 描述項目所屬組織的各類屬性。Maven產生的文檔用 --> 
    <organization> 
        <!-- 組織的全名 --> 
        <name> demo </name> 

        <!-- 組織主頁的URL --> 
        <url> http://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> http://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>
3、maven POM.xml詳解

一、基本配置

modelVersionweb	Maven模塊版本，目前咱們通常都取值4.0.0spring
groupIdsql	整個系統的名稱。apache
artifactIdwindows	子模塊名稱。api
packagingtomcat	打包類型，可取值：jar,war等等，這個配置用於package的phase，具體能夠參見package運行的時候啓動的plugin，後面有機會咱們會講述如何配置打包的插件。
二、dependencies

依賴關係。實際上pom之間存在好三種關係：繼承、依賴、聚合。咱們先講依賴，這也是最重要的關係。
groupId	依賴項的groupId
artifactId	依賴項的artifactId
version	依賴項的版本
scope	依賴項的適用範圍： compile，缺省值，適用於全部階段，會隨着項目一塊兒發佈。 provided，相似compile，指望JDK、容器或使用者會提供這個依賴。如servlet.jar。 runtime，只在運行時使用，如JDBC驅動，適用運行和測試階段。 test，只在測試時使用，用於編譯和運行測試代碼。不會隨項目發佈。 system，相似provided，須要顯式提供包含依賴的jar，Maven不會在Repository中查找它。以前例子裏的junit就只用在了test中。
exclusions	排除項目中的依賴衝突時使用。