pom作為項目對象模型。通過xml表示maven項目，使用pom.xml來實現。主要描述了項目：包括配置文件；開發者需要遵循的規則，缺陷管理系統，組織和licenses，項目的url，項目的依賴性，以及其他所有的項目相關因素。
<project> <modelVersion>4.0.0</modelVersion> <!--maven2.0必須是這樣寫，現在是maven2唯一支持的版本--> <!-- 基礎設置 --> <groupId>...</groupId> <artifactId>...</artifactId> <version>...</version> <packaging>...</packaging> <name>...</name> <url>...</url> <dependencies>...</dependencies> <parent>...</parent> <dependencyManagement>...</dependencyManagement> <modules>...</modules> <properties>...</properties> <!--構建設置 --> <build>...</build> <reporting>...</reporting> <!-- 更多項目信息 --> <name>...</name> <description>...</description> <url>...</url> <inceptionYear>...</inceptionYear> <licenses>...</licenses> <organization>...</organization> <developers>...</developers> <contributors>...</contributors> <!-- 環境設置--> <issueManagement>...</issueManagement> <ciManagement>...</ciManagement> <mailingLists>...</mailingLists> <scm>...</scm> <prerequisites>...</prerequisites> <repositories>...</repositories> <pluginRepositories>...</pluginRepositories> <distributionManagement>...</distributionManagement> <profiles>...</profiles> </project>
基本內容：
POM包括了所有的項目信息
groupId:項目或者組織的唯一標志，並且配置時生成路徑也是由此生成，如org.myproject.mojo生成的相對路徑為：/org/myproject/mojo
artifactId:項目的通用名稱
version:項目的版本
packaging:打包機制，如pom,jar,maven-plugin,ejb,war,ear,rar,par
name:用戶描述項目的名稱，無關緊要的東西，可選
url:應該是只是寫明開發團隊的網站，無關緊要，可選
classifer:分類
其中groupId,artifactId,version,packaging這四項組成了項目的唯一坐標。一般情況下，前面三項就可以組成項目的唯一坐標了。
POM關系：主要為依賴，繼承，合成
依賴關系：
<dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.0</version> <type>jar</type> <scope>test</scope> <optional>true</optional> </dependency> <dependency> <groupId>com.alibaba.china.shared</groupId> <artifactId>alibaba.apollo.webx</artifactId> <version>2.5.0</version> <exclusions> <exclusion> <artifactId>org.slf4j.slf4j-api</artifactId> <groupId>com.alibaba.external</groupId> </exclusion> .... </exclusions> ...... </dependencies>
其中groupId, artifactId, version這三個組合標示依賴的具體工程，而且 這個依賴工程必需是maven中心包管理范圍內的，如果碰上非開源包，maven支持不了這個包，那么則有有三種 方法處理：
1.本地安裝這個插件install plugin
例如：mvn install:intall-file -Dfile=non-maven-proj.jar -DgroupId=som.group -DartifactId=non-maven-proj -Dversion=1
2.創建自己的repositories並且部署這個包，使用類似上面的deploy:deploy-file命令，
3.設置scope為system,並且指定系統路徑。
dependency里屬性介紹：
type：默認為jar類型，常用的類型有：jar,ejb-client,test-jar...,可設置plugins中的extensions值為true后在增加 新的類型，
scope：是用來指定當前包的依賴范圍，maven的依賴范圍
optional:設置指依賴是否可選，默認為false,即子項目默認都繼承，為true,則子項目必需顯示的引入，與dependencyManagement里定義的依賴類似 。
exclusions：如果X需要A,A包含B依賴，那么X可以聲明不要B依賴，只要在exclusions中聲明exclusion.
exclusion:是將B從依賴樹中刪除，如上配置，alibaba.apollo.webx不想使用com.alibaba.external ,但是alibaba.apollo.webx是集成了com.alibaba.external,r所以就需要排除掉.
如果一個工程是parent或者aggregation（即mutil-module的）的，那么必須在packing賦值為pom,child工 程從parent繼承的包括：dependencies,developers,contributors,plugin lists,reports lists,plugin execution with matching ids,plugin configuration
parent的使用方法如下：
<parent> <groupId>org.codehaus.mojo</groupId> <artifactId>my-parent</artifactId> <version>2.0</version> <relativePath>../my-parent</relativePath> </parent>
relativePath是可選的,maven會首先搜索這個地址,在搜索本地遠程repositories之前.
dependencyManagement：是用於幫助管理chidren的dependencies的。例如如果parent使用 dependencyManagement定義了一個dependencyon junit:junit4.0,那么 它的children就可以只引用 groupId和artifactId,而version就可以通過parent來設置，這樣的好處就是可以集中管理 依賴的詳情
modules:對於多模塊的project,outer-module沒有必需考慮inner-module的dependencies,當列出modules的時候，modules的順序是不重要的，因為maven會自動根據依賴關系來拓撲排序，
modules例子如下 ：
<module>my-project</module> <module>other-project</module>
properties:是為pom定義一些常量，在pom中的其它地方可以直接引用。
定義方式如下：
<properties> <file.encoding>UTF-8</file_encoding> <java.source.version>1.5</java_source_version> <java.target.version>1.5</java_target_version> </properties>
使用方式 如下 ：
${file.encoding}
還可以使用project.xx引用pom里定義的其它屬性：如$(project.version}
build設置:
defaultGoal:默認的目標，必須跟命令行上的參數相同，如：jar:jar,或者與時期parse相同,例如install
directory:指定build target目標的目錄，默認為$(basedir}/target,即項目根目錄下的target
finalName:指定去掉后綴的工程名字，例如：默認為${artifactId}-${version}
filters:用於定義指定filter屬性的位置，例如filter元素賦值filters/filter1.properties,那么這個 文件里面就可以定義name=value對，這個name=value對的值就可以在工程pom中通過${name}引用，默認的filter目錄 是${basedir}/src/main/fiters/
resources:描述工程中資源的位置
<resource> <targetPath>META-INF/plexus</targetPath> <filtering>false</filtering> <directory>${basedir}/src/main/plexus</directory> <includes> <include>configuration.xml</include> </includes> <excludes> <exclude>**/*.properties</exclude> </excludes> </resource>
targetPath:指定build資源到哪個目錄，默認是base directory
filtering:指定是否將filter文件(即上面說的filters里定義的*.property文件)的變量值在這個resource文件有效,例如上面就指定那些變量值在configuration文件無效。
directory:指定屬性文件的目錄，build的過程需要找到它，並且將其放到targetPath下，默認的directory是${basedir}/src/main/resources
includes:指定包含文件的patterns,符合樣式並且在directory目錄下的文件將會包含進project的資源文件。
excludes:指定不包含在內的patterns,如果inclues與excludes有沖突，那么excludes勝利，那些符合沖突的樣式的文件是不會包含進來的。
testResources:這個模塊包含測試資源元素，其內容定義與resources類似，不同的一點是默認的測試資源路徑是${basedir}/src/test/resources,測試資源是不部署的。
plugins配置：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <version>2.0</version> <extensions>false</extensions> <inherited>true</inherited> <configuration> <classifier>test</classifier> </configuration> <dependencies>...</dependencies> <executions>...</executions> </plugin>
extensions:true or false, 決定是否要load這個plugin的extensions，默認為true.
inherited:是否讓子pom繼承，ture or false 默認為true.
configuration:通常用於私有不開源的plugin,不能夠詳細了解plugin的內部工作原理，但使plugin滿足的properties
dependencies:與pom基礎的dependencies的結構和功能都相同，只是plugin的dependencies用於 plugin,而pom的denpendencies用於項目本身。在plugin的dependencies主要用於改變plugin原來的 dependencies，例如排除一些用不到的dependency或者修改dependency的版本等，詳細請看pom的 denpendencies.
executions:plugin也有很多個目標，每個目標具有不同的配置，executions就是設定plugin的目標，
<execution> <id>echodir</id> <goals> <goal>run</goal> </goals> <phase>verify</phase> <inherited>false</inherited> <configuration> <tasks> <echo>Build Dir: ${project.build.directory}</echo> </tasks> </configuration> </execution>
id:標識符
goals:里面列出一系列的goals元素，例如上面的run goal
phase:聲明goals執行的時期，例如：verify
inherited:是否傳遞execution到子pom里。
configuration:設置execution下列表的goals的設置，而不是plugin所有的goals的設置
pluginManagement配置：
pluginManagement的作用類似於denpendencyManagement,只是denpendencyManagement是用 於管理項目jar包依賴，pluginManagement是用於管理plugin。與pom build里的plugins區別是，這里的plugin是列出來，然后讓子pom來決定是否引用。
例如：
<pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <version>2.2</version> <executions> <execution> <id>pre-process-classes</id> <phase>compile</phase> <goals> <goal>jar</goal> </goals> <configuration> <classifier>pre-process</classifier> </configuration> </execution> </executions> </plugin> </plugins> </pluginManagement>
子pom引用方法：
在pom的build里的plugins引用：
<plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> </plugin> </plugins>
build里的directories:
<sourceDirectory>${basedir}/src/main/java</sourceDirectory> <scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory> <testSourceDirectory>${basedir}/src/test/java</testSourceDirectory> <outputDirectory>${basedir}/target/classes</outputDirectory> <testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>
這幾個元素只在parent build element里面定義，他們設置多種路徑結構，他們並不在profile里，所以不能通過profile來修改
build 里面的Extensions：
它們是一系列build過程中要使用的產品，他們會包含在running bulid‘s classpath里面。他們可以開啟extensions，也可以通過提供條件來激活plugins。簡單來講，extensions是在build過程被激活的產品
<extensions> <extension> <groupId>org.apache.maven.wagon</groupId> <artifactId>wagon-ftp</artifactId> <version>1.0-alpha-3</version> </extension> </extensions>
reporting設置:
reporting包含site生成階段的一些元素，某些maven plugin可以生成reports並且在reporting下配置。例如javadoc,maven site等，在reporting下配置的report plugin的方法與build幾乎一樣，最不同的是build的plugin goals在executions下設置，而reporting的configures goals在reporttest。
excludeDefaults:是否排除site generator默認產生的reports
outputDirectory，默認的dir變成:${basedir}/target/site
report sets:設置execution goals,相當於build里面的executions,不同的是不能夠bind a report to another phase,只能夠是site
<reporting> <plugins> <plugin> ... <reportSets> <reportSet> <id>sunlink</id> <reports> <report>javadoc</report> </reports> <inherited>true</inherited> <configuration> <links> <link>http://java.sun.com/j2se/1.5.0/docs/api/</link> </links> </configuration> </reportSet> </reportSets> </plugin> </plugins> </reporting>
reporting里面的厄reportSets和build里面的executions的作用都是控制pom的不同粒度去控制build的過程，我們不單要配置plugins，還要配置那些plugins單獨的goals。
更多項目信息:
name:項目除了artifactId外，可以定義多個名稱
description: 項目描述
url: 項目url
inceptionYear:創始年份
<licenses> <license> <name>Apache 2</name> <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url> <distribution>repo</distribution> <comments>A business-friendly OSS license</comments> </license> </licenses>
列出本工程直接的licenses，而不要列出dependencies的licenses
配置組織信息:
<organization> <name>Codehaus Mojo</name> <url>http://mojo.codehaus.org</url> </organization>
很多工程都受到某些組織運行，這里設置基本信息
配置開發者信息:
例如：一個開發者可以有多個roles，properties是
<developers> <developer> <id>eric</id> <name>Eric</name> <email>eredmond@codehaus.org</email> <url>http://eric.propellors.net</url> <organization>Codehaus</organization> <organizationUrl>http://mojo.codehaus.org</organizationUrl> <roles> <role>architect</role> <role>developer</role> </roles> <timezone>-6</timezone> <properties> <picUrl>http://tinyurl.com/prv4t</picUrl> </properties> </developer> </developers>
環境設置:
issueManagement:bug跟蹤管理系統,定義defect tracking system缺陷跟蹤系統，比如有（bugzilla,testtrack,clearquest等）.
例如:
<issueManagement> <system>Bugzilla</system> <url>http://127.0.0.1/bugzilla/</url> </issueManagement>
倉庫：
Repositories：pom里面的倉庫與setting.xml里的倉庫功能是一樣的。主要的區別在於，pom里的倉庫是個性化的。比如一家 大公司里的setting文件是公用 的，所有項目都用一個setting文件，但各個子項目卻會引用不同的第三方庫，所以就需要在pom里設置自己需要的倉庫地址。
repositories：要成為maven2的repository artifact，必須具有pom文件在$BASE_REPO/groupId/artifactId/version/artifactId-version.pom
BASE_REPO可以是本地，也可以是遠程的。repository元素就是聲明那些去查找的repositories
默認的central Maven repository在http://repo1.maven.org/maven2/
<repositories> <repository> <releases> <enabled>false</enabled> <updatePolicy>always</updatePolicy> <checksumPolicy>warn</checksumPolicy> </releases> <snapshots> <enabled>true</enabled> <updatePolicy>never</updatePolicy> <checksumPolicy>fail</checksumPolicy> </snapshots> <id>codehausSnapshots</id> <name>Codehaus Snapshots</name> <url>http://snapshots.maven.codehaus.org/maven2</url> <layout>default</layout> </repository> </repositories>
release和snapshots：是artifact的兩種policies，pom可以選擇那種政策有效。
enable：本別指定兩種類型是否可用，true or false
updatePolicy:說明更新發生的頻率always 或者 never 或者 daily（默認的）或者 interval:X（X是分鍾數）
checksumPolicy：當Maven的部署文件到倉庫中，它也部署了相應的校驗和文件。您可以選擇忽略，失敗，或缺少或不正確的校驗和警告。
layout：maven1.x與maven2有不同的layout，所以可以聲明為default或者是legacy（遺留方式maven1.x）。
插件倉庫：
pluginRepositories：與Repositories具有類似的結構，只是Repositories是dependencies的home，而這個是plugins 的home。
分發管理:
distributionManagement :管理distribution和supporting files。
downloadUrl：是其他項目為了抓取本項目的pom’s artifact而指定的url，就是說告訴pom upload的地址也就是別人可以下載的地址。
status： 這里的狀態不要受到我們的設置，maven會自動設置project的狀態，有效的值：none：沒有聲明狀態，pom默認的；converted：本 project是管理員從原先的maven版本convert到maven2的；partner：以前叫做synched，意思是與partner repository已經進行了同步；deployed：至今為止最經常的狀態，意思是制品是從maven2 instance部署的，人工在命令行deploy的就會得到這個；verified：本制品已經經過驗證，也就是已經定下來了最終版。
repository：聲明deploy過程中current project會如何變成repository，說明部署到repository的信息。
<repository> <uniqueVersion>false</uniqueVersion> <id>corp1</id> <name>Corporate Repository</name> <url>scp://repo1/maven2</url> <layout>default</layout> </repository> <snapshotRepository> <uniqueVersion>true</uniqueVersion> <id>propSnap</id> <name>Propellors Snapshots</name> <url>sftp://propellers.net/maven</url> <layout>legacy</layout> </snapshotRepository>
id, name:：唯一性的id，和可讀性的name
uniqueVersion：指定是否產生一個唯一性的version number還是使用address里的其中version部分。true or false
url：說明location和transport protocol
layout：default或者legacy
profiles:pom4.0的一個新特性就是具有根據environment來修改設置的能力
它包含可選的activation（profile的觸發器）和一系列的changes。例如test過程可能會指向不同的數據庫（相對最終的 deployment）或者不同的dependencies或者不同的repositories，並且是根據不同的JDK來改變的。那么結構如下：
<profiles> <profile> <id>test</id> <activation>...</activation> <build>...</build> <modules>...</modules> <repositories>...</repositories> <pluginRepositories>...</pluginRepositories> <dependencies>...</dependencies> <reporting>...</reporting> <dependencyManagement>...</dependencyManagement> <distributionManagement>...</distributionManagement> </profile> </profiles>
Activation：
觸發這個profile的條件配置如下例：（只需要其中一個成立就可以激活profile，如果第一個條件滿足了，那么后面就不會在進行匹配。
<profile> <id>test</id> <activation> <activeByDefault>false</activeByDefault> <jdk>1.5</jdk> <os> <name>Windows XP</name> <family>Windows</family> <arch>x86</arch> <version>5.1.2600</version> </os> <property> <name>mavenVersion</name> <value>2.0.3</value> </property> <file> <exists>${basedir}/file2.properties</exists> <missing>${basedir}/file1.properties</missing> </file> </activation>
激活profile的方法有多個：setting文件的activeProfile元素明確指定激活的profile的ID，在命令行上明確激活Profile用-P flag 參數
查看某個build會激活的profile列表可以用：mvn help:active-profiles
<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/> <!--被繼承的父項目的全球唯一標識符--> <groupId/> <!--被繼承的父項目的版本--> <version/> <!--父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認值是../pom.xml。Maven首先在構建當前項目的地方尋找父項目的pom，其次在文件系統的這個位置（relativePath位置），然后在本地倉庫，最后在遠程倉庫尋找父項目的pom。--> <relativePath/> </parent> <!--聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變，雖然如此，但它仍然是必不可少的，這是為了當Maven引入了新的特性或者其他模型變更的時候，確保穩定性。--> <modelVersion>4.0.0</modelVersion> <!--項目的全球唯一標識符，通常使用全限定的包名區分該項目和其他項目。並且構建時生成的路徑也是由此生成， 如com.mycompany.app生成的相對路徑為：/com/mycompany/app--> <groupId>asia.banseon</groupId> <!--構件的標識符，它和group ID一起唯一標識一個構件。換句話說，你不能有兩個不同的項目擁有同樣的artifact ID和groupID；在某個特定的group ID下，artifact ID也必須是唯一的。構件是項目產生的或使用的一個東西，Maven為項目產生的構件包括：JARs，源碼，二進制發布和WARs等。--> <artifactId>banseon-maven2</artifactId> <!--項目產生的構件類型，例如jar、war、ear、pom。插件可以創建他們自己的構件類型，所以前面列的不是全部構件類型--> <packaging>jar</packaging> <!--項目當前版本，格式為:主版本.次版本.增量版本-限定版本號--> <version>1.0-SNAPSHOT</version> <!--項目的名稱, Maven產生的文檔用--> <name>banseon-maven</name> <!--項目主頁的URL, Maven產生的文檔用--> <url>http://www.baidu.com/banseon</url> <!--項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時（例如，CDATA中的文本會被解析器忽略，就可以包含HTML標簽）， 不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面，你應該修改你自己的索引頁文件，而不是調整這里的文檔。--> <description>A maven project to study maven.</description> <!--描述了這個項目構建環境中的前提條件。--> <prerequisites> <!--構建該項目或使用該插件所需要的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/> <!--該項目使用的持續集成系統的URL（如果持續集成系統有web接口的話）。--> <url/> <!--構建完成時，需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件（錯誤，失敗，成功，警告）--> <notifiers> <!--配置一種方式，當構建中斷時，以該方式通知用戶/開發者--> <notifier> <!--傳送通知的途徑--> <type/> <!--發生錯誤時是否通知--> <sendOnError/> <!--構建失敗時是否通知--> <sendOnFailure/> <!--構建成功時是否通知--> <sendOnSuccess/> <!--發生警告時是否通知--> <sendOnWarning/> <!--不贊成使用。通知發送到哪里--> <address/> <!--擴展配置項--> <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/> <!--項目開發者在項目中扮演的角色，角色元素描述了各種角色--> <roles> <role>Project Manager</role> <role>Architect</role> </roles> <!--項目開發者所屬組織--> <organization>demo</organization> <!--項目開發者所屬組織的URL--> <organizationUrl>http://hi.baidu.com/banseon</organizationUrl> <!--項目開發者屬性，如即時消息如何處理等--> <properties> <dept>No</dept> </properties> <!--項目開發者所在時區， -11到12范圍內的整數。--> <timezone>-5</timezone> </developer> </developers> <!--項目的其他貢獻者列表--> <contributors> <!--項目的其他貢獻者。參見developers/developer元素--> <contributor> <name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><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/> <!--指向項目的可瀏覽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/> <!--該元素設置了項目腳本源碼目錄，該目錄和源碼目錄不同：絕大多數情況下，該目錄下的內容 會被拷貝到輸出目錄(因為腳本是被解釋的，而不是被編譯的)。--> <scriptSourceDirectory/> <!--該元素設置了項目單元測試使用的源碼目錄，當測試項目的時候，構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。--> <testSourceDirectory/> <!--被編譯過的應用程序class文件存放的目錄。--> <outputDirectory/> <!--被編譯過的測試class文件存放的目錄。--> <testOutputDirectory/> <!--使用來自該項目的一系列構建擴展--> <extensions> <!--描述使用到的構建擴展。--> <extension> <!--構建擴展的groupId--> <groupId/> <!--構建擴展的artifactId--> <artifactId/> <!--構建擴展的版本--> <version/> </extension> </extensions> <!--當項目沒有規定目標（Maven2 叫做階段）時的默認值--> <defaultGoal/> <!--這個元素描述了項目相關的所有資源路徑列表，例如和項目相關的屬性文件，這些資源被包含在最終的打包文件里。--> <resources> <!--這個元素描述了項目相關或測試相關的所有資源路徑--> <resource> <!--描述了資源的目標路徑。該路徑相對target/classes目錄（例如${project.build.outputDirectory}）。舉個例子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設置為org/apache/maven/messages。然而，如果你只是想把資源放到源碼目錄結構里，就不需要該配置。--> <targetPath/> <!--是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性，文件在filters元素里列出。--> <filtering/> <!--描述存放資源的目錄，該路徑相對POM路徑--> <directory/> <!--包含的模式列表，例如**/*.xml.--> <includes/> <!--排除的模式列表，例如**/*.xml--> <excludes/> </resource> </resources> <!--這個元素描述了單元測試相關的所有資源路徑，例如和單元測試相關的屬性文件。--> <testResources> <!--這個元素描述了測試相關的所有資源路徑，參見build/resources/resource元素的說明--> <testResource> <targetPath/><filtering/><directory/><includes/><excludes/> </testResource> </testResources> <!--構建產生的所有文件存放的目錄--> <directory/> <!--產生的構件的文件名，默認值是${artifactId}-${version}。--> <finalName/> <!--當filtering開關打開時，使用到的過濾器屬性文件列表--> <filters/> <!--子項目可以引用的默認插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置--> <pluginManagement> <!--使用的插件列表 。--> <plugins> <!--plugin元素包含描述插件所需要的信息。--> <plugin> <!--插件在倉庫里的group ID--> <groupId/> <!--插件在倉庫里的artifact ID--> <artifactId/> <!--被使用的插件的版本（或版本范圍）--> <version/> <!--是否從該插件下載Maven擴展（例如打包和類型處理器），由於性能原因，只有在真需要下載時，該元素才被設置成enabled。--> <extensions/> <!--在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。--> <executions> <!--execution元素包含了插件執行需要的信息--> <execution> <!--執行目標的標識符，用於標識構建過程中的目標，或者匹配繼承過程中需要合並的執行目標--> <id/> <!--綁定了目標的構建生命周期階段，如果省略，目標會被綁定到源數據里配置的默認階段--> <phase/> <!--配置的執行目標--> <goals/> <!--配置是否被傳播到子POM--> <inherited/> <!--作為DOM對象的配置--> <configuration/> </execution> </executions> <!--項目引入插件所需要的額外依賴--> <dependencies> <!--參見dependencies/dependency元素--> <dependency> ...... </dependency> </dependencies> <!--任何配置是否被傳播到子項目--> <inherited/> <!--作為DOM對象的配置--> <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> <!--在列的項目構建profile，如果被激活，會修改構建處理--> <profiles> <!--根據環境參數或命令行參數激活某個構建處理--> <profile> <!--構建配置的唯一標識符。即用於命令行激活，也用於在繼承時合並具有相同標識符的profile。--> <id/> <!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自於它 能夠在某些特定的環境中自動使用某些特定的值；這些環境通過activation元素指定。activation元素並不是激活profile的唯一方式。--> <activation> <!--profile默認是否激活的標志--> <activeByDefault/> <!--當匹配的jdk被檢測到，profile被激活。例如，1.4激活JDK1.4，1.4.0_2，而!1.4激活所有版本不是以1.4開頭的JDK。--> <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/><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> <!--模塊（有時稱作子項目） 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑--> <modules/> <!--發現依賴和擴展的遠程倉庫列表。--> <repositories> <!--參見repositories/repository元素--> <repository> <releases> <enabled/><updatePolicy/><checksumPolicy/> </releases> <snapshots> <enabled/><updatePolicy/><checksumPolicy/> </snapshots> <id/><name/><url/><layout/> </repository> </repositories> <!--發現插件的遠程倉庫列表，這些插件用於構建和報表--> <pluginRepositories> <!--包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素--> <pluginRepository> <releases> <enabled/><updatePolicy/><checksumPolicy/> </releases> <snapshots> <enabled/><updatePolicy/><checksumPolicy/> </snapshots> <id/><name/><url/><layout/> </pluginRepository> </pluginRepositories> <!--該元素描述了項目相關的所有依賴。 這些依賴組成了項目構建過程中的一個個環節。它們自動從項目定義的倉庫中下載。要獲取更多信息，請看項目依賴機制。--> <dependencies> <!--參見dependencies/dependency元素--> <dependency> ...... </dependency> </dependencies> <!--不贊成使用. 現在Maven忽略該元素.--> <reports/> <!--該元素包括使用報表插件產生報表的規范。當用戶執行“mvn site”，這些報表就會運行。 在頁面導航欄能看到所有報表的鏈接。參見reporting元素--> <reporting> ...... </reporting> <!--參見dependencyManagement元素--> <dependencyManagement> <dependencies> <!--參見dependencies/dependency元素--> <dependency> ...... </dependency> </dependencies> </dependencyManagement> <!--參見distributionManagement元素--> <distributionManagement> ...... </distributionManagement> <!--參見properties元素--> <properties/> </profile> </profiles> <!--模塊（有時稱作子項目） 被構建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑--> <modules/> <!--發現依賴和擴展的遠程倉庫列表。--> <repositories> <!--包含需要連接到遠程倉庫的信息--> <repository> <!--如何處理遠程倉庫里發布版本的下載--> <releases> <!--true或者false表示該倉庫是否為下載某種類型構件（發布版，快照版）開啟。 --> <enabled/> <!--該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。這里的選項是：always（一直），daily（默認，每日），interval：X（這里X是以分鍾為單位的時間間隔），或者never（從不）。--> <updatePolicy/> <!--當Maven驗證構件校驗文件失敗時該怎么做：ignore（忽略），fail（失敗），或者warn（警告）。--> <checksumPolicy/> </releases> <!--如何處理遠程倉庫里快照版本的下載。有了releases和snapshots這兩組配置，POM就可以在每個單獨的倉庫中，為每種類型的構件采取不同的策略。例如，可能有人會決定只為開發目的開啟對快照版本下載的支持。參見repositories/repository/releases元素--> <snapshots> <enabled/><updatePolicy/><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/> <!--報表插件在倉庫里的artifact ID--> <artifactId/> <!--被使用的報表插件的版本（或版本范圍）--> <version/> <!--任何配置是否被傳播到子項目--> <inherited/> <!--報表插件的配置--> <configuration/> <!--一組報表的多重規范，每個規范可能有不同的配置。一個規范（報表集）對應一個執行目標 。例如，有1，2，3，4，5，6，7，8，9個報表。1，2，5構成A報表集，對應一個執行目標。2，5，8構成B報表集，對應另一個執行目標--> <reportSets> <!--表示報表的一個集合，以及產生該集合的配置--> <reportSet> <!--報表集合的唯一標識符，POM繼承時用到--> <id/> <!--產生報表集合時，被使用的報表的配置--> <configuration/> <!--配置是否被繼承到子POMs--> <inherited/> <!--這個集合里使用到哪些報表--> <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/> </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/> </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/> <!--構件新的artifact ID--> <artifactId/> <!--構件新的版本號--> <version/> <!--顯示給用戶的，關於移動的額外信息，例如原因。--> <message/> </relocation> <!--給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素，因為這是工具自動更新的。有效的值有：none（默認），converted（倉庫管理員從Maven 1 POM轉換過來），partner（直接從伙伴Maven 2倉庫同步過來），deployed（從Maven 2實例部署），verified（被核實時正確的和最終的）。--> <status/> </distributionManagement> <!--以值替代名稱，Properties可以在整個POM中使用，也可以作為觸發條件（見settings.xml配置文件里activation元素的說明）。格式是<name>value</name>。--> <properties/> </project>