Maven中標籤的介紹
maven專案中的pom.xml中主要標籤的介紹:
1.maven中的<profile>標籤
使用maven管理專案有一個好處是就是可以針對不同的環境使用不同的編譯打包設定,方便了多環境下的打包部署,一般我們開發專案都會有至少開發環境,測試環境和正式環境,針對這不同環境的配置資訊也會有所不同,比如資料庫的配置等。我們可以使用maven的profile定義來進行區分。在釋出的時候可以用:
mvn release -p product
mvn release -p test
mvn release -p dev
一個Profiles下面允許出現的元素:
<project><profiles> <profile> <build> <defaultGoal>...</defaultGoal> <finalName>...</finalName> <resources>...</resources> <testResources>...</testResources> <plugins>...</plugins> </build> <reporting>...</reporting> <modules>...</modules> <dependencies>...</dependencies> <dependencyManagement>...</dependencyManagement> <distributionManagement>...</distributionManagement> <repositories>...</repositories> <pluginRepositories>...</pluginRepositories> <properties>...</properties> </profile> </profiles> </project>
我們可以有多個地方定義profile。定義的地方不同,它的作用範圍也不同。
- 針對於特定專案的profile配置我們可以定義在該專案的pom.xml中。
- 針對於特定使用者的profile配置,我們可以在使用者的settings.xml檔案中定義profile。該檔案在使用者家目錄下的“.m2”目錄下。
- 全域性的profile配置。全域性的profile是定義在Maven安裝目錄下的“conf/settings.xml”檔案中的。
profile的啟用方式
Maven給我們提供了多種不同的profile啟用方式。比如我們可以使用-P引數顯示的啟用一個profile,也可以根據環境條件的設定讓它自動啟用等。下面將對它們一一進行介紹:
1. 命令列啟用
使用者可以在 mvn 命令列中新增引數“-P”,指定要啟用的 profile 的 id。如果一次要啟用多個 profile,可以用逗號分開一起啟用。例如:
mvn clean install -P dev,test
這個命令就同時激活了 id 為“dev_evn”和“test_evn”的兩個 profile。
類似與在idea中選擇maven外掛的方式
2. Settings 檔案顯示啟用
如果希望某個 profile 預設一直處於啟用狀態,可以在 settings.xml 中配置 activeProfiles 元素,指定某個 profile 為預設啟用狀態,樣例配置程式碼如下:
<settings> ... <activeProfiles> <activeProfile>dev_evn</activeProfile> </activeProfiles> ... </settings>
3. 系統屬性啟用
可以配置當某個系統屬性存在時啟用 profile,
<profiles> <profile> ... <activation> <property> <name>profileProperty</name> <value>dev</value> </property> </activation> </profile> </profiles>
這樣就可以在 mvn 中用“-D”引數來指定啟用,例如:
Mvn clean install -D profileProperty=dev
表示啟用屬性名稱為 profileProperty,值為 dev 的 profile。
實際上這也是一種命令啟用 profile 的方法,只是用的是“-D”引數指定啟用的屬性和值,而前面的是用的“-P”引數指定啟用的 profile 的 id 而已。
4. 作業系統環境啟用
使用者可以通過配置指定不同作業系統的資訊,實現不同作業系統做不同的構建。例如:
<profiles> <profile> <activation> <os> <name>Window XP</name> <family>Windows</family> <arch>x86</arch> <version>5.1.2600</version> </os> </activation> </profile> </profiles>
family 的值是 Windows、UNIX 或 Mac。name 為作業系統名稱。arch為作業系統的架構。version為作業系統的版本。具體的值可以通過檢視環境中的系統屬性“os.name”“os.arch”和“os.version”獲取。
5. 檔案存在與否啟用
當然,也可以通過配置判斷某個檔案存在與否來決定是否啟用 profile,樣例配置程式碼如下:
<profiles> <profile> <activation> <file> <missing>t1.properties</missing> <exists>t2.properties</exists> </file> </activation> </profile> </profiles>
6. 預設啟用
最後,還可以配置一個預設的啟用 profile,例如:
<profiles> <profile> <activation> <activeByDefault>true</activeByDefault> </activation> </profile> </profiles>
需要注意的是,如果 pom 中有任何一個 profile 通過其他方式被啟用的話,所有配置成預設啟用的 profile 都會自動失效。 可以使用如下命令檢視當前啟用的 profile。
Mvn help:active-profiles
也可以使用如下命令檢視所有的 profile。
Mvn help:all-profiles
2.maven中的<activation>標籤
使用者可以通過配置指定不同作業系統的資訊,實現不同作業系統做不同的構建。
3.maven中的<build>標籤
在Maven的pom.xml檔案中,存在如下兩種<build>:
一種<build>被稱為Project Build,即是<project>的直接子元素。另一種<build>被稱為Profile Build,即是<profile>的直接子元素。
Profile Build包含了基本的build元素,而Project Build還包含兩個特殊的元素,即各種<...Directory>和<extensions>。
Profile Build和Project Build的共有元素
1) 共用的基本build元素
說明:
- defaultGoal,執行構建時預設的goal或phase,如jar:jar或者package等
- directory,構建的結果所在的路徑,預設為${basedir}/target目錄
- finalName,構建的最終結果的名字,該名字可能在其他plugin中被改變
2) <resources>
資源往往不是程式碼,無需編譯,而是一些properties或XML配置檔案,構建過程中會往往會將資原始檔從源路徑複製到指定的目標路徑。
<resources>給出各個資源在Maven專案中的具體路徑。示例如下:
說明:
- resources,build過程中涉及的資原始檔
- targetPath,資原始檔的目標路徑
- filtering,構建過程中是否對資源進行過濾,預設false
- directory,資原始檔的路徑,預設位於${basedir}/src/main/resources/目錄下
- includes,一組檔名的匹配模式,被匹配的資原始檔將被構建過程處理
- excludes,一組檔名的匹配模式,被匹配的資原始檔將被構建過程忽略。同時被includes和excludes匹配的資原始檔,將被忽略。
- filters,給出對資原始檔進行過濾的屬性檔案的路徑,預設位於${basedir}/src/main/filters/目錄下。屬性檔案中定義若干鍵值對。在構建過程中,對於資原始檔中出現的變數(鍵),將使用屬性檔案中該鍵對應的值替換。
- testResources,test過程中涉及的資原始檔,預設位於${basedir}/src/test/resources/目錄下。這裡的資原始檔不會被構建到目標構件中
3) <plugins>
<plugins>給出構建過程中所用到的外掛。
說明:
- groupId
- artifactId
- version
- extensions,是否載入該外掛的擴充套件,預設false
- inherited,該外掛的configuration中的配置是否可以被(繼承該POM的其他Maven專案)繼承,預設true
- configuration,該外掛所需要的特殊配置,在父子專案之間可以覆蓋或合併
- dependencies,該外掛所特有的依賴類庫
- executions,該外掛的某個goal(一個外掛中可能包含多個goal)的執行方式。一個execution有如下設定:
- id,唯一標識
- goals,要執行的外掛的goal(可以有多個),如<goal>run</goal>
- phase,外掛的goal要嵌入到Maven的phase中執行,如verify
- inherited,該execution是否可被子專案繼承
- configuration,該execution的其他配置引數
4) <pluginManagement>
在<build>中,<pluginManagement>與<plugins>並列,兩者之間的關係類似於<dependencyManagement>與<dependencies>之間的關係。<pluginManagement>中也配置<plugin>,其配置引數與<plugins>中的<plugin>完全一致。只是,<pluginManagement>往往出現在父專案中,其中配置的<plugin>往往通用於子專案。子專案中只要在<plugins>中以<plugin>宣告該外掛,該外掛的具體配置引數則繼承自父專案中<pluginManagement>對該外掛的配置,從而避免在子專案中進行重複配置。
5)maven-enforcer-plugin外掛
Maven Enforcer plugin就是來解決校驗是否是指定的版本這類問題。Enforcer可以在專案validate時,對專案環境進行檢查。
Enforcer配置後預設會在validate後執行enforcer:enforce,然後對專案環境進行檢查。拿上面對JDK的校驗為例,我們在pom.xml中配置外掛。
<plugin> <artifactId>maven-enforcer-plugin</artifactId> <version>1.4.1</version> <executions> <execution> <id>default-cli</id> --一個執行例項的id <goals> <goal>enforce</goal> --執行的命令 </goals> <phase>validate</phase> --執行的階段 <configuration> <rules> --規則 <requireJavaVersion> --JDK的版本 <message> --失敗後提示訊息 <![CDATA[You are running an older version of Java. This application requires at least JDK ${java.version}.]]> </message> <version>[${java.version}.0,)</version> --JDK版本規則 </requireJavaVersion> </rules> </configuration> </execution> </executions> </plugin>
<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 /> <directory /> <includes /> <excludes /> </testResource> </testResources> <directory /> <finalName /> <filters /> <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> </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> <!--模組(有時稱作子專案) 被構建成專案的一部分。列出的每個模組元素是指向該模組的目錄的相對路徑 --> <modules /> <!--發現依賴和擴充套件的遠端倉庫列表。 --> <repositories> <!--參見repositories/repository元素 --> <repository> <releases> <enabled /> <updatePolicy /> <checksumPolicy /> </releases> <snapshots> <enabled /> <updatePolicy /> <checksumPolicy /> </snapshots> <id /> <name /> <url /> <layout /> </repository> </repositories> <!--發現外掛的遠端倉庫列表,這些外掛用於構建和報表 --> <pluginRepositories> <!--包含需要連線到遠端外掛倉庫的資訊.參見repositories/repository元素 --> <pluginRepository> <releases> <enabled /> <updatePolicy /> <checksumPolicy /> </releases> <snapshots> <enabled /> <updatePolicy /> <checksumPolicy /> </snapshots> <id /> <name /> <url /> <layout /> </pluginRepository> </pluginRepositories> <!--該元素描述了專案相關的所有依賴。 這些依賴組成了專案構建過程中的一個個環節。它們自動從專案定義的倉庫中下載。要獲取更多資訊,請看專案依賴機制。 --> <dependencies> <!--參見dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> <!--不贊成使用. 現在Maven忽略該元素. --> <reports /> <!--該元素包括使用報表外掛產生報表的規範。當用戶執行“mvn site”,這些報表就會執行。 在頁面導航欄能看到所有報表的連結。參見reporting元素 --> <reporting> ...... </reporting> <!--參見dependencyManagement元素 --> <dependencyManagement> <dependencies> <!--參見dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> </dependencyManagement> <!--參見distributionManagement元素 --> <distributionManagement> ...... </distributionManagement> <!--參見properties元素 --> <properties /> </profile> </profiles> <!--模組(有時稱作子專案) 被構建成專案的一部分。列出的每個模組元素是指向該模組的目錄的相對路徑 --> <modules /> <!--發現依賴和擴充套件的遠端倉庫列表。 --> <repositories> <!--包含需要連線到遠端倉庫的資訊 --> <repository> <!--如何處理遠端倉庫裡釋出版本的下載 --> <releases> <!--true或者false表示該倉庫是否為下載某種型別構件(釋出版,快照版)開啟。 --> <enabled /> <!--該元素指定更新發生的頻率。Maven會比較本地POM和遠端POM的時間戳。這裡的選項是:always(一直),daily(預設,每日),interval:X(這裡X是以分鐘為單位的時間間隔),或者never(從不)。 --> <updatePolicy /> <!--當Maven驗證構件校驗檔案失敗時該怎麼做:ignore(忽略),fail(失敗),或者warn(警告)。 --> <checksumPolicy /> </releases> <!-- 如何處理遠端倉庫裡快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種型別的構件採取不同的 策略。例如,可能有人會決定只為開發目的開啟對快照版本下載的支援。參見repositories/repository/releases元素 --> <snapshots> <enabled /> <updatePolicy /> <checksumPolicy /> </snapshots> <!--遠端倉庫唯一識別符號。可以用來匹配在settings.xml檔案裡配置的遠端倉庫 --> <id>banseon-repository-proxy</id> <!--遠端倉庫名稱 --> <name>banseon-repository-proxy</name> <!--遠端倉庫URL,按protocol://hostname/path形式 --> <url>http://192.168.1.169:9999/repository/</url> <!-- 用於定位和排序構件的倉庫佈局型別-可以是default(預設)或者legacy(遺留)。Maven 2為其倉庫提供了一個預設的佈局;然 而,Maven 1.x有一種不同的佈局。我們可以使用該元素指定佈局是default(預設)還是legacy(遺留)。 --> <layout>default</layout> </repository> </repositories> <!--發現外掛的遠端倉庫列表,這些外掛用於構建和報表 --> <pluginRepositories> <!--包含需要連線到遠端外掛倉庫的資訊.參見repositories/repository元素 --> <pluginRepository> ...... </pluginRepository> </pluginRepositories> <!--該元素描述了專案相關的所有依賴。 這些依賴組成了專案構建過程中的一個個環節。它們自動從專案定義的倉庫中下載。要獲取更多資訊,請看專案依賴機制。 --> <dependencies> <dependency> <!--依賴的group ID --> <groupId>org.apache.maven</groupId> <!--依賴的artifact ID --> <artifactId>maven-artifact</artifactId> <!--依賴的版本號。 在Maven 2裡, 也可以配置成版本號的範圍。 --> <version>3.8.1</version> <!-- 依賴型別,預設型別是jar。它通常表示依賴的檔案的副檔名,但也有例外。一個型別可以被對映成另外一個副檔名或分類器。型別經常和使用的打包方式對應, 儘管這也有例外。一些型別的例子:jar,war,ejb-client和test-jar。如果設定extensions為 true,就可以在 plugin裡定義新的型別。所以前面的型別的例子不完整。 --> <type>jar</type> <!-- 依賴的分類器。分類器可以區分屬於同一個POM,但不同構建方式的構件。分類器名被附加到檔名的版本號後面。例如,如果你想要構建兩個單獨的構件成 JAR,一個使用Java 1.4編譯器,另一個使用Java 6編譯器,你就可以使用分類器來生成兩個單獨的JAR構件。 --> <classifier></classifier> <!--依賴範圍。在專案釋出過程中,幫助決定哪些構件被包括進來。欲知詳情請參考依賴機制。 - compile :預設範圍,用於編譯 - provided:類似於編譯,但支援你期待jdk或者容器提供,類似於classpath - runtime: 在執行時需要使用 - test: 用於test任務時使用 - system: 需要外在提供相應的元素。通過systemPath來取得 - systemPath: 僅用於範圍為system。提供相應的路徑 - optional: 當專案自身被依賴時,標註依賴是否傳遞。用於連續依賴時使用 --> <scope>test</scope> <!--僅供system範圍使用。注意,不鼓勵使用這個元素,並且在新的版本中該元素可能被覆蓋掉。該元素為依賴規定了檔案系統上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑,例如${java.home}。 --> <systemPath></systemPath> <!--當計算傳遞依賴時, 從依賴構件列表裡,列出被排除的依賴構件集。即告訴maven你只依賴指定的專案,不依賴專案的依賴。此元素主要用於解決版本衝突問題 --> <exclusions> <exclusion> <artifactId>spring-core</artifactId> <groupId>org.springframework</groupId> </exclusion> </exclusions> <!--可選依賴,如果你在專案B中把C依賴宣告為可選,你就需要在依賴於B的專案(例如專案A)中顯式的引用對C的依賴。可選依賴阻斷依賴的傳遞性。 --> <optional>true</optional> </dependency> </dependencies> <!--不贊成使用. 現在Maven忽略該元素. --> <reports></reports> <!--該元素描述使用報表外掛產生報表的規範。當用戶執行“mvn site”,這些報表就會執行。 在頁面導航欄能看到所有報表的連結。 --> <reporting> <!--true,則,網站不包括預設的報表。這包括“專案資訊”選單中的報表。 --> <excludeDefaults /> <!--所有產生的報表存放到哪裡。預設值是${project.build.directory}/site。 --> <outputDirectory /> <!--使用的報表外掛和他們的配置。 --> <plugins> <!--plugin元素包含描述報表外掛需要的資訊 --> <plugin> <!--報表外掛在倉庫裡的group ID --> <groupId /> <!--報表外掛在倉庫裡的artifact ID --> <artifactId /> <!--被使用的報表外掛的版本(或版本範圍) --> <version /> <!--任何配置是否被傳播到子專案 --> <inherited /> <!--報表外掛的配置 --> <configuration /> <!--一組報表的多重規範,每個規範可能有不同的配置。一個規範(報表集)對應一個執行目標 。例如,有1,2,3,4,5,6,7,8,9個報表。1,2,5構成A報表集,對應一個執行目標。2,5,8構成B報表集,對應另一個執行目標 --> <reportSets> <!--表示報表的一個集合,以及產生該集合的配置 --> <reportSet> <!--報表集合的唯一識別符號,POM繼承時用到 --> <id /> <!--產生報表集合時,被使用的報表的配置 --> <configuration /> <!--配置是否被繼承到子POMs --> <inherited /> <!--這個集合裡使用到哪些報表 --> <reports /> </reportSet> </reportSets> </plugin> </plugins> </reporting> <!-- 繼承自該專案的所有子專案的預設依賴資訊。這部分的依賴資訊不會被立即解析,而是當子專案宣告一個依賴(必須描述group ID和 artifact ID資訊),如果group ID和artifact ID以外的一些資訊沒有描述,則通過group ID和artifact ID 匹配到這裡的依賴,並使用這裡的依賴資訊。 --> <dependencyManagement> <dependencies> <!--參見dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> </dependencyManagement> <!--專案分發資訊,在執行mvn deploy後表示要釋出的位置。有了這些資訊就可以把網站部署到遠端伺服器或者把構件部署到遠端倉庫。 --> <distributionManagement> <!--部署專案產生的構件到遠端倉庫需要的資訊 --> <repository> <!--是分配給快照一個唯一的版本號(由時間戳和構建流水號)?還是每次都使用相同的版本號?參見repositories/repository元素 --> <uniqueVersion /> <id>banseon-maven2</id> <name>banseon maven2</name> <url>file://${basedir}/target/deploy</url> <layout /> </repository> <!--構件的快照部署到哪裡?如果沒有配置該元素,預設部署到repository元素配置的倉庫,參見distributionManagement/repository元素 --> <snapshotRepository> <uniqueVersion /> <id>banseon-maven2</id> <name>Banseon-maven2 Snapshot Repository</name> <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url> <layout /> </snapshotRepository> <!--部署專案的網站需要的資訊 --> <site> <!--部署位置的唯一識別符號,用來匹配站點和settings.xml檔案裡的配置 --> <id>banseon-site</id> <!--部署位置的名稱 --> <name>business api website</name> <!--部署位置的URL,按protocol://hostname/path形式 --> <url> scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web </url> </site> <!--專案下載頁面的URL。如果沒有該元素,使用者應該參考主頁。使用該元素的原因是:幫助定位那些不在倉庫裡的構件(由於license限制)。 --> <downloadUrl /> <!--如果構件有了新的group ID和artifact ID(構件移到了新的位置),這裡列出構件的重定位資訊。 --> <relocation> <!--構件新的group ID --> <groupId /> <!--構件新的artifact ID --> <artifactId /> <!--構件新的版本號 --> <version /> <!--顯示給使用者的,關於移動的額外資訊,例如原因。 --> <message /> </relocation> <!-- 給出該構件在遠端倉庫的狀態。不得在本地專案中設定該元素,因為這是工具自動更新的。有效的值有:none(預設),converted(倉庫管理員從 Maven 1 POM轉換過來),partner(直接從夥伴Maven 2倉庫同步過來),deployed(從Maven 2例項部 署),verified(被核實時正確的和最終的)。 --> <status /> </distributionManagement> <!--以值替代名稱,Properties可以在整個POM中使用,也可以作為觸發條件(見settings.xml配置檔案裡activation元素的說明)。格式是<name>value</name>。 --> <properties /> </project>