Maven-pom.xml詳解
(看的比較累，能夠直接看最後面有針對整個pom.xml的註解)java
pom的做用web
pom做爲項目對象模型。經過xml表示maven項目，使用pom.xml來實現。主要描述了項目：包括配置文件；開發者須要遵循的規則，缺陷管理系統，組織和licenses，項目的url，項目的依賴性，以及其餘全部的項目相關因素。spring
先看一個簡單的pom.xml數據庫
<project> <modelVersion>4.0.0</modelVersion> <!--上面4.0.0爲maven2.0必須是這樣寫，如今是maven2惟一支持的版本 。做爲根元素下的第一個子元素modelVersion指定了當前POM模型的版本，對於maven2及maven3來講，它只能是4.0.0。--> <!-- 基礎設置 --> <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包括了全部的項目信息apache
groupId:項目或者組織的惟一標誌，而且配置時生成路徑也是由今生成，如org.myproject.mojo生成的相對路徑爲：/org/myproject/mojo
artifactId:項目的通用名稱
version:項目的版本
packaging:打包機制，如pom,jar,maven-plugin,ejb,war,ear,rar,par
name:用戶描述項目的名稱，可有可無的東西，可選
url:應該是隻是寫明開發團隊的網站，可有可無，可選
其中groupId,artifactId,version,packaging這四項組成了項目的惟一座標。通常狀況下，前面三項就能夠組成項目的惟一座標了。windows
POM關係：主要爲依賴，繼承，合成api
依賴關係：服務器
<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支持不了這個包，那麼則有有三種 方法處理：app
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裏屬性介紹：maven
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
<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
pom.xml詳解
<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>
相關文章
- 1. systemd詳解詳解
- 2. CAN詳解--協議詳解
- 3. LinkedList詳解（源碼詳解）
- 4. RNN詳解及BPTT詳解
- 5. JSTL詳解 JSTL詳解
- 6. 【知識詳解】Https詳解
- 7. [Java] volatile 詳詳解！
- 8. 註解詳解
- 9. 詳解
- 10. Lucene索引詳解（IndexWriter詳解、Document詳解、索引更新）
- 更多相關文章...
- • 免費ARP詳解 - TCP/IP教程
- • *.hbm.xml映射文件詳解 - Hibernate教程
- • Flink 數據傳輸及反壓詳解
- • 爲了進字節跳動，我精選了29道Java經典算法題，帶詳細講解
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
歡迎關注本站公眾號,獲取更多信息
相關文章
- 1. systemd詳解詳解
- 2. CAN詳解--協議詳解
- 3. LinkedList詳解（源碼詳解）
- 4. RNN詳解及BPTT詳解
- 5. JSTL詳解 JSTL詳解
- 6. 【知識詳解】Https詳解
- 7. [Java] volatile 詳詳解！
- 8. 註解詳解
- 9. 詳解
- 10. Lucene索引詳解（IndexWriter詳解、Document詳解、索引更新）