Maven之pom.xml配置文件詳解

原文:https://blog.csdn.net/u012152619/article/details/51485297

setting.xml主要用於配置maven的運行環境等一系列通用的屬性,是全局級別的配置文件;而pom.xml主要描述了項目的maven座標,依賴關係,開發者需要遵循的規則,缺陷管理系統,組織和licenses,以及其他所有的項目相關因素,是項目級別的配置文件。


基礎配置

一個典型的pom.xml文件配置如下:

  1. <project xmlns="http://maven.apache.org/POM/4.0.0"</span><span> </span><spanclass="attribute">xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"</span><span>  </span></span></li><liclass="">    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/xsd/maven-4.0.0.xsd"</span><span class="tag">>  
  2.   
  3.     <!-- 模型版本。maven2.0必須是這樣寫,現在是maven2唯一支持的版本 -->  
  4.     <modelVersion>4.0.0</modelVersion>  
  5.   
  6.     <!-- 公司或者組織的唯一標誌,並且配置時生成的路徑也是由此生成, 如com.winner.trade,maven會將該項目打成的jar包放本地路徑:/com/winner/trade -->  
  7.     <groupId>com.winner.trade</groupId>  
  8.   
  9.     <!-- 本項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區分的 -->  
  10.     <artifactId>trade-core</artifactId>  
  11.   
  12.     <!-- 本項目目前所處的版本號 -->  
  13.     <version>1.0.0-SNAPSHOT</version>  
  14.   
  15.     <!-- 打包的機制,如pom,jar, maven-plugin, ejb, war, ear, rar, par,默認爲jar -->  
  16.     <packaging>jar</packaging>  
  17.   
  18.     <!-- 幫助定義構件輸出的一些附屬構件,附屬構件與主構件對應,有時候需要加上classifier才能唯一的確定該構件 不能直接定義項目的classifer,因爲附屬構件不是項目直接默認生成的,而是由附加的插件幫助生成的 -->  
  19.     <classifier>...</classifier>  
  20.   
  21.     <!-- 定義本項目的依賴關係 -->  
  22.     <dependencies>  
  23.   
  24.         <!-- 每個dependency都對應這一個jar包 -->  
  25.         <dependency>  
  26.   
  27.             <!--一般情況下,maven是通過groupId、artifactId、version這三個元素值(俗稱座標)來檢索該構件, 然後引入你的工程。如果別人想引用你現在開發的這個項目(前提是已開發完畢併發布到了遠程倉庫),-->   
  28.             <!--就需要在他的pom文件中新建一個dependency節點,將本項目的groupId、artifactId、version寫入, maven就會把你上傳的jar包下載到他的本地 -->  
  29.             <groupId>com.winner.trade</groupId>  
  30.             <artifactId>trade-test</artifactId>  
  31.             <version>1.0.0-SNAPSHOT</version>  
  32.   
  33.             <!-- maven認爲,程序對外部的依賴會隨着程序的所處階段和應用場景而變化,所以maven中的依賴關係有作用域(scope)的限制。 -->  
  34.             <!--scope包含如下的取值:compile(編譯範圍)、provided(已提供範圍)、runtime(運行時範圍)、test(測試範圍)、system(系統範圍) -->  
  35.             <scope>test</scope>  
  36.   
  37.             <!-- 設置指依賴是否可選,默認爲false,即子項目默認都繼承:爲true,則子項目必需顯示的引入,與dependencyManagement裏定義的依賴類似  -->  
  38.             <optional>false</optional>  
  39.   
  40.             <!-- 屏蔽依賴關係。 比如項目中使用的libA依賴某個庫的1.0版,libB依賴某個庫的2.0版,現在想統一使用2.0版,就應該屏蔽掉對1.0版的依賴 -->  
  41.             <exclusions>  
  42.                 <exclusion>  
  43.                     <groupId>org.slf4j</groupId>  
  44.                     <artifactId>slf4j-api</artifactId>  
  45.                 </exclusion>  
  46.             </exclusions>  
  47.   
  48.         </dependency>  
  49.   
  50.     </dependencies>  
  51.   
  52.     <!-- 爲pom定義一些常量,在pom中的其它地方可以直接引用 使用方式 如下 :${file.encoding} -->  
  53.     <properties>  
  54.         <file.encoding>UTF-8</file.encoding>  
  55.         <java.source.version>1.5</java.source.version>  
  56.         <java.target.version>1.5</java.target.version>  
  57.     </properties>  
  58.   
  59.     ...  
  60. </project>  

