maven的pom.xml文件配置詳解
setting.xml主要用于配置maven的運(yùn)行環(huán)境等一系列通用的屬性,是全局級(jí)別的配置文件才顿;而pom.xml主要描述了項(xiàng)目的maven坐標(biāo)莫湘,依賴(lài)關(guān)系,開(kāi)發(fā)者需要遵循的規(guī)則郑气,缺陷管理系統(tǒng)幅垮,組織和licenses,以及其他所有的項(xiàng)目相關(guān)因素,是項(xiàng)目級(jí)別的配置文件.
基礎(chǔ)配置
一個(gè)典型的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.0http://maven.apache.org/xsd/maven-4.0.0.xsd">
<!-- 模型版本喇肋。maven2.0必須是這樣寫(xiě),現(xiàn)在是maven2唯一支持的版本 -->
<modelVersion>4.0.0</modelVersion>
<!-- 公司或者組織的唯一標(biāo)志行冰,并且配置時(shí)生成的路徑也是由此生成呵萨, 如com.winner.trade奏属,maven會(huì)將該項(xiàng)目打成的jar包放本地路徑:/com/winner/trade -->
<groupId>com.winner.trade</groupId>
<!-- 本項(xiàng)目的唯一ID,一個(gè)groupId下面可能多個(gè)項(xiàng)目潮峦,就是靠artifactId來(lái)區(qū)分的 -->
<artifactId>trade-core</artifactId>
<!-- 本項(xiàng)目目前所處的版本號(hào) -->
<version>1.0.0-SNAPSHOT</version>
<!-- 打包的機(jī)制囱皿,如pom,jar, maven-plugin, ejb, war, ear, rar, par,默認(rèn)為jar -->
<packaging>jar</packaging>
<!-- 幫助定義構(gòu)件輸出的一些附屬構(gòu)件,附屬構(gòu)件與主構(gòu)件對(duì)應(yīng)忱嘹,有時(shí)候需要加上classifier才能唯一的確定該構(gòu)件 不能直接定義項(xiàng)目的classifer,因?yàn)楦綄贅?gòu)件不是項(xiàng)目直接默認(rèn)生成的铆帽,而是由附加的插件幫助生成的 -->
<classifier>...</classifier>
<!-- 定義本項(xiàng)目的依賴(lài)關(guān)系 -->
<dependencies>
<!-- 每個(gè)dependency都對(duì)應(yīng)這一個(gè)jar包 -->
<dependency>
<!--一般情況下,maven是通過(guò)groupId德谅、artifactId、version這三個(gè)元素值(俗稱(chēng)坐標(biāo))來(lái)檢索該構(gòu)件萨螺, 然后引入你的工程窄做。如果別人想引用你現(xiàn)在開(kāi)發(fā)的這個(gè)項(xiàng)目(前提是已開(kāi)發(fā)完畢并發(fā)布到了遠(yuǎn)程倉(cāng)庫(kù)),-->
<!--就需要在他的pom文件中新建一個(gè)dependency節(jié)點(diǎn)慰技,將本項(xiàng)目的groupId椭盏、artifactId、version寫(xiě)入吻商, maven就會(huì)把你上傳的jar包下載到他的本地 -->
<groupId>com.winner.trade</groupId>
<artifactId>trade-test</artifactId>
<version>1.0.0-SNAPSHOT</version>
<!-- maven認(rèn)為掏颊,程序?qū)ν獠康囊蕾?lài)會(huì)隨著程序的所處階段和應(yīng)用場(chǎng)景而變化,所以maven中的依賴(lài)關(guān)系有作用域(scope)的限制艾帐。 -->
<!--scope包含如下的取值:compile(編譯范圍)乌叶、provided(已提供范圍)、runtime(運(yùn)行時(shí)范圍)柒爸、test(測(cè)試范圍)准浴、system(系統(tǒng)范圍) -->
<scope>test</scope>
<!-- 設(shè)置指依賴(lài)是否可選,默認(rèn)為false,即子項(xiàng)目默認(rèn)都繼承:為true,則子項(xiàng)目必需顯示的引入捎稚,與dependencyManagement里定義的依賴(lài)類(lèi)似 -->
<optional>false</optional>
<!-- 屏蔽依賴(lài)關(guān)系乐横。 比如項(xiàng)目中使用的libA依賴(lài)某個(gè)庫(kù)的1.0版,libB依賴(lài)某個(gè)庫(kù)的2.0版今野,現(xiàn)在想統(tǒng)一使用2.0版葡公,就應(yīng)該屏蔽掉對(duì)1.0版的依賴(lài) -->
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
<!-- 為pom定義一些常量,在pom中的其它地方可以直接引用 使用方式 如下 :${file.encoding} -->
<properties>
<file.encoding>UTF-8</file.encoding>
<java.source.version>1.5</java.source.version>
<java.target.version>1.5</java.target.version>
</properties>
...
</project>
一般來(lái)說(shuō)条霜,上面的幾個(gè)配置項(xiàng)對(duì)任何項(xiàng)目都是必不可少的催什,定義了項(xiàng)目的基本屬性.
這里有必要對(duì)一個(gè)不太常用的屬性classifier做一下解釋?zhuān)驗(yàn)橛袝r(shí)候引用某個(gè)jar包,classifier不寫(xiě)的話會(huì)報(bào)錯(cuò)蛔外。
classifier元素用來(lái)幫助定義構(gòu)件輸出的一些附屬構(gòu)件蛆楞。附屬構(gòu)件與主構(gòu)件對(duì)應(yīng)溯乒,比如主構(gòu)件是 kimi-app-2.0.0.jar,該項(xiàng)目可能還會(huì)通過(guò)使用一些插件生成 如kimi-app-2.0.0-javadoc.jar (Java文檔)豹爹、 kimi-app-2.0.0-sources.jar(Java源代碼) 這樣兩個(gè)附屬構(gòu)件裆悄。這時(shí)候,javadoc臂聋、sources就是這兩個(gè)附屬構(gòu)件的classifier光稼,這樣附屬構(gòu)件也就擁有了自己唯一的坐標(biāo)。
classifier的用途在于:
- maven download javadoc / sources jar包的時(shí)候孩等,需要借助classifier指明要下載那個(gè)附屬構(gòu)件
- 引入依賴(lài)的時(shí)候艾君,有時(shí)候僅憑groupId、artifactId肄方、version無(wú)法唯一的確定某個(gè)構(gòu)件冰垄,需要借助classifier來(lái)進(jìn)一步明確目標(biāo)。比如JSON-lib权她,有時(shí)候會(huì)同一個(gè)版本會(huì)提供多個(gè)jar包虹茶,在JDK1.5環(huán)境下是一套,在JDK1.3環(huán)境下是一套:
引用它的時(shí)候就要注明JDK版本隅要,否則maven不知道你到底需要哪一套jar包:
<dependency>
<groupId>net.sf.json-lib</groupId>
<artifactId>json-lib</artifactId>
<version>2.4</version>
<classifier>jdk15</classifier>
</dependency>
構(gòu)建配置
<build>
<!-- 產(chǎn)生的構(gòu)件的文件名蝴罪,默認(rèn)值是${artifactId}-${version}。 -->
<finalName>myPorjectName</finalName>
<!-- 構(gòu)建產(chǎn)生的所有文件存放的目錄,默認(rèn)為${basedir}/target步清,即項(xiàng)目根目錄下的target -->
<directory>${basedir}/target</directory>
<!--當(dāng)項(xiàng)目沒(méi)有規(guī)定目標(biāo)(Maven2叫做階段(phase))時(shí)的默認(rèn)值要门, -->
<!--必須跟命令行上的參數(shù)相同例如jar:jar,或者與某個(gè)階段(phase)相同例如install廓啊、compile等 -->
<defaultGoal>install</defaultGoal>
<!--當(dāng)filtering開(kāi)關(guān)打開(kāi)時(shí)欢搜,使用到的過(guò)濾器屬性文件列表。 -->
<!--項(xiàng)目配置信息中諸如${spring.version}之類(lèi)的占位符會(huì)被屬性文件中的實(shí)際值替換掉 -->
<filters>
<filter>../filter.properties</filter>
</filters>
<!--項(xiàng)目相關(guān)的所有資源路徑列表崖瞭,例如和項(xiàng)目相關(guān)的配置文件狂巢、屬性文件书聚,這些資源被包含在最終的打包文件里唧领。 -->
<resources>
<resource>
<!--描述了資源的目標(biāo)路徑。該路徑相對(duì)target/classes目錄(例如${project.build.outputDirectory})雌续。 -->
<!--舉個(gè)例子斩个,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設(shè)置為org/apache/maven/messages驯杜。 -->
<!--然而受啥,如果你只是想把資源放到源碼目錄結(jié)構(gòu)里,就不需要該配置。 -->
<targetPath>resources</targetPath>
<!--是否使用參數(shù)值代替參數(shù)名滚局。參數(shù)值取自properties元素或者文件里配置的屬性居暖,文件在filters元素里列出。 -->
<filtering>true</filtering>
<!--描述存放資源的目錄藤肢,該路徑相對(duì)POM路徑 -->
<directory>src/main/resources</directory>
<!--包含的模式列表 -->
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<!--排除的模式列表 如果<include>與<exclude>劃定的范圍存在沖突太闺,以<exclude>為準(zhǔn) -->
<excludes>
<exclude>jdbc.properties</exclude>
</excludes>
</resource>
</resources>
<!--單元測(cè)試相關(guān)的所有資源路徑,配制方法與resources類(lèi)似 -->
<testResources>
<testResource>
<targetPath />
<filtering />
<directory />
<includes />
<excludes />
</testResource>
</testResources>
<!--項(xiàng)目源碼目錄嘁圈,當(dāng)構(gòu)建項(xiàng)目的時(shí)候省骂,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。該路徑是相對(duì)于pom.xml的相對(duì)路徑最住。 -->
<sourceDirectory>${basedir}\src\main\java</sourceDirectory>
<!--項(xiàng)目腳本源碼目錄钞澳,該目錄和源碼目錄不同, <!-- 絕大多數(shù)情況下涨缚,該目錄下的內(nèi)容會(huì)被拷貝到輸出目錄(因?yàn)槟_本是被解釋的轧粟,而不是被編譯的)。 -->
<scriptSourceDirectory>${basedir}\src\main\scripts
</scriptSourceDirectory>
<!--項(xiàng)目單元測(cè)試使用的源碼目錄脓魏,當(dāng)測(cè)試項(xiàng)目的時(shí)候逃延,構(gòu)建系統(tǒng)會(huì)編譯目錄里的源碼。該路徑是相對(duì)于pom.xml的相對(duì)路徑轧拄。 -->
<testSourceDirectory>${basedir}\src\test\java</testSourceDirectory>
<!--被編譯過(guò)的應(yīng)用程序class文件存放的目錄。 -->
<outputDirectory>${basedir}\target\classes</outputDirectory>
<!--被編譯過(guò)的測(cè)試class文件存放的目錄讽膏。 -->
<testOutputDirectory>${basedir}\target\test-classes
</testOutputDirectory>
<!--項(xiàng)目的一系列構(gòu)建擴(kuò)展,它們是一系列build過(guò)程中要使用的產(chǎn)品檩电,會(huì)包含在running bulid‘s classpath里面。 -->
<!--他們可以開(kāi)啟extensions府树,也可以通過(guò)提供條件來(lái)激活plugins俐末。 -->
<!--簡(jiǎn)單來(lái)講,extensions是在build過(guò)程被激活的產(chǎn)品 -->
<extensions>
<!--例如奄侠,通常情況下卓箫,程序開(kāi)發(fā)完成后部署到線上Linux服務(wù)器,可能需要經(jīng)歷打包垄潮、 -->
<!--將包文件傳到服務(wù)器烹卒、SSH連上服務(wù)器、敲命令啟動(dòng)程序等一系列繁瑣的步驟弯洗。 -->
<!--實(shí)際上這些步驟都可以通過(guò)Maven的一個(gè)插件 wagon-maven-plugin 來(lái)自動(dòng)完成 -->
<!--下面的擴(kuò)展插件wagon-ssh用于通過(guò)SSH的方式連接遠(yuǎn)程服務(wù)器旅急, -->
<!--類(lèi)似的還有支持ftp方式的wagon-ftp插件 -->
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ssh</artifactId>
<version>2.8</version>
</extension>
</extensions>
<!--使用的插件列表 。 -->
<plugins>
<plugin>
<groupId></groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.5.5</version>
<!--在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置牡整。每個(gè)目標(biāo)可能有不同的配置藐吮。 -->
<executions>
<execution>
<!--執(zhí)行目標(biāo)的標(biāo)識(shí)符,用于標(biāo)識(shí)構(gòu)建過(guò)程中的目標(biāo),或者匹配繼承過(guò)程中需要合并的執(zhí)行目標(biāo) -->
<id>assembly</id>
<!--綁定了目標(biāo)的構(gòu)建生命周期階段谣辞,如果省略迫摔,目標(biāo)會(huì)被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase>package</phase>
<!--配置的執(zhí)行目標(biāo) -->
<goals>
<goal>single</goal>
</goals>
<!--配置是否被傳播到子POM -->
<inherited>false</inherited>
</execution>
</executions>
<!--作為DOM對(duì)象的配置,配置項(xiàng)因插件而異 -->
<configuration>
<finalName>${finalName}</finalName>
<appendAssemblyId>false</appendAssemblyId>
<descriptor>assembly.xml</descriptor>
</configuration>
<!--是否從該插件下載Maven擴(kuò)展(例如打包和類(lèi)型處理器), -->
<!--由于性能原因泥从,只有在真需要下載時(shí)句占,該元素才被設(shè)置成true。 -->
<extensions>false</extensions>
<!--項(xiàng)目引入插件所需要的額外依賴(lài) -->
<dependencies>
<dependency>...</dependency>
</dependencies>
<!--任何配置是否被傳播到子項(xiàng)目 -->
<inherited>true</inherited>
</plugin>
</plugins>
<!--主要定義插件的共同元素歉闰、擴(kuò)展元素集合辖众,類(lèi)似于dependencyManagement, -->
<!--所有繼承于此項(xiàng)目的子項(xiàng)目都能使用和敬。該插件配置項(xiàng)直到被引用時(shí)才會(huì)被解析或綁定到生命周期凹炸。 -->
<!--給定插件的任何本地配置都會(huì)覆蓋這里的配置 -->
<pluginManagement>
<plugins>...</plugins>
</pluginManagement>
</build>
pom里面的倉(cāng)庫(kù)與setting.xml里的倉(cāng)庫(kù)功能是一樣的。主要的區(qū)別在于昼弟,pom里的倉(cāng)庫(kù)是個(gè)性化的啤它。比如一家大公司里的setting文件是公用的,所有項(xiàng)目都用一個(gè)setting文件舱痘,但各個(gè)子項(xiàng)目卻會(huì)引用不同的第三方庫(kù)变骡,所以就需要在pom里設(shè)置自己需要的倉(cāng)庫(kù)地址。
分發(fā)配置
<!--項(xiàng)目分發(fā)信息芭逝,在執(zhí)行mvn deploy后表示要發(fā)布的位置塌碌。 -->
<!--有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者把構(gòu)件部署到遠(yuǎn)程倉(cāng)庫(kù)。 -->
<distributionManagement>
<!--部署項(xiàng)目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉(cāng)庫(kù)需要的信息 -->
<repository>
<!--是分配給快照一個(gè)唯一的版本號(hào)(由時(shí)間戳和構(gòu)建流水號(hào))旬盯,還是每次都使用相同的版本號(hào) -->
<!--參見(jiàn)repositories/repository元素 -->
<uniqueVersion>true</uniqueVersion>
<id> repo-id </id>
<name> repo-name</name>
<url>file://${basedir}/target/deploy </url>
<layout />
</repository>
<!--構(gòu)件的快照部署到哪里,如果沒(méi)有配置該元素台妆,默認(rèn)部署到repository元素配置的倉(cāng)庫(kù) -->
<snapshotRepository>
<uniqueVersion />
<id />
<name />
<url />
<layout />
</snapshotRepository>
<!--部署項(xiàng)目的網(wǎng)站需要的信息 -->
<site>
<!--部署位置的唯一標(biāo)識(shí)符,用來(lái)匹配站點(diǎn)和settings.xml文件里的配置 -->
<id> site-id </id>
<!--部署位置的名稱(chēng) -->
<name> site-name</name>
<!--部署位置的URL胖翰,按protocol://hostname/path形式 -->
<url>scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web </url>
</site>
<!--項(xiàng)目下載頁(yè)面的URL接剩。如果沒(méi)有該元素,用戶(hù)應(yīng)該參考主頁(yè)萨咳。 -->
<!--使用該元素的原因是:幫助定位那些不在倉(cāng)庫(kù)里的構(gòu)件(由于license限制)懊缺。 -->
<downloadUrl />
<!--如果構(gòu)件有了新的groupID和artifact ID(構(gòu)件移到了新的位置),這里列出構(gòu)件的重定位信息培他。 -->
<relocation>
<!--構(gòu)件新的group ID -->
<groupId />
<!--構(gòu)件新的artifact ID -->
<artifactId />
<!--構(gòu)件新的版本號(hào) -->
<version />
<!--顯示給用戶(hù)的鹃两,關(guān)于移動(dòng)的額外信息,例如原因舀凛。 -->
<message />
</relocation>
<!--給出該構(gòu)件在遠(yuǎn)程倉(cāng)庫(kù)的狀態(tài)怔毛。不得在本地項(xiàng)目中設(shè)置該元素,因?yàn)檫@是工具自動(dòng)更新的腾降。 -->
<!--有效的值有:none(默認(rèn))拣度,converted(倉(cāng)庫(kù)管理員從Maven 1 POM轉(zhuǎn)換過(guò)來(lái)), -->
<!--partner(直接從伙伴Maven 2倉(cāng)庫(kù)同步過(guò)來(lái)),deployed(從Maven 2實(shí)例部署)抗果,verified(被核實(shí)時(shí)正確的和最終的)筋帖。 -->
<status />
</distributionManagement>
倉(cāng)庫(kù)配置
<!--發(fā)現(xiàn)依賴(lài)和擴(kuò)展的遠(yuǎn)程倉(cāng)庫(kù)列表。 -->
<repositories>
<!--包含需要連接到遠(yuǎn)程倉(cāng)庫(kù)的信息 -->
<repository>
<!--如何處理遠(yuǎn)程倉(cāng)庫(kù)里發(fā)布版本的下載 -->
<releases>
<!--true或者false表示該倉(cāng)庫(kù)是否為下載某種類(lèi)型構(gòu)件(發(fā)布版冤馏,快照版)開(kāi)啟日麸。 -->
<enabled />
<!--該元素指定更新發(fā)生的頻率。Maven會(huì)比較本地POM和遠(yuǎn)程POM的時(shí)間戳逮光。 -->
<!--這里的選項(xiàng)是:always(一直)代箭,daily(默認(rèn),每日)涕刚, -->
<!--interval:X(這里X是以分鐘為單位的時(shí)間間隔)嗡综,或者never(從不)。 -->
<updatePolicy />
<!--當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時(shí)該怎么做: -->
<!--ignore(忽略)杜漠,fail(失敿啊),或者warn(警告)驾茴。 -->
<checksumPolicy />
</releases>
<!--如何處理遠(yuǎn)程倉(cāng)庫(kù)里快照版本的下載盼樟。有了releases和snapshots這兩組配置, -->
<!--POM就可以在每個(gè)單獨(dú)的倉(cāng)庫(kù)中锈至,為每種類(lèi)型的構(gòu)件采取不同的策略晨缴。 -->
<!--例如,可能有人會(huì)決定只為開(kāi)發(fā)目的開(kāi)啟對(duì)快照版本下載的支持 -->
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<!--遠(yuǎn)程倉(cāng)庫(kù)唯一標(biāo)識(shí)符峡捡∠才樱可以用來(lái)匹配在settings.xml文件里配置的遠(yuǎn)程倉(cāng)庫(kù) -->
<id> repo-id </id>
<!--遠(yuǎn)程倉(cāng)庫(kù)名稱(chēng) -->
<name> repo-name</name>
<!--遠(yuǎn)程倉(cāng)庫(kù)URL,按protocol://hostname/path形式 -->
<url>http://192.168.1.169:9999/repository/ </url>
<!--用于定位和排序構(gòu)件的倉(cāng)庫(kù)布局類(lèi)型-可以是default(默認(rèn))或者legacy(遺留)棋返。 -->
<!--Maven 2為其倉(cāng)庫(kù)提供了一個(gè)默認(rèn)的布局; -->
<!--然而雷猪,Maven1.x有一種不同的布局睛竣。 -->
<!--我們可以使用該元素指定布局是default(默認(rèn))還是legacy(遺留)。 -->
<layout> default</layout>
</repository>
</repositories>
<!--發(fā)現(xiàn)插件的遠(yuǎn)程倉(cāng)庫(kù)列表求摇,這些插件用于構(gòu)建和報(bào)表 -->
<pluginRepositories>
<!--包含需要連接到遠(yuǎn)程插件倉(cāng)庫(kù)的信息.參見(jiàn)repositories/repository元素 -->
<pluginRepository />
</pluginRepositories>
profile配置
<!--在列的項(xiàng)目構(gòu)建profile射沟,如果被激活,會(huì)修改構(gòu)建處理 -->
<profiles>
<!--根據(jù)環(huán)境參數(shù)或命令行參數(shù)激活某個(gè)構(gòu)建處理 -->
<profile>
<!--自動(dòng)觸發(fā)profile的條件邏輯与境。Activation是profile的開(kāi)啟鑰匙验夯。 -->
<activation>
<!--profile默認(rèn)是否激活的標(biāo)識(shí) -->
<activeByDefault>false</activeByDefault>
<!--activation有一個(gè)內(nèi)建的java版本檢測(cè),如果檢測(cè)到j(luò)dk版本與期待的一樣摔刁,profile被激活挥转。 -->
<jdk>1.7</jdk>
<!--當(dāng)匹配的操作系統(tǒng)屬性被檢測(cè)到,profile被激活。os元素可以定義一些操作系統(tǒng)相關(guān)的屬性绑谣。 -->
<os>
<!--激活profile的操作系統(tǒng)的名字 -->
<name>Windows XP</name>
<!--激活profile的操作系統(tǒng)所屬家族(如 'windows') -->
<family>Windows</family>
<!--激活profile的操作系統(tǒng)體系結(jié)構(gòu) -->
<arch>x86</arch>
<!--激活profile的操作系統(tǒng)版本 -->
<version>5.1.2600</version>
</os>
<!--如果Maven檢測(cè)到某一個(gè)屬性(其值可以在POM中通過(guò)${名稱(chēng)}引用)党窜,其擁有對(duì)應(yīng)的名稱(chēng)和值,Profile就會(huì)被激活借宵。 -->
<!-- 如果值字段是空的幌衣,那么存在屬性名稱(chēng)字段就會(huì)激活profile,否則按區(qū)分大小寫(xiě)方式匹配屬性值字段 -->
<property>
<!--激活profile的屬性的名稱(chēng) -->
<name>mavenVersion</name>
<!--激活profile的屬性的值 -->
<value>2.0.3</value>
</property>
<!--提供一個(gè)文件名壤玫,通過(guò)檢測(cè)該文件的存在或不存在來(lái)激活profile豁护。missing檢查文件是否存在,如果不存在則激活profile欲间。 -->
<!--另一方面楚里,exists則會(huì)檢查文件是否存在,如果存在則激活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>
<id />
<build />
<modules />
<repositories />
<pluginRepositories />
<dependencies />
<reporting />
<dependencyManagement />
<distributionManagement />
<properties />
</profile>
profile配置項(xiàng)在setting.xml中也有,是pom.xml中profile元素的裁剪版本惹骂,包含了id苏携,activation, repositories, pluginRepositories和 properties元素。這里的profile元素只包含這五個(gè)子元素是因?yàn)閟etting.xml只關(guān)心構(gòu)建系統(tǒng)這個(gè)整體(這正是settings.xml文件的角色定位)对粪,而非單獨(dú)的項(xiàng)目對(duì)象模型設(shè)置右冻。如果一個(gè)settings中的profile被激活,它的值會(huì)覆蓋任何其它定義在POM中或者profile.xml中的帶有相同id的profile著拭。
pom.xml中的profile可以看做pom.xml的副本誉碴,擁有與pom.xml相同的子元素與配置方法绳军。它包含可選的activation(profile的觸發(fā)器)和一系列的changes。例如test過(guò)程可能會(huì)指向不同的數(shù)據(jù)庫(kù)(相對(duì)最終的deployment)或者不同的dependencies或者不同的repositories,并且是根據(jù)不同的JDK來(lái)改變的思瘟。只需要其中一個(gè)成立就可以激活profile晌纫,如果第一個(gè)條件滿(mǎn)足了傅物,那么后面就不會(huì)在進(jìn)行匹配怖现。
報(bào)表配置
<!--描述使用報(bào)表插件產(chǎn)生報(bào)表的規(guī)范,特定的maven 插件能輸出相應(yīng)的定制和配置報(bào)表. -->
<!--當(dāng)用戶(hù)執(zhí)行“mvn site”,這些報(bào)表就會(huì)運(yùn)行,在頁(yè)面導(dǎo)航欄能看到所有報(bào)表的鏈接十嘿。 -->
<reporting>
<!--true因惭,則網(wǎng)站不包括默認(rèn)的報(bào)表。這包括“項(xiàng)目信息”菜單中的報(bào)表绩衷。 -->
<excludeDefaults />
<!--所有產(chǎn)生的報(bào)表存放到哪里蹦魔。默認(rèn)值是${project.build.directory}/site激率。 -->
<outputDirectory />
<!--使用的報(bào)表插件和他們的配置。 -->
<plugins>
<plugin>
<groupId />
<artifactId />
<version />
<inherited />
<configuration>
<links>
<link>http://java.sun.com/j2se/1.5.0/docs/api/</link>
</links>
</configuration>
<!--一組報(bào)表的多重規(guī)范版姑,每個(gè)規(guī)范可能有不同的配置柱搜。 -->
<!--一個(gè)規(guī)范(報(bào)表集)對(duì)應(yīng)一個(gè)執(zhí)行目標(biāo) 。例如剥险,有1聪蘸,2,3表制,4健爬,5么介,6,7壤短,8,9個(gè)報(bào)表久脯。 -->
<!--1,2帘撰,5構(gòu)成A報(bào)表集,對(duì)應(yīng)一個(gè)執(zhí)行目標(biāo)摧找。2核行,5蹬耘,8構(gòu)成B報(bào)表集,對(duì)應(yīng)另一個(gè)執(zhí)行目標(biāo) -->
<reportSets>
<!--表示報(bào)表的一個(gè)集合惩系,以及產(chǎn)生該集合的配置 -->
<reportSet>
<!--報(bào)表集合的唯一標(biāo)識(shí)符休里,POM繼承時(shí)用到 -->
<id>sunlink</id>
<!--產(chǎn)生報(bào)表集合時(shí)赃承,被使用的報(bào)表的配置 -->
<configuration />
<!--配置是否被繼承到子POMs -->
<inherited />
<!--這個(gè)集合里使用到哪些報(bào)表 -->
<reports>
<report>javadoc</report>
</reports>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
環(huán)境配置
<!--項(xiàng)目的問(wèn)題管理系統(tǒng)(Bugzilla, Jira, Scarab,或任何你喜歡的問(wèn)題管理系統(tǒng))的名稱(chēng)和URL,本例為 jira -->
<issueManagement>
<!--問(wèn)題管理系統(tǒng)(例如jira)的名字拭嫁, -->
<system> jira </system>
<!--該項(xiàng)目使用的問(wèn)題管理系統(tǒng)的URL -->
<url> http://jira.clf.com/</url>
</issueManagement>
<!--項(xiàng)目持續(xù)集成信息 -->
<ciManagement>
<!--持續(xù)集成系統(tǒng)的名字做粤,例如continuum -->
<system />
<!--該項(xiàng)目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)。 -->
<url />
<!--構(gòu)建完成時(shí)怕品,需要通知的開(kāi)發(fā)者/用戶(hù)的配置項(xiàng)肉康。包括被通知者信息和通知條件(錯(cuò)誤,失敗涨薪,成功炫乓,警告) -->
<notifiers>
<!--配置一種方式,當(dāng)構(gòu)建中斷時(shí)侠姑,以該方式通知用戶(hù)/開(kāi)發(fā)者 -->
<notifier>
<!--傳送通知的途徑 -->
<type />
<!--發(fā)生錯(cuò)誤時(shí)是否通知 -->
<sendOnError />
<!--構(gòu)建失敗時(shí)是否通知 -->
<sendOnFailure />
<!--構(gòu)建成功時(shí)是否通知 -->
<sendOnSuccess />
<!--發(fā)生警告時(shí)是否通知 -->
<sendOnWarning />
<!--不贊成使用塔粒。通知發(fā)送到哪里 -->
<address />
<!--擴(kuò)展配置項(xiàng) -->
<configuration />
</notifier>
</notifiers>
</ciManagement>
項(xiàng)目信息配置
<!--項(xiàng)目的名稱(chēng), Maven產(chǎn)生的文檔用 -->
<name>banseon-maven </name>
<!--項(xiàng)目主頁(yè)的URL, Maven產(chǎn)生的文檔用 -->
<url>http://www.clf.com/ </url>
<!--項(xiàng)目的詳細(xì)描述, Maven 產(chǎn)生的文檔用卒茬。 當(dāng)這個(gè)元素能夠用HTML格式描述時(shí) -->
<!--(例如,CDATA中的文本會(huì)被解析器忽略柳畔,就可以包含HTML標(biāo)簽)郭赐,不鼓勵(lì)使用純文本描述。 -->
<!-- 如果你需要修改產(chǎn)生的web站點(diǎn)的索引頁(yè)面俘陷,你應(yīng)該修改你自己的索引頁(yè)文件,而不是調(diào)整這里的文檔拉盾。 -->
<description>A maven project to study maven. </description>
<!--描述了這個(gè)項(xiàng)目構(gòu)建環(huán)境中的前提條件豁状。 -->
<prerequisites>
<!--構(gòu)建該項(xiàng)目或使用該插件所需要的Maven的最低版本 -->
<maven />
</prerequisites>
<!--項(xiàng)目創(chuàng)建年份,4位數(shù)字夭禽。當(dāng)產(chǎn)生版權(quán)信息時(shí)需要使用這個(gè)值讹躯。 -->
<inceptionYear />
<!--項(xiàng)目相關(guān)郵件列表信息 -->
<mailingLists>
<!--該元素描述了項(xiàng)目相關(guān)的所有郵件列表。自動(dòng)產(chǎn)生的網(wǎng)站引用這些信息挤巡。 -->
<mailingList>
<!--郵件的名稱(chēng) -->
<name> Demo </name>
<!--發(fā)送郵件的地址或鏈接酷麦,如果是郵件地址,創(chuàng)建文檔時(shí)母廷,mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<post> clf@126.com</post>
<!--訂閱郵件的地址或鏈接糊肤,如果是郵件地址馆揉,創(chuàng)建文檔時(shí),mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<subscribe> clf@126.com</subscribe>
<!--取消訂閱郵件的地址或鏈接舷暮,如果是郵件地址噩茄,創(chuàng)建文檔時(shí),mailto: 鏈接會(huì)被自動(dòng)創(chuàng)建 -->
<unsubscribe> clf@126.com</unsubscribe>
<!--你可以瀏覽郵件信息的URL -->
<archive> http:/hi.clf.com/</archive>
</mailingList>
</mailingLists>
<!--項(xiàng)目開(kāi)發(fā)者列表 -->
<developers>
<!--某個(gè)項(xiàng)目開(kāi)發(fā)者的信息 -->
<developer>
<!--SCM里項(xiàng)目開(kāi)發(fā)者的唯一標(biāo)識(shí)符 -->
<id> HELLO WORLD </id>
<!--項(xiàng)目開(kāi)發(fā)者的全名 -->
<name> banseon </name>
<!--項(xiàng)目開(kāi)發(fā)者的email -->
<email> banseon@126.com</email>
<!--項(xiàng)目開(kāi)發(fā)者的主頁(yè)的URL -->
<url />
<!--項(xiàng)目開(kāi)發(fā)者在項(xiàng)目中扮演的角色沥割,角色元素描述了各種角色 -->
<roles>
<role> Project Manager</role>
<role>Architect </role>
</roles>
<!--項(xiàng)目開(kāi)發(fā)者所屬組織 -->
<organization> demo</organization>
<!--項(xiàng)目開(kāi)發(fā)者所屬組織的URL -->
<organizationUrl>http://hi.clf.com/ </organizationUrl>
<!--項(xiàng)目開(kāi)發(fā)者屬性机杜,如即時(shí)消息如何處理等 -->
<properties>
<dept> No </dept>
</properties>
<!--項(xiàng)目開(kāi)發(fā)者所在時(shí)區(qū)衅谷, -11到12范圍內(nèi)的整數(shù)会喝。 -->
<timezone> -5</timezone>
</developer>
</developers>
<!--項(xiàng)目的其他貢獻(xiàn)者列表 -->
<contributors>
<!--項(xiàng)目的其他貢獻(xiàn)者。參見(jiàn)developers/developer元素 -->
<contributor>
<name />
<email />
<url />
<organization />
<organizationUrl />
<roles />
<timezone />
<properties />
</contributor>
</contributors>
<!--該元素描述了項(xiàng)目所有License列表枉阵。應(yīng)該只列出該項(xiàng)目的license列表预茄,不要列出依賴(lài)項(xiàng)目的license列表。 -->
<!--如果列出多個(gè)license拙徽,用戶(hù)可以選擇它們中的一個(gè)而不是接受所有l(wèi)icense诗宣。 -->
<licenses>
<!--描述了項(xiàng)目的license召庞,用于生成項(xiàng)目的web站點(diǎn)的license頁(yè)面,其他一些報(bào)表和validation也會(huì)用到該元素忘古。 -->
<license>
<!--license用于法律上的名稱(chēng) -->
<name> Apache 2 </name>
<!--官方的license正文頁(yè)面的URL -->
<url>http://www.clf.com/LICENSE-2.0.txt </url>
<!--項(xiàng)目分發(fā)的主要方式: repo诅诱,可以從Maven庫(kù)下載 manual娘荡, 用戶(hù)必須手動(dòng)下載和安裝依賴(lài) -->
<distribution> repo</distribution>
<!--關(guān)于license的補(bǔ)充信息 -->
<comments> Abusiness-friendly OSS license </comments>
</license>
</licenses>
<!--SCM(Source Control Management)標(biāo)簽允許你配置你的代碼庫(kù),供Maven web站點(diǎn)和其它插件使用疤孕。 -->
<scm>
<!--SCM的URL,該URL描述了版本庫(kù)和如何連接到版本庫(kù)央拖。欲知詳情,請(qǐng)看SCMs提供的URL格式和列表专控。該連接只讀遏餐。 -->
<connection>scm:svn:http://svn.baidu.com/banseon/maven/</connection>
<!--給開(kāi)發(fā)者使用的失都,類(lèi)似connection元素幸冻。即該連接不僅僅只讀 -->
<developerConnection>scm:svn:http://svn.baidu.com/banseon/maven/
</developerConnection>
<!--當(dāng)前代碼的標(biāo)簽洽损,在開(kāi)發(fā)階段默認(rèn)為HEAD -->
<tag />
<!--指向項(xiàng)目的可瀏覽SCM庫(kù)(例如ViewVC或者Fisheye)的URL革半。 -->
<url> http://svn.baidu.com/banseon</url>
</scm>
<!--描述項(xiàng)目所屬組織的各種屬性。Maven產(chǎn)生的文檔用 -->
<organization>
<!--組織的全名 -->
<name> demo </name>
<!--組織主頁(yè)的URL -->
<url> http://www.clf.com/</url>
</organization>