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”文件中的。
2.profile的激活方式
Maven給我們提供了多種不同的profile激活方式。比如我們可以使用-P參數顯示的激活一個profile,也可以根據環境條件的設置讓它自動激活等。下面將對它們一一進行介紹:
2.1. 命令行激活
用戶可以在 mvn 命令行中添加參數“-P”,指定要激活的 profile 的 id。如果一次要激活多個 profile,可以用逗號分開一起激活。例如:
mvn clean install -P dev,test
這個命令就同時激活了 id 為“dev_evn”和“test_evn”的兩個 profile。
類似與在idea中選擇maven插件的方式
2.2. Settings 文件顯示激活
如果希望某個 profile 默認一直處於激活狀態,可以在 settings.xml 中配置 activeProfiles 元素,指定某個 profile 為默認激活狀態,樣例配置代碼如下:
<settings> ... <activeProfiles>
<activeProfile>dev_evn</activeProfile>
</activeProfiles> ... </settings>
2.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 而已。
2.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”獲取。
2.5. 文件存在與否激活
當然,也可以通過配置判斷某個文件存在與否來決定是否激活 profile,樣例配置代碼如下:
<profiles>
<profile>
<activation>
<file>
<missing>t1.properties</missing>
<exists>t2.properties</exists>
</file>
</activation>
</profile>
</profiles>
2.6. 默認激活
最后,還可以配置一個默認的激活 profile,例如:
<profiles>
<profile>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
</profile>
</profiles>
需要注意的是,如果 pom 中有任何一個 profile 通過其他方式被激活的話,所有配置成默認激活的 profile 都會自動失效。 可以使用如下命令查看當前激活的 profile。
mvn help:active-profiles
也可以使用如下命令查看所有的 profile。
mvn help:all-profiles
3.maven中的<activation>標簽
用戶可以通過配置指定不同操作系統的信息,實現不同操作系統做不同的構建。
4.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>
6)maven中的<resource>下的<include>和<exclude>標簽
<include>與<exclude>是用來圈定和排除某一文件目錄下的文件是否是工程資源的。如果<include>與<exclude>划定的范圍存在沖突時,以<exclude>划定的范圍為准。大多數情況下,人們使用<include>和<exclude>是為了配合<filtering>實現過濾特定文件的需要。例如,在一個工程中,src/main/resources目錄下都是工程的資源文件,並不需要<include>和<exclude>再進行划定。但如果我們需要對且僅對其中的jdbc.properties和mail.properties兩個文件進行過濾的話,則需要借助<include>和<exclude>進行如下的配置:
<resources>
<!-- Filter jdbc.properties & mail.properties. NOTE: We don't filter applicationContext-infrastructure.xml, let it go with spring's resource process mechanism. -->
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
<includes>
<include>jdbc.properties</include>
<include>mail.properties</include>
</includes>
</resource>
<!-- Include other files as resources files. -->
<resource>
<directory>src/main/resources</directory>
<filtering>false</filtering>
<excludes>
<exclude>jdbc.properties</exclude>
<exclude>mail.properties</exclude>
</excludes>
</resource>
</resources>
其中第一段<resource>配置聲明:在src/main/resources目錄下,僅jdbc.properties和mail.properties兩個文件是資源文件,然后,這兩個文件需要被過濾。而第二段<resource>配置聲明:同樣在src/main/resources目錄下,除jdbc.properties和mail.properties兩個文件外的其他文件也是資源文件,但是它們不會被過濾。
7)maven中的<dependencyMangement>標簽:
Maven 使用 dependencyManagement 元素來提供了一種管理依賴版本號的方式(通常會在醒目最頂層的 POM 中看到 dependencyManagement 元素)
使用pom.xml 中 dependencyManagement 元素能讓所有在子項目中引用一個依賴而不用顯式的列出版本號,Maven 會沿着父子層向上走,直到找到一個dependencyManagement 元素的項目,然后他就會使用這個 dependencyManagement 元素中的指定版本號
在父pom中
<!--子模塊繼承之后,提供作用:鎖定版本+子module不用寫groupId和version-->
<dependencyManagement>
<dependencies>
<!--spring boot 2.2.2-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.2.2.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!--spring cloud Hoxton.SR1-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Hoxton.SR1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
然后在子項目里就可以添加spring boot 時不指定版本號
<dependencies>
<!--spring boot 2.2.2-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
</dependency>
<!--spring cloud Hoxton.SR1-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
</dependency>
</dependencies>
這樣做的好處就是:如果有多個子項目都引用同一依賴,則可以避免在每個字項目中都聲明一個版本號,這樣當升級或者切換版本的審核,只需要在頂級放容器里更新,而不需要一個個修改,如果某個子項目需要另一個版本,只需要聲明version 就可以.
5.使用<properties>標簽設置統一版本,使用${}來引用
6.maven常用的插件
6.1:jdk編譯插件
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
6.2:maven打包源碼插件
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>2.2.1</version>
<executions>
<execution>
<goals>
<goal>jar-no-fork</goal>
</goals>
<phase>verify</phase>
</execution>
</executions>
</plugin>
6.3:maven的Tomcat插件
<!--Tomcat插件 -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.1</version>
<configuration>
<port>8081</port>
<server>tomcat7</server>
</configuration>
</plugin>
maven中的標簽介紹:
<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>banseon@126.com</post>
<!--訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->
<subscribe>banseon@126.com</subscribe>
<!--取消訂閱郵件的地址或鏈接,如果是郵件地址,創建文檔時,mailto: 鏈接會被自動創建 -->
<unsubscribe>banseon@126.com</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>banseon@126.com</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>