一般來說,上面的幾個配置項對任何項目都是必不可少的,定義了項目的基本屬性。

這裏有必要對一個不太常用的屬性classifier做一下解釋,因爲有時候引用某個jar包,classifier不寫的話會報錯。

classifier元素用來幫助定義構件輸出的一些附屬構件。附屬構件與主構件對應,比如主構件是 kimi-app-2.0.0.jar,該項目可能還會通過使用一些插件生成 如kimi-app-2.0.0-javadoc.jar (Java文檔)、 kimi-app-2.0.0-sources.jar(Java源代碼) 這樣兩個附屬構件。這時候,javadoc、sources就是這兩個附屬構件的classifier,這樣附屬構件也就擁有了自己唯一的座標。

classifier的用途在於:

1. maven download  javadoc / sources jar包的時候,需要藉助classifier指明要下載那個附屬構件

2. 引入依賴的時候,有時候僅憑groupId、artifactId、version無法唯一的確定某個構件,需要藉助classifier來進一步明確目標。比如JSON-lib,有時候會同一個版本會提供多個jar包,在JDK1.5環境下是一套,在JDK1.3環境下是一套:


引用它的時候就要註明JDK版本,否則maven不知道你到底需要哪一套jar包:

  1. <dependency>  
  2.            <groupId>net.sf.json-lib</groupId>  
  3.            <artifactId>json-lib</artifactId>  
  4.             <version>2.4</version>  
  5.            <classifier>jdk15</classifier>  
  6. </dependency>  

 

