maven的pom配置詳解

時間  2019-11-15
標籤 maven pom 配置 詳解 欄目 Maven 简体版
原文   原文鏈接

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


基礎配置

一個典型的pom.xml文件配置以下：java

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

通常來講，上面的幾個配置項對任何項目都是必不可少的，定義了項目的基本屬性。web

這裏有必要對一個不太經常使用的屬性classifier作一下解釋，由於有時候引用某個jar包，classifier不寫的話會報錯。spring

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的用途在於:apache

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

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


引用它的時候就要註明JDK版本，不然maven不知道你到底須要哪一套jar包：api

[html]  view plain  copy
  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>  

 

構建配置

[html]  view plain  copy
  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裏設置本身須要的倉庫地址。服務器


分發配置

[html]  view plain  copy
  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>  

倉庫配置

[html]  view plain  copy
  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/ </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配置

[html]  view plain  copy
  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，若是第一個條件知足了，那麼後面就不會在進行匹配。

 

報表配置

[html]  view plain  copy
  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/</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>     

 

環境配置

[html]  view plain  copy
  1. <!--項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL，本例爲 jira -->  
  2. <issueManagement>  
  3.   
  4.     <!--問題管理系統（例如jira）的名字， -->  
  5.     <system> jira </system>  
  6.   
  7.     <!--該項目使用的問題管理系統的URL -->  
  8.     <url> http://jira.clf.com/</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>  

項目信息配置

[html]  view plain  copy
  1. <!--項目的名稱, Maven產生的文檔用 -->  
  2. <name>banseon-maven </name>  
  3.   
  4. <!--項目主頁的URL, Maven產生的文檔用 -->  
  5. <url>http://www.clf.com/ </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> clf@126.com</post>  
  34.   
  35.         <!--訂閱郵件的地址或連接，若是是郵件地址，建立文檔時，mailto: 連接會被自動建立 -->  
  36.         <subscribe> clf@126.com</subscribe>  
  37.   
  38.         <!--取消訂閱郵件的地址或連接，若是是郵件地址，建立文檔時，mailto: 連接會被自動建立 -->  
  39.         <unsubscribe> clf@126.com</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> banseon@126.com</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/ </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 </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/</connection>  
  135.   
  136.     <!--給開發者使用的，相似connection元素。即該鏈接不只僅只讀 -->  
  137.     <developerConnection>scm:svn:http://svn.baidu.com/banseon/maven/  
  138.     </developerConnection>  
  139.   
  140.     <!--當前代碼的標籤，在開發階段默認爲HEAD -->  
  141.     <tag />  
  142.   
  143.     <!--指向項目的可瀏覽SCM庫（例如ViewVC或者Fisheye）的URL。 -->  
  144.     <url> http://svn.baidu.com/banseon</url>  
  145.   
  146. </scm>  
  147.   
  148. <!--描述項目所屬組織的各類屬性。Maven產生的文檔用 -->  
  149. <organization>  
  150.   
  151.     <!--組織的全名 -->  
  152.     <name> demo </name>  
  153.   
  154.     <!--組織主頁的URL -->  
  155.     <url> http://www.clf.com/</url>  
  156.   
  157. </organization>
相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程