Maven的pom.xml檔案詳解

林堯彬發表於2020-04-04

轉自:http://www.cnblogs.com/hafiz/p/5360195.html

<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> 

 

轉載於:https://www.cnblogs.com/Dylansuns/p/7302490.html

相關文章