構建配置

  1. <build>  
  2.   
  3.     <!-- 產生的構件的文件名,默認值是${artifactId}-${version}。 -->  
  4.     <finalName>myPorjectName</finalName>  
  5.   
  6.     <!-- 構建產生的所有文件存放的目錄,默認爲${basedir}/target,即項目根目錄下的target -->  
  7.     <directory>${basedir}/target</directory>  
  8.   
  9.     <!--當項目沒有規定目標(Maven2叫做階段(phase))時的默認值, -->  
  10.     <!--必須跟命令行上的參數相同例如jar:jar,或者與某個階段(phase)相同例如install、compile等 -->  
  11.     <defaultGoal>install</defaultGoal>  
  12.   
  13.     <!--當filtering開關打開時,使用到的過濾器屬性文件列表。 -->  
  14.     <!--項目配置信息中諸如${spring.version}之類的佔位符會被屬性文件中的實際值替換掉 -->  
  15.     <filters>  
  16.         <filter>../filter.properties</filter>  
  17.     </filters>  
  18.   
  19.     <!--項目相關的所有資源路徑列表,例如和項目相關的配置文件、屬性文件,這些資源被包含在最終的打包文件裏。 -->  
  20.     <resources>  
  21.         <resource>  
  22.   
  23.             <!--描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。 -->  
  24.             <!--舉個例子,如果你想資源在特定的包裏(org.apache.maven.messages),你就必須該元素設置爲org/apache/maven/messages。 -->  
  25.             <!--然而,如果你只是想把資源放到源碼目錄結構裏,就不需要該配置。 -->  
  26.             <targetPath>resources</targetPath>  
  27.   
  28.             <!--是否使用參數值代替參數名。參數值取自properties元素或者文件裏配置的屬性,文件在filters元素裏列出。 -->  
  29.             <filtering>true</filtering>  
  30.   
  31.             <!--描述存放資源的目錄,該路徑相對POM路徑 -->  
  32.             <directory>src/main/resources</directory>  
  33.   
  34.             <!--包含的模式列表 -->  
  35.             <includes>  
  36.                 <include>/*.properties</include>  
  37.                 <include>/.xml</include>  
  38.             </includes>  
  39.   
  40.             <!--排除的模式列表 如果<include>與<exclude>劃定的範圍存在衝突,以<exclude>爲準 -->  
  41.             <excludes>  
  42.                 <exclude>jdbc.properties</exclude>  
  43.             </excludes>  
  44.   
  45.         </resource>  
  46.     </resources>  
  47.   
  48.     <!--單元測試相關的所有資源路徑,配製方法與resources類似 -->  
  49.     <testResources>  
  50.         <testResource>  
  51.             <targetPath />  
  52.             <filtering />  
  53.             <directory />  
  54.             <includes />  
  55.             <excludes />  
  56.         </testResource>  
  57.     </testResources>  
  58.   
  59.     <!--項目源碼目錄,當構建項目的時候,構建系統會編譯目錄裏的源碼。該路徑是相對於pom.xml的相對路徑。 -->  
  60.     <sourceDirectory>${basedir}\src\main\java</sourceDirectory>  
  61.   
  62.     <!--項目腳本源碼目錄,該目錄和源碼目錄不同, <!-- 絕大多數情況下,該目錄下的內容會被拷貝到輸出目錄(因爲腳本是被解釋的,而不是被編譯的)。 -->  
  63.     <scriptSourceDirectory>${basedir}\src\main\scripts  
  64.     </scriptSourceDirectory>  
  65.   
  66.     <!--項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄裏的源碼。該路徑是相對於pom.xml的相對路徑。 -->  
  67.     <testSourceDirectory>${basedir}\src\test\java</testSourceDirectory>  
  68.   
  69.     <!--被編譯過的應用程序class文件存放的目錄。 -->  
  70.     <outputDirectory>${basedir}\target\classes</outputDirectory>  
  71.   
  72.     <!--被編譯過的測試class文件存放的目錄。 -->  
  73.     <testOutputDirectory>${basedir}\target\test-classes  
  74.     </testOutputDirectory>  
  75.   
  76.     <!--項目的一系列構建擴展,它們是一系列build過程中要使用的產品,會包含在running bulid‘s classpath裏面。 -->  
  77.     <!--他們可以開啓extensions,也可以通過提供條件來激活plugins。 -->  
  78.     <!--簡單來講,extensions是在build過程被激活的產品 -->  
  79.     <extensions>  
  80.   
  81.         <!--例如,通常情況下,程序開發完成後部署到線上Linux服務器,可能需要經歷打包、 -->  
  82.         <!--將包文件傳到服務器、SSH連上服務器、敲命令啓動程序等一系列繁瑣的步驟。 -->  
  83.         <!--實際上這些步驟都可以通過Maven的一個插件 wagon-maven-plugin 來自動完成 -->  
  84.         <!--下面的擴展插件wagon-ssh用於通過SSH的方式連接遠程服務器, -->  
  85.         <!--類似的還有支持ftp方式的wagon-ftp插件 -->  
  86.         <extension>  
  87.             <groupId>org.apache.maven.wagon</groupId>  
  88.             <artifactId>wagon-ssh</artifactId>  
  89.             <version>2.8</version>  
  90.         </extension>  
  91.   
  92.     </extensions>  
  93.   
  94.     <!--使用的插件列表 。 -->  
  95.     <plugins>  
  96.         <plugin>  
  97.             <groupId></groupId>  
  98.             <artifactId>maven-assembly-plugin</artifactId>  
  99.             <version>2.5.5</version>  
  100.   
  101.             <!--在構建生命週期中執行一組目標的配置。每個目標可能有不同的配置。 -->  
  102.             <executions>  
  103.                 <execution>  
  104.   
  105.                     <!--執行目標的標識符,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標 -->  
  106.                     <id>assembly</id>  
  107.   
  108.                     <!--綁定了目標的構建生命週期階段,如果省略,目標會被綁定到源數據裏配置的默認階段 -->  
  109.                     <phase>package</phase>  
  110.   
  111.                     <!--配置的執行目標 -->  
  112.                     <goals>  
  113.                         <goal>single</goal>  
  114.                     </goals>  
  115.   
  116.                     <!--配置是否被傳播到子POM -->  
  117.                     <inherited>false</inherited>  
  118.   
  119.                 </execution>  
  120.             </executions>  
  121.   
  122.             <!--作爲DOM對象的配置,配置項因插件而異 -->  
  123.             <configuration>  
  124.                 <finalName>${finalName}</finalName>  
  125.                 <appendAssemblyId>false</appendAssemblyId>  
  126.                 <descriptor>assembly.xml</descriptor>  
  127.             </configuration>  
  128.   
  129.             <!--是否從該插件下載Maven擴展(例如打包和類型處理器), -->  
  130.             <!--由於性能原因,只有在真需要下載時,該元素才被設置成true。 -->  
  131.             <extensions>false</extensions>  
  132.   
  133.             <!--項目引入插件所需要的額外依賴 -->  
  134.             <dependencies>  
  135.                 <dependency>...</dependency>  
  136.             </dependencies>  
  137.   
  138.             <!--任何配置是否被傳播到子項目 -->  
  139.             <inherited>true</inherited>  
  140.   
  141.         </plugin>  
  142.     </plugins>  
  143.   
  144.     <!--主要定義插件的共同元素、擴展元素集合,類似於dependencyManagement, -->  
  145.     <!--所有繼承於此項目的子項目都能使用。該插件配置項直到被引用時纔會被解析或綁定到生命週期。 -->  
  146.     <!--給定插件的任何本地配置都會覆蓋這裏的配置 -->  
  147.     <pluginManagement>  
  148.         <plugins>...</plugins>  
  149.     </pluginManagement>  
  150.   
  151. </build>  

pom裏面的倉庫與setting.xml裏的倉庫功能是一樣的。主要的區別在於,pom裏的倉庫是個性化的。比如一家大公司裏的setting文件是公用的,所有項目都用一個setting文件,但各個子項目卻會引用不同的第三方庫,所以就需要在pom裏設置自己需要的倉庫地址。


分發配置

  1. <!--項目分發信息,在執行mvn deploy後表示要發佈的位置。 -->  
  2. <!--有了這些信息就可以把網站部署到遠程服務器或者把構件部署到遠程倉庫。 -->  
  3. <distributionManagement>  
  4.   
  5.     <!--部署項目產生的構件到遠程倉庫需要的信息 -->  
  6.     <repository>  
  7.   
  8.         <!--是分配給快照一個唯一的版本號(由時間戳和構建流水號),還是每次都使用相同的版本號 -->  
  9.         <!--參見repositories/repository元素 -->  
  10.         <uniqueVersion>true</uniqueVersion>  
  11.   
  12.         <id> repo-id </id>  
  13.         <name> repo-name</name>  
  14.         <url>file://${basedir}/target/deploy </url>  
  15.         <layout />  
  16.   
  17.     </repository>  
  18.   
  19.     <!--構件的快照部署到哪裏,如果沒有配置該元素,默認部署到repository元素配置的倉庫 -->  
  20.     <snapshotRepository>  
  21.         <uniqueVersion />  
  22.         <id />  
  23.         <name />  
  24.         <url />  
  25.         <layout />  
  26.     </snapshotRepository>  
  27.   
  28.     <!--部署項目的網站需要的信息 -->  
  29.     <site>  
  30.   
  31.         <!--部署位置的唯一標識符,用來匹配站點和settings.xml文件裏的配置 -->  
  32.         <id> site-id </id>  
  33.   
  34.         <!--部署位置的名稱 -->  
  35.         <name> site-name</name>  
  36.   
  37.         <!--部署位置的URL,按protocol://hostname/path形式 -->  
  38.         <url>scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web </url>  
  39.   
  40.     </site>  
  41.   
  42.     <!--項目下載頁面的URL。如果沒有該元素,用戶應該參考主頁。 -->  
  43.     <!--使用該元素的原因是:幫助定位那些不在倉庫裏的構件(由於license限制)。 -->  
  44.     <downloadUrl />  
  45.   
  46.     <!--如果構件有了新的groupID和artifact ID(構件移到了新的位置),這裏列出構件的重定位信息。 -->  
  47.     <relocation>  
  48.   
  49.         <!--構件新的group ID -->  
  50.         <groupId />  
  51.   
  52.         <!--構件新的artifact ID -->  
  53.         <artifactId />  
  54.   
  55.         <!--構件新的版本號 -->  
  56.         <version />  
  57.   
  58.         <!--顯示給用戶的,關於移動的額外信息,例如原因。 -->  
  59.         <message />  
  60.   
  61.     </relocation>  
  62.   
  63.     <!--給出該構件在遠程倉庫的狀態。不得在本地項目中設置該元素,因爲這是工具自動更新的。 -->  
  64.     <!--有效的值有:none(默認),converted(倉庫管理員從Maven 1 POM轉換過來), -->  
  65.     <!--partner(直接從夥伴Maven 2倉庫同步過來),deployed(從Maven 2實例部署),verified(被覈實時正確的和最終的)。 -->  
  66.     <status />  
  67.   
  68. </distributionManagement>  

倉庫配置

  1. <!--發現依賴和擴展的遠程倉庫列表。 -->  
  2. <repositories>  
  3.   
  4.     <!--包含需要連接到遠程倉庫的信息 -->  
  5.     <repository>  
  6.   
  7.         <!--如何處理遠程倉庫裏發佈版本的下載 -->  
  8.         <releases>  
  9.   
  10.             <!--true或者false表示該倉庫是否爲下載某種類型構件(發佈版,快照版)開啓。 -->  
  11.             <enabled />  
  12.   
  13.             <!--該元素指定更新發生的頻率。Maven會比較本地POM和遠程POM的時間戳。 -->  
  14.             <!--這裏的選項是:always(一直),daily(默認,每日), -->  
  15.             <!--interval:X(這裏X是以分鐘爲單位的時間間隔),或者never(從不)。 -->  
  16.             <updatePolicy />  
  17.   
  18.             <!--當Maven驗證構件校驗文件失敗時該怎麼做: -->  
  19.             <!--ignore(忽略),fail(失敗),或者warn(警告)。 -->  
  20.             <checksumPolicy />  
  21.   
  22.         </releases>  
  23.   
  24.         <!--如何處理遠程倉庫裏快照版本的下載。有了releases和snapshots這兩組配置, -->  
  25.         <!--POM就可以在每個單獨的倉庫中,爲每種類型的構件採取不同的策略。 -->  
  26.         <!--例如,可能有人會決定只爲開發目的開啓對快照版本下載的支持 -->  
  27.         <snapshots>  
  28.             <enabled />  
  29.             <updatePolicy />  
  30.             <checksumPolicy />  
  31.         </snapshots>  
  32.   
  33.         <!--遠程倉庫唯一標識符。可以用來匹配在settings.xml文件裏配置的遠程倉庫 -->  
  34.         <id> repo-id </id>  
  35.   
  36.         <!--遠程倉庫名稱 -->  
  37.         <name> repo-name</name>  
  38.   
  39.         <!--遠程倉庫URL,按protocol://hostname/path形式 -->  
  40.         <url>http://192.168.1.169:9999/repository/ </span><span class="tag"></url>  
  41.   
  42.         <!--用於定位和排序構件的倉庫佈局類型-可以是default(默認)或者legacy(遺留)。 -->  
  43.         <!--Maven 2爲其倉庫提供了一個默認的佈局; -->  
  44.         <!--然而,Maven1.x有一種不同的佈局。 -->  
  45.         <!--我們可以使用該元素指定佈局是default(默認)還是legacy(遺留)。 -->  
  46.         <layout> default</layout>  
  47.   
  48.     </repository>  
  49.   
  50. </repositories>  
  51.   
  52. <!--發現插件的遠程倉庫列表,這些插件用於構建和報表 -->  
  53. <pluginRepositories>  
  54.   
  55.     <!--包含需要連接到遠程插件倉庫的信息.參見repositories/repository元素 -->  
  56.     <pluginRepository />  
  57.   
  58. </pluginRepositories>  

 

profile配置

  1. <!--在列的項目構建profile,如果被激活,會修改構建處理 -->  
  2. <profiles>  
  3.   
  4.     <!--根據環境參數或命令行參數激活某個構建處理 -->  
  5.     <profile>  
  6.         <!--自動觸發profile的條件邏輯。Activation是profile的開啓鑰匙。 -->  
  7.         <activation>  
  8.   
  9.             <!--profile默認是否激活的標識 -->  
  10.             <activeByDefault>false</activeByDefault>  
  11.   
  12.             <!--activation有一個內建的java版本檢測,如果檢測到jdk版本與期待的一樣,profile被激活。 -->  
  13.             <jdk>1.7</jdk>  
  14.   
  15.             <!--當匹配的操作系統屬性被檢測到,profile被激活。os元素可以定義一些操作系統相關的屬性。 -->  
  16.             <os>  
  17.   
  18.                 <!--激活profile的操作系統的名字 -->  
  19.                 <name>Windows XP</name>  
  20.   
  21.                 <!--激活profile的操作系統所屬家族(如 'windows') -->  
  22.                 <family>Windows</family>  
  23.   
  24.                 <!--激活profile的操作系統體系結構 -->  
  25.                 <arch>x86</arch>  
  26.   
  27.                 <!--激活profile的操作系統版本 -->  
  28.                 <version>5.1.2600</version>  
  29.   
  30.             </os>  
  31.   
  32.             <!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile就會被激活。 -->  
  33.             <!-- 如果值字段是空的,那麼存在屬性名稱字段就會激活profile,否則按區分大小寫方式匹配屬性值字段 -->  
  34.             <property>  
  35.   
  36.                 <!--激活profile的屬性的名稱 -->  
  37.                 <name>mavenVersion</name>  
  38.   
  39.                 <!--激活profile的屬性的值 -->  
  40.                 <value>2.0.3</value>  
  41.   
  42.             </property>  
  43.   
  44.             <!--提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活profile。 -->  
  45.             <!--另一方面,exists則會檢查文件是否存在,如果存在則激活profile。 -->  
  46.             <file>  
  47.   
  48.                 <!--如果指定的文件存在,則激活profile。 -->  
  49.                 <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>  
  50.   
  51.                 <!--如果指定的文件不存在,則激活profile。 -->  
  52.                 <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>  
  53.   
  54.             </file>  
  55.   
  56.         </activation>  
  57.         <id />  
  58.         <build />  
  59.         <modules />  
  60.         <repositories />  
  61.         <pluginRepositories />  
  62.         <dependencies />  
  63.         <reporting />  
  64.         <dependencyManagement />  
  65.         <distributionManagement />  
  66.         <properties />  
  67.     </profile>  

profile配置項在setting.xml中也有,是pom.xml中profile元素的裁剪版本,包含了id,activation, repositories, pluginRepositories和 properties元素。這裏的profile元素只包含這五個子元素是因爲setting.xml只關心構建系統這個整體(這正是settings.xml文件的角色定位),而非單獨的項目對象模型設置。如果一個settings中的profile被激活,它的值會覆蓋任何其它定義在POM中或者profile.xml中的帶有相同id的profile。

pom.xml中的profile可以看做pom.xml的副本,擁有與pom.xml相同的子元素與配置方法。它包含可選的activation(profile的觸發器)和一系列的changes。例如test過程可能會指向不同的數據庫(相對最終的deployment)或者不同的dependencies或者不同的repositories,並且是根據不同的JDK來改變的。只需要其中一個成立就可以激活profile,如果第一個條件滿足了,那麼後面就不會在進行匹配。

 

報表配置

  1. <!--描述使用報表插件產生報表的規範,特定的maven 插件能輸出相應的定製和配置報表. -->  
  2. <!--當用戶執行“mvn site”,這些報表就會運行,在頁面導航欄能看到所有報表的鏈接。 -->  
  3. <reporting>  
  4.   
  5.     <!--true,則網站不包括默認的報表。這包括“項目信息”菜單中的報表。 -->  
  6.     <excludeDefaults />  
  7.   
  8.     <!--所有產生的報表存放到哪裏。默認值是${project.build.directory}/site。 -->  
  9.     <outputDirectory />  
  10.   
  11.     <!--使用的報表插件和他們的配置。 -->  
  12.     <plugins>  
  13.   
  14.         <plugin>  
  15.             <groupId />  
  16.             <artifactId />  
  17.             <version />  
  18.             <inherited />  
  19.             <configuration>  
  20.                 <links>  
  21.                     <link>http://java.sun.com/j2se/1.5.0/docs/api/</span><span class="tag"></link>  
  22.                 </links>  
  23.             </configuration>  
  24.             <!--一組報表的多重規範,每個規範可能有不同的配置。 -->  
  25.             <!--一個規範(報表集)對應一個執行目標 。例如,有1,2,3,4,5,6,7,8,9個報表。 -->  
  26.             <!--1,2,5構成A報表集,對應一個執行目標。2,5,8構成B報表集,對應另一個執行目標 -->  
  27.             <reportSets>  
  28.   
  29.                 <!--表示報表的一個集合,以及產生該集合的配置 -->  
  30.                 <reportSet>  
  31.   
  32.                     <!--報表集合的唯一標識符,POM繼承時用到 -->  
  33.                     <id>sunlink</id>  
  34.   
  35.                     <!--產生報表集合時,被使用的報表的配置 -->  
  36.                     <configuration />  
  37.   
  38.                     <!--配置是否被繼承到子POMs -->  
  39.                     <inherited />  
  40.   
  41.                     <!--這個集合裏使用到哪些報表 -->  
  42.                     <reports>  
  43.                         <report>javadoc</report>  
  44.                     </reports>  
  45.   
  46.                 </reportSet>  
  47.   
  48.             </reportSets>  
  49.   
  50.         </plugin>  
  51.   
  52.     </plugins>  
  53.   
  54. </reporting>     

 

環境配置

  1. <!--項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例爲 jira -->  
  2. <issueManagement>  
  3.   
  4.     <!--問題管理系統(例如jira)的名字, -->  
  5.     <system> jira </system>  
  6.   
  7.     <!--該項目使用的問題管理系統的URL -->  
  8.     <url> http://jira.clf.com/</span><span class="tag"></url>  
  9.   
  10. </issueManagement>  
  11.   
  12. <!--項目持續集成信息 -->  
  13. <ciManagement>  
  14.   
  15.     <!--持續集成系統的名字,例如continuum -->  
  16.     <system />  
  17.   
  18.     <!--該項目使用的持續集成系統的URL(如果持續集成系統有web接口的話)。 -->  
  19.     <url />  
  20.   
  21.     <!--構建完成時,需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告) -->  
  22.     <notifiers>  
  23.   
  24.         <!--配置一種方式,當構建中斷時,以該方式通知用戶/開發者 -->  
  25.         <notifier>  
  26.   
  27.             <!--傳送通知的途徑 -->  
  28.             <type />  
  29.   
  30.             <!--發生錯誤時是否通知 -->  
  31.             <sendOnError />  
  32.   
  33.             <!--構建失敗時是否通知 -->  
  34.             <sendOnFailure />  
  35.   
  36.             <!--構建成功時是否通知 -->  
  37.             <sendOnSuccess />  
  38.   
  39.             <!--發生警告時是否通知 -->  
  40.             <sendOnWarning />  
  41.   
  42.             <!--不贊成使用。通知發送到哪裏 -->  
  43.             <address />  
  44.   
  45.             <!--擴展配置項 -->  
  46.             <configuration />  
  47.   
  48.         </notifier>  
  49.   
  50.     </notifiers>  
  51.   
  52. </ciManagement>  

項目信息配置

  1. <!--項目的名稱, Maven產生的文檔用 -->  
  2. <name>banseon-maven </name>  
  3.   
  4. <!--項目主頁的URL, Maven產生的文檔用 -->  
  5. <url>http://www.clf.com/ </span><span class="tag"></url>  
  6.   
  7. <!--項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時 -->  
  8. <!--(例如,CDATA中的文本會被解析器忽略,就可以包含HTML標籤),不鼓勵使用純文本描述。 -->  
  9. <!-- 如果你需要修改產生的web站點的索引頁面,你應該修改你自己的索引頁文件,而不是調整這裏的文檔。 -->  
  10. <description>A maven project to study maven. </description>  
  11.   
  12. <!--描述了這個項目構建環境中的前提條件。 -->  
  13. <prerequisites>  
  14.   
  15.     <!--構建該項目或使用該插件所需要的Maven的最低版本 -->  
  16.     <maven />  
  17.   
  18. </prerequisites>  
  19.   
  20. <!--項目創建年份,4位數字。當產生版權信息時需要使用這個值。 -->  
  21. <inceptionYear />  
  22.   
  23. <!--項目相關郵件列表信息 -->  
  24. <mailingLists>  
  25.   
  26.     <!--該元素描述了項目相關的所有郵件列表。自動產生的網站引用這些信息。 -->  
  27.     <mailingList>  
  28.   
  29.         <!--郵件的名稱 -->  
  30.         <name> Demo </name>  
  31.   
  32.         <!--發送郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->  
  33.         <post> [email protected]</post>  
  34.   
  35.         <!--訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->  
  36.         <subscribe> [email protected]</subscribe>  
  37.   
  38.         <!--取消訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->  
  39.         <unsubscribe> [email protected]</unsubscribe>  
  40.   
  41.         <!--你可以瀏覽郵件信息的URL -->  
  42.         <archive> http:/hi.clf.com/</archive>  
  43.   
  44.     </mailingList>  
  45.   
  46. </mailingLists>  
  47.   
  48. <!--項目開發者列表 -->  
  49. <developers>  
  50.   
  51.     <!--某個項目開發者的信息 -->  
  52.     <developer>  
  53.   
  54.         <!--SCM裏項目開發者的唯一標識符 -->  
  55.         <id> HELLO WORLD </id>  
  56.   
  57.         <!--項目開發者的全名 -->  
  58.         <name> banseon </name>  
  59.   
  60.         <!--項目開發者的email -->  
  61.         <email> [email protected]</email>  
  62.   
  63.         <!--項目開發者的主頁的URL -->  
  64.         <url />  
  65.   
  66.         <!--項目開發者在項目中扮演的角色,角色元素描述了各種角色 -->  
  67.         <roles>  
  68.             <role> Project Manager</role>  
  69.             <role>Architect </role>  
  70.         </roles>  
  71.   
  72.         <!--項目開發者所屬組織 -->  
  73.         <organization> demo</organization>  
  74.   
  75.         <!--項目開發者所屬組織的URL -->  
  76.         <organizationUrl>http://hi.clf.com/ </span><span class="tag"></organizationUrl>  
  77.   
  78.         <!--項目開發者屬性,如即時消息如何處理等 -->  
  79.         <properties>  
  80.             <dept> No </dept>  
  81.         </properties>  
  82.   
  83.         <!--項目開發者所在時區, -11到12範圍內的整數。 -->  
  84.         <timezone> -5</timezone>  
  85.   
  86.     </developer>  
  87.   
  88. </developers>  
  89.   
  90. <!--項目的其他貢獻者列表 -->  
  91. <contributors>  
  92.   
  93.     <!--項目的其他貢獻者。參見developers/developer元素 -->  
  94.     <contributor>  
  95.         <name />  
  96.         <email />  
  97.         <url />  
  98.         <organization />  
  99.         <organizationUrl />  
  100.         <roles />  
  101.         <timezone />  
  102.         <properties />  
  103.     </contributor>  
  104.   
  105. </contributors>  
  106.   
  107. <!--該元素描述了項目所有License列表。應該只列出該項目的license列表,不要列出依賴項目的license列表。 -->  
  108. <!--如果列出多個license,用戶可以選擇它們中的一個而不是接受所有license。 -->  
  109. <licenses>  
  110.   
  111.     <!--描述了項目的license,用於生成項目的web站點的license頁面,其他一些報表和validation也會用到該元素。 -->  
  112.     <license>  
  113.   
  114.         <!--license用於法律上的名稱 -->  
  115.         <name> Apache 2 </name>  
  116.   
  117.         <!--官方的license正文頁面的URL -->  
  118.         <url>http://www.clf.com/LICENSE-2.0.txt </span><span class="tag"></url>  
  119.   
  120.         <!--項目分發的主要方式: repo,可以從Maven庫下載 manual, 用戶必須手動下載和安裝依賴 -->  
  121.         <distribution> repo</distribution>  
  122.   
  123.         <!--關於license的補充信息 -->  
  124.         <comments> Abusiness-friendly OSS license </comments>  
  125.   
  126.     </license>  
  127.   
  128. </licenses>  
  129.   
  130. <!--SCM(Source Control Management)標籤允許你配置你的代碼庫,供Maven web站點和其它插件使用。 -->  
  131. <scm>  
  132.   
  133.     <!--SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該連接只讀。 -->  
  134.     <connection>scm:svn:http://svn.baidu.com/banseon/maven/</span><span class="tag"></connection>  
  135.   
  136.     <!--給開發者使用的,類似connection元素。即該連接不僅僅只讀 -->  
  137.     <developerConnection>scm:svn:http://svn.baidu.com/banseon/maven/  </span></span></li><li class="">    </developerConnection>  
  138.   
  139.     <!--當前代碼的標籤,在開發階段默認爲HEAD -->  
  140.     <tag />  
  141.   
  142.     <!--指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。 -->  
  143.     <url> http://svn.baidu.com/banseon</span><span class="tag"></url>  
  144.   
  145. </scm>  
  146.   
  147. <!--描述項目所屬組織的各種屬性。Maven產生的文檔用 -->  
  148. <organization>  
  149.   
  150.     <!--組織的全名 -->  
  151.     <name> demo </name>  
  152.   
  153.     <!--組織主頁的URL -->  
  154.     <url> http://www.clf.com/</span><span class="tag"></url>  
  155.   
  156. </organization>   

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章