学习笔记——Maven pom.xml配置详解
POM的全稱是“ProjectObjectModel(項目對象模型)”。
pom.xml詳解
聲明規范
<projectxmlns="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.0http://maven.apache.org/maven-v4_0_0.xsd">
<!--聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,這是為了當Maven引入了新的特性或者其他模型變更的時候,確保穩定性。-->
<modelVersion>4.0.0</modelVersion>
基本內容
parent
<!--父項目的坐標。如果項目中沒有規定某個元素的值,那么父項目中的對應值即為項目的默認值。坐標包括groupID,artifactID和version。-->
<parent>
<!--被繼承的父項目的構件標識符-->
<artifactId/>
<!--被繼承的父項目的全球唯一標識符-->
<groupId/>
<!--被繼承的父項目的版本-->
<version/>
<!--父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認值是../pom.xml。Maven首先在構建當前項目的地方尋找父項目的pom,其次在文件系統的這個位置(relativePath位置),然后在本地倉庫,最后在遠程倉庫尋找父項目的pom。-->
<relativePath/>
</parent>
groupId
<!- groupId在一個組織或項目中通常是特有的。例如:(大概、也許)Maven所有artifacts的groupId都使用org.apache.maven。groupId并不一定必須使用點符號,例如,JUnit項目。注意使用點符號的groupId不必與項目的包結構相同,但它是一個很好的做法。 -->
<groupId>org.codehaus.mojo</groupId>
artifactId
<!--artifactId一般是該項目的名字。它和groupID一起標識一個唯一的項目。換句話說,你不能有兩個不同的項目擁有同樣的artifactID和groupID;在某個特定的groupID下,artifactID也必須是唯一的。-->
<artifactId>my-project</artifactId>
version
<!--這是命名的最后一段。groupId:artifactId表示單個項目,但它們無法描繪具體的版本。如:我想要junit:junit項目今天第四版。version定義當前項目的版本,如:1.0(-SNAPSHOT),SNAPSHOT表示快照,說明該項目還處于開發階段,是不穩定版本;建議version格式為:主版本.次版本.增量版本-限定版本號-->
<version>1.0-SNAPSHOT</version>
packaging
<!--項目產生的構件類型,例如jar、war、ear、pom等等。插件可以創建他們自己的構件類型,所以前面列的不是全部構件類型。默認值jar。-->
<packaging>jar</packaging>
<!-- ps:
groupId:artifactId:version:packaging在YouTube某些教學視頻也稱為UUID。
產物是如何儲存在倉庫中的?存放到私服庫時點符號將會被解析成目錄分隔符,SNAPSHOT版本在私服庫中會被解析成8位日期.時分秒毫秒-序號。序號代表第幾次部署。
上面的坐標將會被解析成:org/codehaus/mojo/my-project/1.0-SNAPSHOT/my-project-8位日期.時分秒毫秒-序號.jar
特例:如果你編譯源代碼將產物存放到本地倉庫,將保持不變。
-->
dependencies
<!--該元素描述了項目相關的所有依賴。這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機制。-->
<dependencies>
<dependency>
<!--依賴的groupID-->
<groupId>org.apache.maven</groupId>
<!--依賴的artifactID-->
<artifactId>maven-artifact</artifactId>
<!--依賴的版本號。可以配置成確定的版本號,也可以配置成版本號的范圍。
(, )不包含 [, ]包含 例如:[3.8,4.0) 表示3.8 - 4.0的版本,但是不包含4.0
?-->
<version>3.8.1</version>
<!--依賴類型,默認類型是jar。它通常表示依賴的文件的擴展名,但也有例外。一個類型可以被映射成另外一個擴展名或分類器。類型經常和使用的打包方式對應,盡管這也有例外。一些類型的例子:jar,war,ejb-client和test-jar。如果設置extensions為true,就可以在plugin里定義新的類型。所以前面的類型的例子不完整。-->
<type>jar</type>
<!--依賴的分類器。分類器可以區分屬于同一個POM,但不同構建方式的構件。分類器名被附加到文件名的版本號后面。例如,如果你想要構建兩個單獨的構件成JAR,一個使用Java1.4編譯器,另一個使用Java6編譯器,你就可以使用分類器來生成兩個單獨的JAR構件。-->
<classifier></classifier>
<!--依賴范圍。在項目發布過程中,幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。
-compile:compile是默認的范圍;如果沒有提供一個范圍,那該依賴的范圍就是編譯范
圍。編譯范圍依賴在所有的classpath中可用,同時它們也會被打包。
-provided:provided依賴只有在當JDK?或者一個容器已提供該依賴之后才使用。例如,?如果你開發了一個web?應用,你可能在編譯?classpath?中需要可用的Servlet API?來編譯一個servlet,但是你不會想要在打包好的WAR?中包含這個Servlet API;這個Servlet API JAR?由你的應用服務器或者servlet?容器提供。已提供范圍的依賴在編譯時?(不是運行時)可用。它不具有傳遞性的,也不會被打包。
-runtime:runtime依賴在運行和測試系統的時候需要,但在編譯的時候不需要。比如,你
可能在編譯的時候只需要JDBC API JAR,而只有在運行的時候才需要JDBC驅動實
現。
-test: test范圍依賴 在一般的 編譯和運行時都不需要,它們只有在測試編譯和測試運
行階段可用。
-system:system范圍依賴與provided類似,但是你必須顯式的提供一個對于本地系統中
JAR文件的路徑。這么做是為了允許基于本地對象編譯,而這些對象是系統類庫
的一部分。這樣的構件應該是一直可用的,Maven也不會在倉庫中去尋找它。如
果你將一個依賴范圍設置成系統范圍,你必須同時提供一個systemPath元素。注
意該范圍是不推薦使用的(你應該一直盡量去從公共或定制的Maven倉庫中引用
依賴)。-->
<scope>test</scope>
?
<!--僅供system范圍使用。注意,不鼓勵使用這個元素,并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規定了文件系統上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑,例如${java.home}。-->
<systemPath></systemPath>
?
<!--默認為false,即子項目默認都繼承,為true,則子項目必需顯示的引入。例如:假設項目A在編譯時需要項目B的代碼,但運行時并不需要項目B,而且我們可能并不需要所有項目都依賴項目B。-->
<optional>true</optional><!--當計算傳遞依賴時,從依賴構件列表里,列出被排除的依賴構件集。即告訴maven你只依賴指定的項目,不依賴項目的依賴。也可以使用通配符*排除所有依賴。此元素主要用于解決版本沖突問題.-->
<exclusions>
<exclusion>
<artifactId>spring-core</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
</exclusions>
<!--可選依賴,如果你在項目B中把C依賴聲明為可選,你就需要在依賴于B的項目(例如項目A)中顯式的引用對C的依賴。可選依賴阻斷依賴的傳遞性。-->
<optional>true</optional>
</dependency>
</dependencies>
?
dependencyManagement
<!--繼承自該項目的所有子項目的默認依賴信息。這部分的依賴信息不會被立即解析,而是當子項目聲明一個依賴(必須描述groupID和artifactID信息),如果groupID和artifactID以外的一些信息沒有描述,則通過groupID和artifactID匹配到這里的依賴,并使用這里的依賴信息。-->
<dependencyManagement>
<!--參見dependencies元素-->
<dependencies>
<dependency>
......
</dependency>
</dependencies>
</dependencyManagement>
modules
<!--模塊(有時稱作子項目)被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑-->
<modules/>
<!-- Ps:繼承和模塊的區別:繼承父不知子,但子知父。模塊父知子,但子不知父。所以在具體的項目中一般都是繼承和模塊融合使用。 -->
properties
<!--鍵值對,Properties可以在整個POM中使用,也可以作為觸發條件(見settings.xml配置文件里profiles→properties元素的說明)。格式是<name>value</name>。-->
<properties>
<dept>No</dept>
</properties>
?
編譯設置
build
<!--構建項目需要的信息-->
<build>
<!-- 預定義執行的目標或者階段,必須和命令行的參數相同。如:jar:jar或者clean install等等。例如:defaultGoal配置clean install ,在命令行輸入mvn時會自動拼接成mvn clean install。偷懶的福音啊。-->
<defaultGoal>install</defaultGoal> <!-- 編譯輸出目錄,默認值${basedir}/target(不建議修改) --> <directory>${basedir}/target</directory> <!-- 構建產物的名稱,沒有文件擴展名。默認值${artifactId}-${version}。 --> <finalName>${artifactId}-${version}</finalName> <!-- 單獨過濾某個文件,更多內容請訪問如何過濾資源文件 --> <filters> ??? <filter>src/main/filters/filter.properties</filter> </filters><!--這個元素描述了項目相關的所有資源路徑列表,例如和項目相關的屬性文件,這些資源被包含在最終的打包文件里。-->
<resources>
<!--這個元素描述了項目相關的資源路徑-->
<resource>
<!-- ?指定build后的resource存放的文件夾。該路徑默認是basedir。通常被打包在JAR中的resources的目標路徑為META-INF -->
<targetPath></targetPath>
<!--是否使用參數值代替參數名。如:aa=name 將my ${aa}顯示為my name。true代表替換,false代表不替換。參數值取自properties元素、文件里配置的屬性或者命令行的-D選項。有@aa@和${aa}倆種寫法。更多內容請查看在線幫助-->
<filtering>false</filtering>
<!--描述存放資源的目錄,該路徑相對POM路徑。默認值${basedir}/src/main/resources -->
<directory>${basedir}/src/main/resources </directory>
<!--用于指定要包括的文件。可以使用通配符*。例如**/*.xml。 -->
<includes>
????????? <include>configuration.xml</include>
?</includes>
<!--用于指定不需要包括的文件。可以使用通配符*。例如**/*.xml。如果和includes的配置沖突,excludes的優先級更高。 -->
<excludes>
????????? <exclude>**/*.properties</exclude>
</excludes>
</resource>
</resources>
<!--該testResources元素塊包含testResource元素。它們的定義是類似的resource?元素,僅在測試階段使用。和resource元素唯一一點不同是testResource的默認值是${project.basedir}/src/test/resources。測試資源是不會部署。-->
<testResources>
<testResource>
<targetPath/>
<filtering/>
<directory/>
<includes/>
<excludes/>
</testResource>
</testResources>
<plugins>
<!--plugin元素包含描述插件所需要的信息。-->
<plugin>
<!--插件在倉庫里的groupID-->
<groupId>org.apache.maven.plugins</groupId>
<!--插件在倉庫里的artifactID-->
<artifactId>maven-jar-plugin</artifactId>
<!--被使用的插件的版本(或版本范圍)-->
<version>2.0</version>
<!--是否從該插件下載Maven擴展(例如打包和類型處理器),由于性能原因,只有在真需要下載時,該元素才被設置成enabled。-->
<extensions>false</extensions>
<!-- true 或 false ,這個插件的配置是否,可以繼承。默認true。? -->
<inherited>true</inherited>
<!-- 請查閱https://maven.apache.org/pom.html#Plugins或者查閱中文版http://blog.csdn.net/tomato__/article/details/13625497 -->
<configuration>
<classifier>test</classifier>
</configuration>
<!-- 請參考dependencies元素? -->
<dependencies>
<dependency>
? <groupId/>
? <artifactId/>
? <version/>
? <type/>
? <classifier/>
? <scope/>
? <systemPath/>
? <exclusions>
???????? <exclusion>
???????? ? <artifactId/>
???????? ? <groupId/>
???????? </exclusion>
? </exclusions>
? <optional/>
</dependency>
</dependencies>
<!--在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。-->
<executions>
<!--execution元素包含了插件執行需要的信息-->
<execution>
<!--執行目標的標識符,用于標識構建過程中的目標,或者匹配繼承過程中需要合并的執行目標-->
<id>echodir</id>
<!--綁定了目標的構建生命周期階段,如果省略,目標會被綁定到源數據里配置的默認階段-->
<phase>verify</phase>
<!--配置的執行目標-->
<goals>
<goal>run</goal>
</goals>
<!--配置是否被傳播到子POM-->
<inherited>false</inherited>
<!-- 請查閱https://maven.apache.org/pom.html#Plugins -->
<configuration>
<tasks>
<echo>Build Dir: ${project.build.directory}</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
<!--子項目可以引用的默認插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置-->
<pluginManagement>
<plugins>
.................
</plugins>
</pluginManagement>
<!--該元素設置了項目源碼目錄,當構建項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。-->
<sourceDirectory>${basedir}/src/main/java</sourceDirectory>
<!--該元素設置了項目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數情況下,該目錄下的內容會被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。-->
<scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>
<!--該元素設置了項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。-->
<testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>
<!--被編譯過的應用程序class文件存放的目錄。-->
<outputDirectory>${basedir}/target/classes</outputDirectory>
<!--被編譯過的測試class文件存放的目錄。-->
<testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>
<!--使用來自該項目的一系列構建擴展-->
<extensions>
<!--描述使用到的構建擴展。-->
<extension>
<!--構建擴展的groupId-->
<groupId/>
<!--構建擴展的artifactId-->
<artifactId/>
<!--構建擴展的版本-->
<version/>
</extension>
</extensions>
</build>
reporting
<!--該元素描述使用報表插件產生報表的規范。當用戶執行“mvn site”,這些報表就會運行。在頁面導航欄能看到所有報表的鏈接。-->
<reporting>
<!--所有產生的報表存放到哪里。默認值是${basedir}/target/site。-->
<outputDirectory>${basedir}/target/site</outputDirectory><!--如果為true,則網站不包括默認的報表。這包括“項目信息”菜單中的報表。默認false-->
<excludeDefaults>false</excludeDefaults>
<!--使用的報表插件和他們的配置。-->
<plugins>
<!--plugin元素包含描述報表插件需要的信息-->
<plugin>
<!--報表插件在倉庫里的groupID,默認值是?:?org.apache.maven.plugins?。-->
<groupId>org.apache.maven.plugins</groupId>
<!--報表插件在倉庫里的artifactID-->
<artifactId>maven-project-info-reports-plugin</artifactId><!--被使用的報表插件的版本(或版本范圍)-->
<version>2.7</version>
<!--任何配置是否被傳播到子項目,默認true-->
<inherited>true<inherited/>
<!--報表插件的配置-->
<configuration/>
<!--一組報表的多重規范,每個規范可能有不同的配置。一個規范(報表集)對應一個執行目標。例如,有1,2,3,4,5,6,7,8,9個報表。1,2,5構成A報表集,對應一個執行目標。2,5,8構成B報表集,對應另一個執行目標-->
<reportSets>
<!--表示報表的一個集合,以及產生該集合的配置-->
<reportSet>
<!--報表集合的唯一標識符,POM繼承時用到,默認值:default -->
<id>default<id>
<!--產生報表集合時,被使用的報表的配置-->
<configuration/>
<!--配置是否被繼承到子POMs-->
<inherited/>
<!--這個集合里使用到哪些報表-->
<reports/>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
項目信息
name
<!--項目的名稱,Maven產生的文檔用-->
<name>banseon-maven</name>
description
<!--項目的詳細描述,Maven產生的文檔用。當這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略,就可以包含HTML標簽),不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面,你應該修改你自己的索引頁文件,而不是調整這里的文檔。-->
<description>Amavenprojecttostudymaven.</description>
url
<!--項目主頁的URL,Maven產生的文檔用-->
<url>http://www.baidu.com/banseon</url>
inceptionYear
<!--項目創建年份,4位數字。當產生版權信息時需要使用這個值。-->
<inceptionYear/>
licenses
<!--該元素描述了項目所有License列表。應該只列出該項目的license列表,不要列出依賴項目的license列表。如果列出多個license,用戶可以選擇它們中的一個而不是接受所有license。-->
<licenses>
<!--描述了項目的license,用于生成項目的web站點的license頁面,其他一些報表和validation也會用到該元素。-->
<license>
<!--完整的法律許可的名稱。?-->
<name>Apache2</name>
<!--官方的license正文頁面的URL-->
<url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>
<!--項目分發的主要方式:
repo,可以從Maven庫下載
manual,用戶必須手動下載和安裝依賴-->
<distribution>repo</distribution>
<!--關于license的補充信息-->
<comments>Abusiness-friendlyOSSlicense</comments>
</license>
</licenses>
organization
<!--描述項目所屬組織的各種屬性。Maven產生的文檔用-->
<organization>
<!--組織的全名-->
<name>demo</name>
<!--組織主頁的URL-->
<url>http://www.baidu.com/banseon</url>
</organization>
developers
<!--項目開發者列表-->
<developers>
<!--某個項目開發者的信息-->
<developer>
<!--SCM里項目開發者的唯一標識符-->
<id>HELLOWORLD</id>
<!--項目開發者的全名-->
<name>banseon</name>
<!--項目開發者的email-->
<email>banseon@126.com</email>
<!--項目開發者的主頁的URL-->
<url/>
<!--項目開發者在項目中扮演的角色,角色元素描述了各種角色-->
<roles>
<role>ProjectManager</role>
<role>Architect</role>
</roles>
<!--項目開發者所屬組織-->
<organization>demo</organization>
<!--項目開發者所屬組織的URL-->
<organizationUrl>http://hi.baidu.com/banseon</organizationUrl>
<!--項目開發者所在時區,-12到14范圍內的整數。-->
<timezone>-5</timezone>
<!-- 其他配置,鍵值對 -->
<properties>
<picUrl>http://tinyurl.com/prv4t</picUrl>
</properties>
</developer>
</developers>
contributors
<!--項目的其他貢獻者列表-->
<contributors>
<!--項目的其他貢獻者。參見developers/developer元素-->
<contributor>
<name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><properties/>
</contributor>
</contributors>
環境設置
issueManagement
<!--項目的問題管理系統(Bugzilla,Jira,Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例為jira-->
<issueManagement>
<!--問題管理系統(例如jira)的名字,-->
<system>jira</system>
<!--該項目使用的問題管理系統的URL-->
<url>http://jira.baidu.com/banseon</url>
</issueManagement>
ciManagement
<!--項目持續集成信息-->
<ciManagement>
<!--持續集成系統的名字,例如continuum-->
<system>continuum</system>
<!--該項目使用的持續集成系統的URL(如果持續集成系統有web接口的話)。-->
<url>http://127.0.0.1:8080/continuum</url>
<!--構建完成時,需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告)-->
<notifiers>
<!--配置一種方式,當構建中斷時,以該方式通知用戶/開發者-->
<notifier>
<!--傳送通知的途徑-->
<type>mail</type>
<!--發生錯誤時是否通知-->
<sendOnError>true</sendOnError>
<!--構建失敗時是否通知-->
<sendOnFailure>true</sendOnFailure>
<!--構建成功時是否通知-->
<sendOnSuccess>false</sendOnSuccess>
<!--發生警告時是否通知-->
<sendOnWarning>false</sendOnWarning>
<!--棄用。通知發送到哪里-->
<address/>
<!--通知擴展配置項-->
<configuration><address>continuum@127.0.0.1</address></configuration>
</notifier>
</notifiers>
</ciManagement>
mailingLists
<!--項目相關郵件列表信息-->
<mailingLists>
<!--該元素描述了項目相關的所有郵件列表。自動產生的網站引用這些信息。-->
<mailingList>
<!--郵件的名稱-->
<name>User List</name>
<!--發送郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto:鏈接會被自動創建-->
<post>user@127.0.0.1</post>
<!--訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto:鏈接會被自動創建-->
<subscribe>user-subscribe@127.0.0.1</subscribe>
<!--取消訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto:鏈接會被自動創建-->
<unsubscribe>user-unsubscribe@127.0.0.1</unsubscribe>
<!--你可以瀏覽郵件信息的URL-->
<archive>http://127.0.0.1/user/</archive>
<!--備用url的鏈接,可以瀏覽存檔列表。-->
<otherArchives>
<otherArchive>http://base.google.com/base/1/127.0.0.1</otherArchive>
</mailingList>
</mailingLists>
scm
<!--SCM(Source Control Management)標簽允許你配置你的代碼庫,供Maven web站點和其它插件使用。-->
<scm>
<!--SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情,請看SCMs提供的URL格式和支持列表。該連接只讀。-->
<connection>scm:svn:http://127.0.0.1/svn/my-project</connection>
<!--給開發者使用的,類似connection元素。即該連接不僅僅只讀-->
<developerConnection>scm:svn:https://127.0.0.1/svn/my-project</developerConnection>
<!--當前代碼的標簽,在開發階段默認為HEAD-->
<tag>HEAD</tag>
<!--指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。-->
<url>http://127.0.0.1/websvn/my-project</url>
</scm>
prerequisites
<!--描述了這個項目構建環境中的前提條件。-->
<prerequisites>
<!--構建該項目或使用該插件所需要的Maven的最低版本。默認值:2.0-->
<maven>2.0.6</maven>
</prerequisites>
repositories
<!--遠程倉庫列表,它是Maven用來填充構建系統本地倉庫所使用的一組遠程項目。 -->
???<repositories>
????<!--包含需要連接到遠程倉庫的信息 -->
????<repository>
?????<!--遠程倉庫唯一標識-->
?????<id>codehausSnapshots</id>
?????<!--遠程倉庫名稱 -->
?????<name>Codehaus Snapshots</name>
?????<!--如何處理遠程倉庫里發布版本的下載-->
?????<releases>
??????<!--true或者false表示該倉庫是否為下載某種類型構件(發布版,快照版)開啟。? -->
??????<enabled>false</enabled>
??????<!--該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這里的選項是:always(一直),daily(默認,每日),interval:X(這里X是以分鐘為單位的時間間隔),或者never(從不)。 -->
??????<updatePolicy>always</updatePolicy>
??????<!--當Maven驗證構件校驗文件失敗時該怎么做-ignore(忽略),fail(失敗),或者warn(警告)。-->
??????<checksumPolicy>warn</checksumPolicy>
?????</releases>
?????<!--如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種類型的構件采取不同的策略。例如,可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素-->
?????<snapshots>
??????<enabled/><updatePolicy/><checksumPolicy/>
?????</snapshots>
?????<!--遠程倉庫URL,按protocol://hostname/path形式 -->
?????<url>http://snapshots.maven.codehaus.org/maven2</url>
?????<!--用于定位和排序構件的倉庫布局類型-可以是default(默認)或者legacy(遺留)。Maven 2為其倉庫提供了一個默認的布局;然而,Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default(默認)還是legacy(遺留)。 -->
?????<layout>default</layout>
????</repository>
???</repositories>
pluginRepositories
<!--包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素-->
<pluginRepositories>
<pluginRepository>
<releases>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</releases>
<snapshots>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</snapshots>
<id/>
<name/>
<url/>
<layout/>
</pluginRepository>
</pluginRepositories>
distributionManagement
<!--項目分發信息,在執行mvndeploy后表示要發布的位置。有了這些信息就可以把網站部署到遠程服務器或者把構件部署到遠程倉庫。-->
<distributionManagement>
<!--部署項目產生的構件到遠程倉庫需要的信息,參見repositories/repository元素-->
<repository>
<!--true:分配給快照一個唯一的版本號(由時間戳和構建流水號組成)。false:每次都使用相同的版本號 -->
<uniqueVersion>true</uniqueVersion>
?<id/>
<name/>
<url/>
?<layout/>
<releases>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</releases>
<snapshots>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</snapshots>
</repository>
<!--構件的快照部署到哪里? -->
<snapshotRepository>
<uniqueVersion>true</uniqueVersion>
?<id/>
<name/>
<url/>
?<layout/>
<releases>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</releases>
<snapshots>
<enabled/>
<updatePolicy/>
<checksumPolicy/>
</snapshots>
</snapshotRepository>
<!--部署項目的網站需要的信息-->
<site>
<!--部署位置的唯一標識符,用來匹配站點和settings.xml文件里的配置-->
<id>banseon-site</id>
<!--部署位置的名稱-->
<name>businessapiwebsite</name>
<!--部署位置的URL,按protocol://hostname/path形式-->
<url>
scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web
</url>
</site>
<!--項目下載頁面的URL。如果沒有該元素,用戶應該參考主頁。使用該元素的原因是:幫助定位那些不在倉庫里的構件(由于license限制)。-->
<downloadUrl/>
<!--如果構件有了新的groupID和artifactID(構件移到了新的位置),這里列出構件的重定位信息。-->
<relocation>
<!--構件新的groupID-->
<groupId/>
<!--構件新的artifactID-->
<artifactId/>
<!--構件新的版本號-->
<version/>
<!--顯示給用戶的,關于移動的額外信息,例如原因。-->
<message/>
</relocation>
<!--給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素,因為這是工具自動更新的。有效的值有:none(默認),converted(倉庫管理員從Maven1 POM轉換過來),partner(直接從伙伴Maven2倉庫同步過來),deployed(從Maven2實例部署),verified(被核實時正確的和最終的)。-->
<status/>
</distributionManagement>
profiles
<!--在列的項目構建profile,如果被激活,會修改構建處理-->
<profiles>
<!--根據環境參數或命令行參數激活某個構建處理-->
<profile>
<!--構建配置的唯一標識符。即用于命令行激活,也用于在繼承時合并具有相同標識符的profile。-->
<id>test</id>
???<!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。如POM中的profile一樣,profile的力量來自于它能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元素并不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id。profile也可以通過在命令行,使用-P標記和逗號分隔的列表來顯式的激活(如,-P test)。-->
???<activation>
????<!--profile默認是否激活的標識-->
????<activeByDefault>false</activeByDefault>
????<!--當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK。-->
????<jdk>1.5</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中通過${name}引用),其擁有對應的name = 值,Profile就會被激活。如果值字段是空的,那么存在屬性名稱字段就會激活profile,否則按區分大小寫方式匹配屬性值字段-->
????<property>
?????<!--激活profile的屬性的名稱-->
?????<name>mavenVersion</name>
?????<!--激活profile的屬性的值 -->
?????<value>2.0.3</value>
????</property>
????<!--提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活profile。另一方面,exists則會檢查文件是否存在,如果存在則激活profile。-->
????<file>
?????<!--如果指定的文件存在,則激活profile。 -->
?????<exists>${basedir}/file2.properties</exists>
?????<!--如果指定的文件不存在,則激活profile。-->
?????<missing>${basedir}/file1.properties</missing>
????</file>
???</activation>
<!--構建項目所需要的信息。參見build元素-->
<build>
<defaultGoal/>
<resources>
<resource>
<targetPath/><filtering/><directory/><includes/><excludes/>
</resource>
</resources>
<testResources>
<testResource>
<targetPath/><filtering/><directory/><includes/><excludes/>
</testResource>
</testResources>
<directory/><finalName/><filters/>
<pluginManagement>
<plugins>
<!--參見build/pluginManagement/plugins/plugin元素-->
<plugin>
<groupId/><artifactId/><version/><extensions/>
<executions>
<execution>
<id/><phase/><goals/><inherited/><configuration/>
</execution>
</executions>
<dependencies>
<!--參見dependencies/dependency元素-->
<dependency>
......
</dependency>
</dependencies>
<goals/><inherited/><configuration/>
</plugin>
</plugins>
</pluginManagement>
<plugins>
<!--參見build/pluginManagement/plugins/plugin元素-->
<plugin>
<groupId/><artifactId/><version/><extensions/>
<executions>
<execution>
<id/><phase/><goals/><inherited/><configuration/>
</execution>
</executions>
<dependencies>
<!--參見dependencies/dependency元素-->
<dependency>
......
</dependency>
</dependencies>
<goals/><inherited/><configuration/>
</plugin>
</plugins>
</build>
<!--發現依賴和擴展的遠程倉庫列表。-->
<repositories>
<!--參見repositories/repository元素-->
<repository>
<releases>
<enabled/><updatePolicy/><checksumPolicy/>
</releases>
<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>
<id/><name/><url/><layout/>
</repository>
</repositories>
<!--該元素描述了項目相關的所有依賴。這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機制。-->
<dependencies>
<!--參見dependencies/dependency元素-->
<dependency>
......
</dependency>
</dependencies>
<!--不贊成使用.現在Maven忽略該元素.-->
<reports/>
?
<!--參見distributionManagement元素-->
<distributionManagement>
......
</distributionManagement>
<!--參見properties元素-->
<properties/>
</profile>
</profiles>
</project>
<!--參考:
http://maven.apache.org/ref/3.1.0/maven-model/maven.html
https://maven.apache.org/pom.html
-->
好記性不如爛筆頭!from:?http://www.cnblogs.com/zz0412/p/Maven_pom.html
總結
以上是生活随笔為你收集整理的学习笔记——Maven pom.xml配置详解的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Spring 系列,第 3 部分: 进入
- 下一篇: Servlet 实例