<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/P ...
<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/maven-v4_0_0.xsd"> <!--父項目的坐標。如果項目中沒有規定某個元素的值,那麼父項目中的對應值即為項目的預設值。 坐標包括group ID,artifact ID和 version。 --> <parent> <!--被繼承的父項目的構件標識符 --> <artifactId /> <!--被繼承的父項目的全球唯一標識符 --> <groupId /> <!--被繼承的父項目的版本 --> <version /> <!-- 父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。預設值是../pom.xml。Maven首先在構建當前項目的地方尋找父項 目的pom,其次在文件系統的這個位置(relativePath位置),然後在本地倉庫,最後在遠程倉庫尋找父項目的pom。 --> <relativePath /> </parent> <!--聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,這是為了當Maven引入了新的特性或者其他模型變更的時候,確保穩定性。 --> <modelVersion>4.0.0</modelVersion> <!--項目的全球唯一標識符,通常使用全限定的包名區分該項目和其他項目。並且構建時生成的路徑也是由此生成, 如com.mycompany.app生成的相對路徑為:/com/mycompany/app --> <groupId>asia.banseon</groupId> <!-- 構件的標識符,它和group ID一起唯一標識一個構件。換句話說,你不能有兩個不同的項目擁有同樣的artifact ID和groupID;在某個 特定的group ID下,artifact ID也必須是唯一的。構件是項目產生的或使用的一個東西,Maven為項目產生的構件包括:JARs,源 碼,二進位發佈和WARs等。 --> <artifactId>banseon-maven2</artifactId> <!--項目產生的構件類型,例如jar、war、ear、pom。插件可以創建他們自己的構件類型,所以前面列的不是全部構件類型 --> <packaging>jar</packaging> <!--項目當前版本,格式為:主版本.次版本.增量版本-限定版本號 --> <version>1.0-SNAPSHOT</version> <!--項目的名稱, Maven產生的文檔用 --> <name>banseon-maven</name> <!--項目主頁的URL, Maven產生的文檔用 --> <url>http://www.baidu.com/banseon</url> <!-- 項目的詳細描述, Maven 產生的文檔用。 當這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略,就可以包含HTML標 簽), 不鼓勵使用純文本描述。如果你需要修改產生的web站點的索引頁面,你應該修改你自己的索引頁文件,而不是調整這裡的文檔。 --> <description>A maven project to study maven.</description> <!--描述了這個項目構建環境中的前提條件。 --> <prerequisites> <!--構建該項目或使用該插件所需要的Maven的最低版本 --> <maven /> </prerequisites> <!--項目的問題管理系統(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統)的名稱和URL,本例為 jira --> <issueManagement> <!--問題管理系統(例如jira)的名字, --> <system>jira</system> <!--該項目使用的問題管理系統的URL --> <url>http://jira.baidu.com/banseon</url> </issueManagement> <!--項目持續集成信息 --> <ciManagement> <!--持續集成系統的名字,例如continuum --> <system /> <!--該項目使用的持續集成系統的URL(如果持續集成系統有web介面的話)。 --> <url /> <!--構建完成時,需要通知的開發者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告) --> <notifiers> <!--配置一種方式,當構建中斷時,以該方式通知用戶/開發者 --> <notifier> <!--傳送通知的途徑 --> <type /> <!--發生錯誤時是否通知 --> <sendOnError /> <!--構建失敗時是否通知 --> <sendOnFailure /> <!--構建成功時是否通知 --> <sendOnSuccess /> <!--發生警告時是否通知 --> <sendOnWarning /> <!--不贊成使用。通知發送到哪裡 --> <address /> <!--擴展配置項 --> <configuration /> </notifier> </notifiers> </ciManagement> <!--項目創建年份,4位數字。當產生版權信息時需要使用這個值。 --> <inceptionYear /> <!--項目相關郵件列表信息 --> <mailingLists> <!--該元素描述了項目相關的所有郵件列表。自動產生的網站引用這些信息。 --> <mailingList> <!--郵件的名稱 --> <name>Demo</name> <!--發送郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 --> <post>[email protected]</post> <!--訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 --> <subscribe>[email protected]</subscribe> <!--取消訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 --> <unsubscribe>[email protected]</unsubscribe> <!--你可以瀏覽郵件信息的URL --> <archive>http:/hi.baidu.com/banseon/demo/dev/</archive> </mailingList> </mailingLists> <!--項目開發者列表 --> <developers> <!--某個項目開發者的信息 --> <developer> <!--SCM里項目開發者的唯一標識符 --> <id>HELLO WORLD</id> <!--項目開發者的全名 --> <name>banseon</name> <!--項目開發者的email --> <email>[email protected]</email> <!--項目開發者的主頁的URL --> <url /> <!--項目開發者在項目中扮演的角色,角色元素描述了各種角色 --> <roles> <role>Project Manager</role> <role>Architect</role> </roles> <!--項目開發者所屬組織 --> <organization>demo</organization> <!--項目開發者所屬組織的URL --> <organizationUrl>http://hi.baidu.com/banseon</organizationUrl> <!--項目開發者屬性,如即時消息如何處理等 --> <properties> <dept>No</dept> </properties> <!--項目開發者所在時區, -11到12範圍內的整數。 --> <timezone>-5</timezone> </developer> </developers> <!--項目的其他貢獻者列表 --> <contributors> <!--項目的其他貢獻者。參見developers/developer元素 --> <contributor> <name /> <email /> <url /> <organization /> <organizationUrl /> <roles /> <timezone /> <properties /> </contributor> </contributors> <!--該元素描述了項目所有License列表。 應該只列出該項目的license列表,不要列出依賴項目的 license列表。如果列出多個license,用戶可以選擇它們中的一個而不是接受所有license。 --> <licenses> <!--描述了項目的license,用於生成項目的web站點的license頁面,其他一些報表和validation也會用到該元素。 --> <license> <!--license用於法律上的名稱 --> <name>Apache 2</name> <!--官方的license正文頁面的URL --> <url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url> <!--項目分發的主要方式: repo,可以從Maven庫下載 manual, 用戶必須手動下載和安裝依賴 --> <distribution>repo</distribution> <!--關於license的補充信息 --> <comments>A business-friendly OSS license</comments> </license> </licenses> <!--SCM(Source Control Management)標簽允許你配置你的代碼庫,供Maven web站點和其它插件使用。 --> <scm> <!--SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該連接只讀。 --> <connection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk) </connection> <!--給開發者使用的,類似connection元素。即該連接不僅僅只讀 --> <developerConnection> scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk </developerConnection> <!--當前代碼的標簽,在開發階段預設為HEAD --> <tag /> <!--指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。 --> <url>http://svn.baidu.com/banseon</url> </scm> <!--描述項目所屬組織的各種屬性。Maven產生的文檔用 --> <organization> <!--組織的全名 --> <name>demo</name> <!--組織主頁的URL --> <url>http://www.baidu.com/banseon</url> </organization> <!--構建項目需要的信息 --> <build> <!--該元素設置了項目源碼目錄,當構建項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。 --> <sourceDirectory /> <!--該元素設置了項目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數情況下,該目錄下的內容 會被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。 --> <scriptSourceDirectory /> <!--該元素設置了項目單元測試使用的源碼目錄,當測試項目的時候,構建系統會編譯目錄里的源碼。該路徑是相對於pom.xml的相對路徑。 --> <testSourceDirectory /> <!--被編譯過的應用程式class文件存放的目錄。 --> <outputDirectory /> <!--被編譯過的測試class文件存放的目錄。 --> <testOutputDirectory /> <!--使用來自該項目的一系列構建擴展 --> <extensions> <!--描述使用到的構建擴展。 --> <extension> <!--構建擴展的groupId --> <groupId /> <!--構建擴展的artifactId --> <artifactId /> <!--構建擴展的版本 --> <version /> </extension> </extensions> <!--當項目沒有規定目標(Maven2 叫做階段)時的預設值 --> <defaultGoal /> <!--這個元素描述了項目相關的所有資源路徑列表,例如和項目相關的屬性文件,這些資源被包含在最終的打包文件里。 --> <resources> <!--這個元素描述了項目相關或測試相關的所有資源路徑 --> <resource> <!-- 描述了資源的目標路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。舉個例 子,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設置為org/apache/maven /messages。然而,如果你只是想把資源放到源碼目錄結構里,就不需要該配置。 --> <targetPath /> <!--是否使用參數值代替參數名。參數值取自properties元素或者文件里配置的屬性,文件在filters元素里列出。 --> <filtering /> <!--描述存放資源的目錄,該路徑相對POM路徑 --> <directory /> <!--包含的模式列表,例如**/*.xml. --> <includes /> <!--排除的模式列表,例如**/*.xml --> <excludes /> </resource> </resources> <!--這個元素描述了單元測試相關的所有資源路徑,例如和單元測試相關的屬性文件。 --> <testResources> <!--這個元素描述了測試相關的所有資源路徑,參見build/resources/resource元素的說明 --> <testResource> <targetPath /> <filtering /> <directory /> <includes /> <excludes /> </testResource> </testResources> <!--構建產生的所有文件存放的目錄 --> <directory /> <!--產生的構件的文件名,預設值是${artifactId}-${version}。 --> <finalName /> <!--當filtering開關打開時,使用到的過濾器屬性文件列表 --> <filters /> <!--子項目可以引用的預設插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這裡的配置 --> <pluginManagement> <!--使用的插件列表 。 --> <plugins> <!--plugin元素包含描述插件所需要的信息。 --> <plugin> <!--插件在倉庫里的group ID --> <groupId /> <!--插件在倉庫里的artifact ID --> <artifactId /> <!--被使用的插件的版本(或版本範圍) --> <version /> <!--是否從該插件下載Maven擴展(例如打包和類型處理器),由於性能原因,只有在真需要下載時,該元素才被設置成enabled。 --> <extensions /> <!--在構建生命周期中執行一組目標的配置。每個目標可能有不同的配置。 --> <executions> <!--execution元素包含了插件執行需要的信息 --> <execution> <!--執行目標的標識符,用於標識構建過程中的目標,或者匹配繼承過程中需要合併的執行目標 --> <id /> <!--綁定了目標的構建生命周期階段,如果省略,目標會被綁定到源數據里配置的預設階段 --> <phase /> <!--配置的執行目標 --> <goals /> <!--配置是否被傳播到子POM --> <inherited /> <!--作為DOM對象的配置 --> <configuration /> </execution> </executions> <!--項目引入插件所需要的額外依賴 --> <dependencies> <!--參見dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> <!--任何配置是否被傳播到子項目 --> <inherited /> <!--作為DOM對象的配置 --> <configuration /> </plugin> </plugins> </pluginManagement> <!--使用的插件列表 --> <plugins> <!--參見build/pluginManagement/plugins/plugin元素 --> <plugin> <groupId /> <artifactId /> <version /> <extensions /> <executions> <execution> <id /> <phase /> <goals /> <inherited /> <configuration /> </execution> </executions> <dependencies> <!--參見dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> <goals /> <inherited /> <configuration /> </plugin> </plugins> </build> <!--在列的項目構建profile,如果被激活,會修改構建處理 --> <profiles> <!--根據環境參數或命令行參數激活某個構建處理 --> <profile> <!--構建配置的唯一標識符。即用於命令行激活,也用於在繼承時合併具有相同標識符的profile。 --> <id /> <!--自動觸發profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自於它 能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元素並不是激活profile的唯一方式。 --> <activation> <!--profile預設是否激活的標誌 --> <activeByDefault /> <!--當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK。 --> <jdk /> <!--當匹配的操作系統屬性被檢測到,profile被激活。os元素可以定義一些操作系統相關的屬性。 --> <os> <!--激活profile的操作系統的名字 --> <name>Windows XP</name> <!--激活profile的操作系統所屬家族(如 'windows') --> <family>Windows</family> <!--激活profile的操作系統體繫結構 --> <arch>x86</arch> <!--激活profile的操作系統版本 --> <version>5.1.2600</version> </os> <!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile就會被激活。如果值 欄位是空的,那麼存在屬性名稱欄位就會激活profile,否則按區分大小寫方式匹配屬性值欄位 --> <property> <!--激活profile的屬性的名稱 --> <name>mavenVersion</name> <!--激活profile的屬性的值 --> <value>2.0.3</value> </property> <!--提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活 profile。另一方面,exists則會檢查文件是否存在,如果存在則激活profile。 --> <file> <!--如果指定的文件存在,則激活profile。 --> <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </exists> <!--如果指定的文件不存在,則激活profile。 --> <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/ </missing> </file> </activation> <!--構建項目所需要的信息。參見build元素 --> <build> <defaultGoal /> <resources> <resource> <targetPath /> <filtering /> <directory /> <includes /> <excludes /> </resource> </resources> <testResources> <testResource> <targetPath /> <filtering