Maven中pom.xml配置文件詳細(xì)介紹
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à)會(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的用途在于:
1.mavendownloadjavadoc/sourcesjar包的時(shí)候,需要借助classifier指明要下載那個(gè)附屬構(gòu)件
2.引入依賴(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ā)完成后部署到線(xiàn)上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接口的話(huà))。 --> <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>
總結(jié)
以上就是本文關(guān)于Maven中pom.xml配置文件詳細(xì)介紹的全部?jī)?nèi)容,希望對(duì)大家有所幫助。感興趣的朋友可以繼續(xù)參閱本站其他相關(guān)專(zhuān)題,如有不足之處,歡迎留言指出。
相關(guān)文章
如何使用Spring Cloud Feign日志查看請(qǐng)求響應(yīng)
這篇文章主要介紹了如何使用Spring Cloud Feign日志查看請(qǐng)求響應(yīng),文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-02-02java設(shè)計(jì)模式之實(shí)現(xiàn)對(duì)象池模式示例分享
對(duì)象池模式經(jīng)常用在頻繁創(chuàng)建、銷(xiāo)毀對(duì)象(并且對(duì)象創(chuàng)建、銷(xiāo)毀開(kāi)銷(xiāo)很大)的場(chǎng)景,比如數(shù)據(jù)庫(kù)連接池、線(xiàn)程池、任務(wù)隊(duì)列池等。本代碼簡(jiǎn)單,沒(méi)有限制對(duì)象池大小2014-02-02深入Java7的一些新特性以及對(duì)腳本語(yǔ)言支持API的介紹
本篇文章是對(duì)Java7的一些新特性以及對(duì)腳本語(yǔ)言支持API的概述,需要的朋友參考下2013-05-05Java后端對(duì)接微信支付(小程序、APP、PC端掃碼)包含查單退款
微信支付我們主要聚焦于這三種支付方式,其中JSPAI與APP主要與uniapp開(kāi)發(fā)微信小程序與APP對(duì)接,本文主要介紹了Java后端對(duì)接微信支付(小程序、APP、PC端掃碼)包含查單退款,具有一定的參考價(jià)值,感興趣的可以了解一下2021-12-12Java編程構(gòu)造方法與對(duì)象的創(chuàng)建詳解
這篇文章主要介紹了Java編程構(gòu)造方法與對(duì)象的創(chuàng)建詳解,具有一定參考價(jià)值,需要的朋友可以了解下。2017-11-11一文詳解如何通過(guò)Java實(shí)現(xiàn)SSL交互功能
這篇文章主要為大家詳細(xì)介紹了如何通過(guò)Java實(shí)現(xiàn)SSL交互功能,文中的示例代碼講解詳細(xì),對(duì)我們的學(xué)習(xí)或工作有一定的幫助,需要的可以參考一下2023-04-04SpringBoot解決循環(huán)調(diào)用問(wèn)題
作者在將SpringBoot從1.5版本升級(jí)至2.6版本,并遷移至阿里云上運(yùn)行后,遇到了循環(huán)調(diào)用問(wèn)題,在Jetty容器中運(yùn)行沒(méi)問(wèn)題,但在Tomcat容器中就出現(xiàn)了循環(huán)引用問(wèn)題,原因是SpringBoot 2.6不鼓勵(lì)循環(huán)引用,暴露出該問(wèn)題,作者提供了兩種解決思路2024-10-10