詳解Maven POM(項目對象模型)
POM( Project Object Model,項目對象模型 ) 是 Maven 工程的基本工作單元,是一個XML文件,包含了項目的基本信息,用于描述項目如何構(gòu)建,聲明項目依賴,等等。
執(zhí)行任務(wù)或目標(biāo)時,Maven 會在當(dāng)前目錄中查找 POM。它讀取 POM,獲取所需的配置信息,然后執(zhí)行目標(biāo)。
POM 中可以指定以下配置:
- 項目依賴
- 插件
- 執(zhí)行目標(biāo)
- 項目構(gòu)建 profile
- 項目版本
- 項目開發(fā)者列表
- 相關(guān)郵件列表信息
在創(chuàng)建 POM 之前,我們首先需要描述項目組 (groupId), 項目的唯一ID。
<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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <!-- 模型版本 --> <modelVersion>4.0.0</modelVersion> <!-- 公司或者組織的唯一標(biāo)志,并且配置時生成的路徑也是由此生成, 如com.companyname.project-group,maven會將該項目打成的jar包放本地路徑:/com/companyname/project-group --> <groupId>com.companyname.project-group</groupId> <!-- 項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區(qū)分的 --> <artifactId>project</artifactId> <!-- 版本號 --> <version>1.0</version> </project>
所有 POM 文件都需要 project 元素和三個必需字段:groupId,artifactId,version。
| 節(jié)點 | 描述 |
| project | 工程的根標(biāo)簽。 |
| modelVersion | 模型版本需要設(shè)置為 4.0。 |
| groupId | 這是工程組的標(biāo)識。它在一個組織或者項目中通常是唯一的。例如,一個銀行組織 com.companyname.project-group 擁有所有的和銀行相關(guān)的項目。 |
| artifactId | 這是工程的標(biāo)識。它通常是工程的名稱。例如,消費者銀行。groupId 和 artifactId 一起定義了 artifact 在倉庫中的位置。 |
| version |
這是工程的版本號。在 artifact 的倉庫中,它用來區(qū)分不同的版本。例如: com.company.bank:consumer-banking:1.0 com.company.bank:consumer-banking:1.1 |
父(Super)POM
父(Super)POM是 Maven 默認(rèn)的 POM。所有的 POM 都繼承自一個父 POM(無論是否顯式定義了這個父 POM)。父 POM 包含了一些可以被繼承的默認(rèn)設(shè)置。因此,當(dāng) Maven 發(fā)現(xiàn)需要下載 POM 中的 依賴時,它會到 Super POM 中配置的默認(rèn)倉庫 http://repo1.maven.org/maven2 去下載。
Maven 使用 effective pom(Super pom 加上工程自己的配置)來執(zhí)行相關(guān)的目標(biāo),它幫助開發(fā)者在 pom.xml 中做盡可能少的配置,當(dāng)然這些配置可以被重寫。
使用以下命令來查看 Super POM 默認(rèn)配置:
mvn help:effective-pom
接下來我們創(chuàng)建目錄 MVN/project,在該目錄下創(chuàng)建 pom.xml,內(nèi)容如下:
<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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <!-- 模型版本 --> <modelVersion>4.0.0</modelVersion> <!-- 公司或者組織的唯一標(biāo)志,并且配置時生成的路徑也是由此生成, 如com.companyname.project-group,maven會將該項目打成的jar包放本地路徑:/com/companyname/project-group --> <groupId>com.companyname.project-group</groupId> <!-- 項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區(qū)分的 --> <artifactId>project</artifactId> <!-- 版本號 --> <version>1.0</version> </project>
在命令控制臺,進入 MVN/project 目錄,執(zhí)行以下命令:
C:\MVN\project>mvn help:effective-pom
Maven 將會開始處理并顯示 effective-pom。
[INFO] Scanning for projects...
Downloading: https://repo.maven.apache.org/maven2/org/apache/maven/plugins/maven-clean-plugin/2.5/maven-clean-plugin-2.5.pom
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:36 min
[INFO] Finished at: 2018-09-05T11:31:28+08:00
[INFO] Final Memory: 15M/149M
[INFO] ------------------------------------------------------------------------
Effective POM 的結(jié)果就像在控制臺中顯示的一樣,經(jīng)過繼承、插值之后,使配置生效。
<?xml version="1.0" encoding="UTF-8"?> <!-- ================================================================= --> <!-- --> <!-- Generated by Maven Help Plugin on 2012-07-05T11:41:51 --> <!-- See: http://maven.apache.org/plugins/maven-help-plugin/ --> <!-- --> <!-- ================================================================= --> <!-- ================================================================= --> <!-- --> <!-- Effective POM for project --> <!-- 'com.companyname.project-group:project-name:jar:1.0' --> <!-- --> <!-- ================================================================= --> <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.0 h ttp://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.companyname.project-group</groupId> <artifactId>project</artifactId> <version>1.0</version> <build> <sourceDirectory>C:\MVN\project\src\main\java</sourceDirectory> <scriptSourceDirectory>src/main/scripts</scriptSourceDirectory> <testSourceDirectory>C:\MVN\project\src\test\java</testSourceDirectory> <outputDirectory>C:\MVN\project\target\classes</outputDirectory> <testOutputDirectory>C:\MVN\project\target\test-classes</testOutputDirectory> <resources> <resource> <mergeId>resource-0</mergeId> <directory>C:\MVN\project\src\main\resources</directory> </resource> </resources> <testResources> <testResource> <mergeId>resource-1</mergeId> <directory>C:\MVN\project\src\test\resources</directory> </testResource> </testResources> <directory>C:\MVN\project\target</directory> <finalName>project-1.0</finalName> <pluginManagement> <plugins> <plugin> <artifactId>maven-antrun-plugin</artifactId> <version>1.3</version> </plugin> <plugin> <artifactId>maven-assembly-plugin</artifactId> <version>2.2-beta-2</version> </plugin> <plugin> <artifactId>maven-clean-plugin</artifactId> <version>2.2</version> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>2.0.2</version> </plugin> <plugin> <artifactId>maven-dependency-plugin</artifactId> <version>2.0</version> </plugin> <plugin> <artifactId>maven-deploy-plugin</artifactId> <version>2.4</version> </plugin> <plugin> <artifactId>maven-ear-plugin</artifactId> <version>2.3.1</version> </plugin> <plugin> <artifactId>maven-ejb-plugin</artifactId> <version>2.1</version> </plugin> <plugin> <artifactId>maven-install-plugin</artifactId> <version>2.2</version> </plugin> <plugin> <artifactId>maven-jar-plugin</artifactId> <version>2.2</version> </plugin> <plugin> <artifactId>maven-javadoc-plugin</artifactId> <version>2.5</version> </plugin> <plugin> <artifactId>maven-plugin-plugin</artifactId> <version>2.4.3</version> </plugin> <plugin> <artifactId>maven-rar-plugin</artifactId> <version>2.2</version> </plugin> <plugin> <artifactId>maven-release-plugin</artifactId> <version>2.0-beta-8</version> </plugin> <plugin> <artifactId>maven-resources-plugin</artifactId> <version>2.3</version> </plugin> <plugin> <artifactId>maven-site-plugin</artifactId> <version>2.0-beta-7</version> </plugin> <plugin> <artifactId>maven-source-plugin</artifactId> <version>2.0.4</version> </plugin> <plugin> <artifactId>maven-surefire-plugin</artifactId> <version>2.4.3</version> </plugin> <plugin> <artifactId>maven-war-plugin</artifactId> <version>2.1-alpha-2</version> </plugin> </plugins> </pluginManagement> <plugins> <plugin> <artifactId>maven-help-plugin</artifactId> <version>2.1.1</version> </plugin> </plugins> </build> <repositories> <repository> <snapshots> <enabled>false</enabled> </snapshots> <id>central</id> <name>Maven Repository Switchboard</name> <url>http://repo1.maven.org/maven2</url> </repository> </repositories> <pluginRepositories> <pluginRepository> <releases> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> </snapshots> <id>central</id> <name>Maven Plugin Repository</name> <url>http://repo1.maven.org/maven2</url> </pluginRepository> </pluginRepositories> <reporting> <outputDirectory>C:\MVN\project\target/site</outputDirectory> </reporting> </project>
POM 標(biāo)簽大全詳解
<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">
<!--父項目的坐標(biāo)。如果項目中沒有規(guī)定某個元素的值,那么父項目中的對應(yīng)值即為項目的默認(rèn)值。 坐標(biāo)包括group ID,artifact ID和
version。 -->
<parent>
<!--被繼承的父項目的構(gòu)件標(biāo)識符 -->
<artifactId />
<!--被繼承的父項目的全球唯一標(biāo)識符 -->
<groupId />
<!--被繼承的父項目的版本 -->
<version />
<!-- 父項目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認(rèn)值是../pom.xml。Maven首先在構(gòu)建當(dāng)前項目的地方尋找父項
目的pom,其次在文件系統(tǒng)的這個位置(relativePath位置),然后在本地倉庫,最后在遠(yuǎn)程倉庫尋找父項目的pom。 -->
<relativePath />
</parent>
<!--聲明項目描述符遵循哪一個POM模型版本。模型本身的版本很少改變,雖然如此,但它仍然是必不可少的,這是為了當(dāng)Maven引入了新的特性或者其他模型變更的時候,確保穩(wěn)定性。 -->
<modelVersion>4.0.0</modelVersion>
<!--項目的全球唯一標(biāo)識符,通常使用全限定的包名區(qū)分該項目和其他項目。并且構(gòu)建時生成的路徑也是由此生成, 如com.mycompany.app生成的相對路徑為:/com/mycompany/app -->
<groupId>asia.banseon</groupId>
<!-- 構(gòu)件的標(biāo)識符,它和group ID一起唯一標(biāo)識一個構(gòu)件。換句話說,你不能有兩個不同的項目擁有同樣的artifact ID和groupID;在某個
特定的group ID下,artifact ID也必須是唯一的。構(gòu)件是項目產(chǎn)生的或使用的一個東西,Maven為項目產(chǎn)生的構(gòu)件包括:JARs,源 碼,二進制發(fā)布和WARs等。 -->
<artifactId>banseon-maven2</artifactId>
<!--項目產(chǎn)生的構(gòu)件類型,例如jar、war、ear、pom。插件可以創(chuàng)建他們自己的構(gòu)件類型,所以前面列的不是全部構(gòu)件類型 -->
<packaging>jar</packaging>
<!--項目當(dāng)前版本,格式為:主版本.次版本.增量版本-限定版本號 -->
<version>1.0-SNAPSHOT</version>
<!--項目的名稱, Maven產(chǎn)生的文檔用 -->
<name>banseon-maven</name>
<!--項目主頁的URL, Maven產(chǎn)生的文檔用 -->
<url>http://www.baidu.com/banseon</url>
<!-- 項目的詳細(xì)描述, Maven 產(chǎn)生的文檔用。 當(dāng)這個元素能夠用HTML格式描述時(例如,CDATA中的文本會被解析器忽略,就可以包含HTML標(biāo)
簽), 不鼓勵使用純文本描述。如果你需要修改產(chǎn)生的web站點的索引頁面,你應(yīng)該修改你自己的索引頁文件,而不是調(diào)整這里的文檔。 -->
<description>A maven project to study maven.</description>
<!--描述了這個項目構(gòu)建環(huán)境中的前提條件。 -->
<prerequisites>
<!--構(gòu)建該項目或使用該插件所需要的Maven的最低版本 -->
<maven />
</prerequisites>
<!--項目的問題管理系統(tǒng)(Bugzilla, Jira, Scarab,或任何你喜歡的問題管理系統(tǒng))的名稱和URL,本例為 jira -->
<issueManagement>
<!--問題管理系統(tǒng)(例如jira)的名字, -->
<system>jira</system>
<!--該項目使用的問題管理系統(tǒng)的URL -->
<url>http://jira.baidu.com/banseon</url>
</issueManagement>
<!--項目持續(xù)集成信息 -->
<ciManagement>
<!--持續(xù)集成系統(tǒng)的名字,例如continuum -->
<system />
<!--該項目使用的持續(xù)集成系統(tǒng)的URL(如果持續(xù)集成系統(tǒng)有web接口的話)。 -->
<url />
<!--構(gòu)建完成時,需要通知的開發(fā)者/用戶的配置項。包括被通知者信息和通知條件(錯誤,失敗,成功,警告) -->
<notifiers>
<!--配置一種方式,當(dāng)構(gòu)建中斷時,以該方式通知用戶/開發(fā)者 -->
<notifier>
<!--傳送通知的途徑 -->
<type />
<!--發(fā)生錯誤時是否通知 -->
<sendOnError />
<!--構(gòu)建失敗時是否通知 -->
<sendOnFailure />
<!--構(gòu)建成功時是否通知 -->
<sendOnSuccess />
<!--發(fā)生警告時是否通知 -->
<sendOnWarning />
<!--不贊成使用。通知發(fā)送到哪里 -->
<address />
<!--擴展配置項 -->
<configuration />
</notifier>
</notifiers>
</ciManagement>
<!--項目創(chuàng)建年份,4位數(shù)字。當(dāng)產(chǎn)生版權(quán)信息時需要使用這個值。 -->
<inceptionYear />
<!--項目相關(guān)郵件列表信息 -->
<mailingLists>
<!--該元素描述了項目相關(guān)的所有郵件列表。自動產(chǎn)生的網(wǎng)站引用這些信息。 -->
<mailingList>
<!--郵件的名稱 -->
<name>Demo</name>
<!--發(fā)送郵件的地址或鏈接,如果是郵件地址,創(chuàng)建文檔時,mailto: 鏈接會被自動創(chuàng)建 -->
<post>banseon@126.com</post>
<!--訂閱郵件的地址或鏈接,如果是郵件地址,創(chuàng)建文檔時,mailto: 鏈接會被自動創(chuàng)建 -->
<subscribe>banseon@126.com</subscribe>
<!--取消訂閱郵件的地址或鏈接,如果是郵件地址,創(chuàng)建文檔時,mailto: 鏈接會被自動創(chuàng)建 -->
<unsubscribe>banseon@126.com</unsubscribe>
<!--你可以瀏覽郵件信息的URL -->
<archive>http:/hi.baidu.com/banseon/demo/dev/</archive>
</mailingList>
</mailingLists>
<!--項目開發(fā)者列表 -->
<developers>
<!--某個項目開發(fā)者的信息 -->
<developer>
<!--SCM里項目開發(fā)者的唯一標(biāo)識符 -->
<id>HELLO WORLD</id>
<!--項目開發(fā)者的全名 -->
<name>banseon</name>
<!--項目開發(fā)者的email -->
<email>banseon@126.com</email>
<!--項目開發(fā)者的主頁的URL -->
<url />
<!--項目開發(fā)者在項目中扮演的角色,角色元素描述了各種角色 -->
<roles>
<role>Project Manager</role>
<role>Architect</role>
</roles>
<!--項目開發(fā)者所屬組織 -->
<organization>demo</organization>
<!--項目開發(fā)者所屬組織的URL -->
<organizationUrl>http://hi.baidu.com/banseon</organizationUrl>
<!--項目開發(fā)者屬性,如即時消息如何處理等 -->
<properties>
<dept>No</dept>
</properties>
<!--項目開發(fā)者所在時區(qū), -11到12范圍內(nèi)的整數(shù)。 -->
<timezone>-5</timezone>
</developer>
</developers>
<!--項目的其他貢獻者列表 -->
<contributors>
<!--項目的其他貢獻者。參見developers/developer元素 -->
<contributor>
<name />
<email />
<url />
<organization />
<organizationUrl />
<roles />
<timezone />
<properties />
</contributor>
</contributors>
<!--該元素描述了項目所有License列表。 應(yīng)該只列出該項目的license列表,不要列出依賴項目的 license列表。如果列出多個license,用戶可以選擇它們中的一個而不是接受所有l(wèi)icense。 -->
<licenses>
<!--描述了項目的license,用于生成項目的web站點的license頁面,其他一些報表和validation也會用到該元素。 -->
<license>
<!--license用于法律上的名稱 -->
<name>Apache 2</name>
<!--官方的license正文頁面的URL -->
<url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>
<!--項目分發(fā)的主要方式: repo,可以從Maven庫下載 manual, 用戶必須手動下載和安裝依賴 -->
<distribution>repo</distribution>
<!--關(guān)于license的補充信息 -->
<comments>A business-friendly OSS license</comments>
</license>
</licenses>
<!--SCM(Source Control Management)標(biāo)簽允許你配置你的代碼庫,供Maven web站點和其它插件使用。 -->
<scm>
<!--SCM的URL,該URL描述了版本庫和如何連接到版本庫。欲知詳情,請看SCMs提供的URL格式和列表。該連接只讀。 -->
<connection>
scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
</connection>
<!--給開發(fā)者使用的,類似connection元素。即該連接不僅僅只讀 -->
<developerConnection>
scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk
</developerConnection>
<!--當(dāng)前代碼的標(biāo)簽,在開發(fā)階段默認(rèn)為HEAD -->
<tag />
<!--指向項目的可瀏覽SCM庫(例如ViewVC或者Fisheye)的URL。 -->
<url>http://svn.baidu.com/banseon</url>
</scm>
<!--描述項目所屬組織的各種屬性。Maven產(chǎn)生的文檔用 -->
<organization>
<!--組織的全名 -->
<name>demo</name>
<!--組織主頁的URL -->
<url>http://www.baidu.com/banseon</url>
</organization>
<!--構(gòu)建項目需要的信息 -->
<build>
<!--該元素設(shè)置了項目源碼目錄,當(dāng)構(gòu)建項目的時候,構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 -->
<sourceDirectory />
<!--該元素設(shè)置了項目腳本源碼目錄,該目錄和源碼目錄不同:絕大多數(shù)情況下,該目錄下的內(nèi)容 會被拷貝到輸出目錄(因為腳本是被解釋的,而不是被編譯的)。 -->
<scriptSourceDirectory />
<!--該元素設(shè)置了項目單元測試使用的源碼目錄,當(dāng)測試項目的時候,構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 -->
<testSourceDirectory />
<!--被編譯過的應(yīng)用程序class文件存放的目錄。 -->
<outputDirectory />
<!--被編譯過的測試class文件存放的目錄。 -->
<testOutputDirectory />
<!--使用來自該項目的一系列構(gòu)建擴展 -->
<extensions>
<!--描述使用到的構(gòu)建擴展。 -->
<extension>
<!--構(gòu)建擴展的groupId -->
<groupId />
<!--構(gòu)建擴展的artifactId -->
<artifactId />
<!--構(gòu)建擴展的版本 -->
<version />
</extension>
</extensions>
<!--當(dāng)項目沒有規(guī)定目標(biāo)(Maven2 叫做階段)時的默認(rèn)值 -->
<defaultGoal />
<!--這個元素描述了項目相關(guān)的所有資源路徑列表,例如和項目相關(guān)的屬性文件,這些資源被包含在最終的打包文件里。 -->
<resources>
<!--這個元素描述了項目相關(guān)或測試相關(guān)的所有資源路徑 -->
<resource>
<!-- 描述了資源的目標(biāo)路徑。該路徑相對target/classes目錄(例如${project.build.outputDirectory})。舉個例
子,如果你想資源在特定的包里(org.apache.maven.messages),你就必須該元素設(shè)置為org/apache/maven /messages。然而,如果你只是想把資源放到源碼目錄結(jié)構(gòu)里,就不需要該配置。 -->
<targetPath />
<!--是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性,文件在filters元素里列出。 -->
<filtering />
<!--描述存放資源的目錄,該路徑相對POM路徑 -->
<directory />
<!--包含的模式列表,例如**/*.xml. -->
<includes />
<!--排除的模式列表,例如**/*.xml -->
<excludes />
</resource>
</resources>
<!--這個元素描述了單元測試相關(guān)的所有資源路徑,例如和單元測試相關(guān)的屬性文件。 -->
<testResources>
<!--這個元素描述了測試相關(guān)的所有資源路徑,參見build/resources/resource元素的說明 -->
<testResource>
<targetPath />
<filtering />
<directory />
<includes />
<excludes />
</testResource>
</testResources>
<!--構(gòu)建產(chǎn)生的所有文件存放的目錄 -->
<directory />
<!--產(chǎn)生的構(gòu)件的文件名,默認(rèn)值是${artifactId}-${version}。 -->
<finalName />
<!--當(dāng)filtering開關(guān)打開時,使用到的過濾器屬性文件列表 -->
<filters />
<!--子項目可以引用的默認(rèn)插件信息。該插件配置項直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置 -->
<pluginManagement>
<!--使用的插件列表 。 -->
<plugins>
<!--plugin元素包含描述插件所需要的信息。 -->
<plugin>
<!--插件在倉庫里的group ID -->
<groupId />
<!--插件在倉庫里的artifact ID -->
<artifactId />
<!--被使用的插件的版本(或版本范圍) -->
<version />
<!--是否從該插件下載Maven擴展(例如打包和類型處理器),由于性能原因,只有在真需要下載時,該元素才被設(shè)置成enabled。 -->
<extensions />
<!--在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個目標(biāo)可能有不同的配置。 -->
<executions>
<!--execution元素包含了插件執(zhí)行需要的信息 -->
<execution>
<!--執(zhí)行目標(biāo)的標(biāo)識符,用于標(biāo)識構(gòu)建過程中的目標(biāo),或者匹配繼承過程中需要合并的執(zhí)行目標(biāo) -->
<id />
<!--綁定了目標(biāo)的構(gòu)建生命周期階段,如果省略,目標(biāo)會被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 -->
<phase />
<!--配置的執(zhí)行目標(biāo) -->
<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>
<!--在列的項目構(gòu)建profile,如果被激活,會修改構(gòu)建處理 -->
<profiles>
<!--根據(jù)環(huán)境參數(shù)或命令行參數(shù)激活某個構(gòu)建處理 -->
<profile>
<!--構(gòu)建配置的唯一標(biāo)識符。即用于命令行激活,也用于在繼承時合并具有相同標(biāo)識符的profile。 -->
<id />
<!--自動觸發(fā)profile的條件邏輯。Activation是profile的開啟鑰匙。profile的力量來自于它 能夠在某些特定的環(huán)境中自動使用某些特定的值;這些環(huán)境通過activation元素指定。activation元素并不是激活profile的唯一方式。 -->
<activation>
<!--profile默認(rèn)是否激活的標(biāo)志 -->
<activeByDefault />
<!--當(dāng)匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK。 -->
<jdk />
<!--當(dāng)匹配的操作系統(tǒng)屬性被檢測到,profile被激活。os元素可以定義一些操作系統(tǒng)相關(guān)的屬性。 -->
<os>
<!--激活profile的操作系統(tǒng)的名字 -->
<name>Windows XP</name>
<!--激活profile的操作系統(tǒng)所屬家族(如 'windows') -->
<family>Windows</family>
<!--激活profile的操作系統(tǒng)體系結(jié)構(gòu) -->
<arch>x86</arch>
<!--激活profile的操作系統(tǒng)版本 -->
<version>5.1.2600</version>
</os>
<!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應(yīng)的名稱和值,Profile就會被激活。如果值 字段是空的,那么存在屬性名稱字段就會激活profile,否則按區(qū)分大小寫方式匹配屬性值字段 -->
<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>
<!--構(gòu)建項目所需要的信息。參見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>
<!--模塊(有時稱作子項目) 被構(gòu)建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 -->
<modules />
<!--發(fā)現(xiàn)依賴和擴展的遠(yuǎn)程倉庫列表。 -->
<repositories>
<!--參見repositories/repository元素 -->
<repository>
<releases>
<enabled />
<updatePolicy />
<checksumPolicy />
</releases>
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<id />
<name />
<url />
<layout />
</repository>
</repositories>
<!--發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表,這些插件用于構(gòu)建和報表 -->
<pluginRepositories>
<!--包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素 -->
<pluginRepository>
<releases>
<enabled />
<updatePolicy />
<checksumPolicy />
</releases>
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<id />
<name />
<url />
<layout />
</pluginRepository>
</pluginRepositories>
<!--該元素描述了項目相關(guān)的所有依賴。 這些依賴組成了項目構(gòu)建過程中的一個個環(huán)節(jié)。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機制。 -->
<dependencies>
<!--參見dependencies/dependency元素 -->
<dependency>
......
</dependency>
</dependencies>
<!--不贊成使用. 現(xiàn)在Maven忽略該元素. -->
<reports />
<!--該元素包括使用報表插件產(chǎn)生報表的規(guī)范。當(dāng)用戶執(zhí)行"mvn site",這些報表就會運行。 在頁面導(dǎo)航欄能看到所有報表的鏈接。參見reporting元素 -->
<reporting>
......
</reporting>
<!--參見dependencyManagement元素 -->
<dependencyManagement>
<dependencies>
<!--參見dependencies/dependency元素 -->
<dependency>
......
</dependency>
</dependencies>
</dependencyManagement>
<!--參見distributionManagement元素 -->
<distributionManagement>
......
</distributionManagement>
<!--參見properties元素 -->
<properties />
</profile>
</profiles>
<!--模塊(有時稱作子項目) 被構(gòu)建成項目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 -->
<modules />
<!--發(fā)現(xiàn)依賴和擴展的遠(yuǎn)程倉庫列表。 -->
<repositories>
<!--包含需要連接到遠(yuǎn)程倉庫的信息 -->
<repository>
<!--如何處理遠(yuǎn)程倉庫里發(fā)布版本的下載 -->
<releases>
<!--true或者false表示該倉庫是否為下載某種類型構(gòu)件(發(fā)布版,快照版)開啟。 -->
<enabled />
<!--該元素指定更新發(fā)生的頻率。Maven會比較本地POM和遠(yuǎn)程POM的時間戳。這里的選項是:always(一直),daily(默認(rèn),每日),interval:X(這里X是以分鐘為單位的時間間隔),或者never(從不)。 -->
<updatePolicy />
<!--當(dāng)Maven驗證構(gòu)件校驗文件失敗時該怎么做:ignore(忽略),fail(失敗),或者warn(警告)。 -->
<checksumPolicy />
</releases>
<!-- 如何處理遠(yuǎn)程倉庫里快照版本的下載。有了releases和snapshots這兩組配置,POM就可以在每個單獨的倉庫中,為每種類型的構(gòu)件采取不同的
策略。例如,可能有人會決定只為開發(fā)目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 -->
<snapshots>
<enabled />
<updatePolicy />
<checksumPolicy />
</snapshots>
<!--遠(yuǎn)程倉庫唯一標(biāo)識符??梢杂脕砥ヅ湓趕ettings.xml文件里配置的遠(yuǎn)程倉庫 -->
<id>banseon-repository-proxy</id>
<!--遠(yuǎn)程倉庫名稱 -->
<name>banseon-repository-proxy</name>
<!--遠(yuǎn)程倉庫URL,按protocol://hostname/path形式 -->
<url>http://192.168.1.169:9999/repository/</url>
<!-- 用于定位和排序構(gòu)件的倉庫布局類型-可以是default(默認(rèn))或者legacy(遺留)。Maven 2為其倉庫提供了一個默認(rèn)的布局;然
而,Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default(默認(rèn))還是legacy(遺留)。 -->
<layout>default</layout>
</repository>
</repositories>
<!--發(fā)現(xiàn)插件的遠(yuǎn)程倉庫列表,這些插件用于構(gòu)建和報表 -->
<pluginRepositories>
<!--包含需要連接到遠(yuǎn)程插件倉庫的信息.參見repositories/repository元素 -->
<pluginRepository>
......
</pluginRepository>
</pluginRepositories>
<!--該元素描述了項目相關(guān)的所有依賴。 這些依賴組成了項目構(gòu)建過程中的一個個環(huán)節(jié)。它們自動從項目定義的倉庫中下載。要獲取更多信息,請看項目依賴機制。 -->
<dependencies>
<dependency>
<!--依賴的group ID -->
<groupId>org.apache.maven</groupId>
<!--依賴的artifact ID -->
<artifactId>maven-artifact</artifactId>
<!--依賴的版本號。 在Maven 2里, 也可以配置成版本號的范圍。 -->
<version>3.8.1</version>
<!-- 依賴類型,默認(rèn)類型是jar。它通常表示依賴的文件的擴展名,但也有例外。一個類型可以被映射成另外一個擴展名或分類器。類型經(jīng)常和使用的打包方式對應(yīng),
盡管這也有例外。一些類型的例子:jar,war,ejb-client和test-jar。如果設(shè)置extensions為 true,就可以在 plugin里定義新的類型。所以前面的類型的例子不完整。 -->
<type>jar</type>
<!-- 依賴的分類器。分類器可以區(qū)分屬于同一個POM,但不同構(gòu)建方式的構(gòu)件。分類器名被附加到文件名的版本號后面。例如,如果你想要構(gòu)建兩個單獨的構(gòu)件成
JAR,一個使用Java 1.4編譯器,另一個使用Java 6編譯器,你就可以使用分類器來生成兩個單獨的JAR構(gòu)件。 -->
<classifier></classifier>
<!--依賴范圍。在項目發(fā)布過程中,幫助決定哪些構(gòu)件被包括進來。欲知詳情請參考依賴機制。 - compile :默認(rèn)范圍,用于編譯 - provided:類似于編譯,但支持你期待jdk或者容器提供,類似于classpath
- runtime: 在執(zhí)行時需要使用 - test: 用于test任務(wù)時使用 - system: 需要外在提供相應(yīng)的元素。通過systemPath來取得
- systemPath: 僅用于范圍為system。提供相應(yīng)的路徑 - optional: 當(dāng)項目自身被依賴時,標(biāo)注依賴是否傳遞。用于連續(xù)依賴時使用 -->
<scope>test</scope>
<!--僅供system范圍使用。注意,不鼓勵使用這個元素,并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規(guī)定了文件系統(tǒng)上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑,例如${java.home}。 -->
<systemPath></systemPath>
<!--當(dāng)計算傳遞依賴時, 從依賴構(gòu)件列表里,列出被排除的依賴構(gòu)件集。即告訴maven你只依賴指定的項目,不依賴項目的依賴。此元素主要用于解決版本沖突問題 -->
<exclusions>
<exclusion>
<artifactId>spring-core</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
</exclusions>
<!--可選依賴,如果你在項目B中把C依賴聲明為可選,你就需要在依賴于B的項目(例如項目A)中顯式的引用對C的依賴??蛇x依賴阻斷依賴的傳遞性。 -->
<optional>true</optional>
</dependency>
</dependencies>
<!--不贊成使用. 現(xiàn)在Maven忽略該元素. -->
<reports></reports>
<!--該元素描述使用報表插件產(chǎn)生報表的規(guī)范。當(dāng)用戶執(zhí)行"mvn site",這些報表就會運行。 在頁面導(dǎo)航欄能看到所有報表的鏈接。 -->
<reporting>
<!--true,則,網(wǎng)站不包括默認(rèn)的報表。這包括"項目信息"菜單中的報表。 -->
<excludeDefaults />
<!--所有產(chǎn)生的報表存放到哪里。默認(rèn)值是${project.build.directory}/site。 -->
<outputDirectory />
<!--使用的報表插件和他們的配置。 -->
<plugins>
<!--plugin元素包含描述報表插件需要的信息 -->
<plugin>
<!--報表插件在倉庫里的group ID -->
<groupId />
<!--報表插件在倉庫里的artifact ID -->
<artifactId />
<!--被使用的報表插件的版本(或版本范圍) -->
<version />
<!--任何配置是否被傳播到子項目 -->
<inherited />
<!--報表插件的配置 -->
<configuration />
<!--一組報表的多重規(guī)范,每個規(guī)范可能有不同的配置。一個規(guī)范(報表集)對應(yīng)一個執(zhí)行目標(biāo) 。例如,有1,2,3,4,5,6,7,8,9個報表。1,2,5構(gòu)成A報表集,對應(yīng)一個執(zhí)行目標(biāo)。2,5,8構(gòu)成B報表集,對應(yīng)另一個執(zhí)行目標(biāo) -->
<reportSets>
<!--表示報表的一個集合,以及產(chǎn)生該集合的配置 -->
<reportSet>
<!--報表集合的唯一標(biāo)識符,POM繼承時用到 -->
<id />
<!--產(chǎn)生報表集合時,被使用的報表的配置 -->
<configuration />
<!--配置是否被繼承到子POMs -->
<inherited />
<!--這個集合里使用到哪些報表 -->
<reports />
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>
<!-- 繼承自該項目的所有子項目的默認(rèn)依賴信息。這部分的依賴信息不會被立即解析,而是當(dāng)子項目聲明一個依賴(必須描述group ID和 artifact
ID信息),如果group ID和artifact ID以外的一些信息沒有描述,則通過group ID和artifact ID 匹配到這里的依賴,并使用這里的依賴信息。 -->
<dependencyManagement>
<dependencies>
<!--參見dependencies/dependency元素 -->
<dependency>
......
</dependency>
</dependencies>
</dependencyManagement>
<!--項目分發(fā)信息,在執(zhí)行mvn deploy后表示要發(fā)布的位置。有了這些信息就可以把網(wǎng)站部署到遠(yuǎn)程服務(wù)器或者把構(gòu)件部署到遠(yuǎn)程倉庫。 -->
<distributionManagement>
<!--部署項目產(chǎn)生的構(gòu)件到遠(yuǎn)程倉庫需要的信息 -->
<repository>
<!--是分配給快照一個唯一的版本號(由時間戳和構(gòu)建流水號)?還是每次都使用相同的版本號?參見repositories/repository元素 -->
<uniqueVersion />
<id>banseon-maven2</id>
<name>banseon maven2</name>
<url>file://${basedir}/target/deploy</url>
<layout />
</repository>
<!--構(gòu)件的快照部署到哪里?如果沒有配置該元素,默認(rèn)部署到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>
<!--部署項目的網(wǎng)站需要的信息 -->
<site>
<!--部署位置的唯一標(biāo)識符,用來匹配站點和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。如果沒有該元素,用戶應(yīng)該參考主頁。使用該元素的原因是:幫助定位那些不在倉庫里的構(gòu)件(由于license限制)。 -->
<downloadUrl />
<!--如果構(gòu)件有了新的group ID和artifact ID(構(gòu)件移到了新的位置),這里列出構(gòu)件的重定位信息。 -->
<relocation>
<!--構(gòu)件新的group ID -->
<groupId />
<!--構(gòu)件新的artifact ID -->
<artifactId />
<!--構(gòu)件新的版本號 -->
<version />
<!--顯示給用戶的,關(guān)于移動的額外信息,例如原因。 -->
<message />
</relocation>
<!-- 給出該構(gòu)件在遠(yuǎn)程倉庫的狀態(tài)。不得在本地項目中設(shè)置該元素,因為這是工具自動更新的。有效的值有:none(默認(rèn)),converted(倉庫管理員從
Maven 1 POM轉(zhuǎn)換過來),partner(直接從伙伴Maven 2倉庫同步過來),deployed(從Maven 2實例部 署),verified(被核實時正確的和最終的)。 -->
<status />
</distributionManagement>
<!--以值替代名稱,Properties可以在整個POM中使用,也可以作為觸發(fā)條件(見settings.xml配置文件里activation元素的說明)。格式是<name>value</name>。 -->
<properties />
</project>
以上就是詳解Maven POM(項目對象模型)的詳細(xì)內(nèi)容,更多關(guān)于Maven POM(項目對象模型)的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
Java數(shù)據(jù)庫連接池技術(shù)的入門教程
這篇文章主要給大家介紹了關(guān)于Java數(shù)據(jù)庫連接池技術(shù)的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-03-03
SpringBoot項目中改變web服務(wù)的路徑的兩種方案
這篇文章主要介紹了SpringBoot項目中改變web服務(wù)的路徑的兩種方案,通過代碼示例講解的非常詳細(xì),對大家的學(xué)習(xí)或工作有一定的幫助,需要的朋友可以參考下2024-08-08
Java中synchronized?的4個優(yōu)化技巧
本文主要介紹了Java中synchronized的4個優(yōu)化技巧,synchronized在JDK?1.5?時性能是比較低的,然而在后續(xù)的版本中經(jīng)過各種優(yōu)化迭代,它的性能也得到了前所未有的提升,下文更多相關(guān)資料需要的小伙伴可以參考一下2022-05-05
SpringBoot項目啟動報錯:命令行太長解決的兩種解決方法
SpringBoot項目啟動時可能會遇到命令行太長的錯誤,本文介紹兩種解決方法修改.idea\workspace.xml文件和執(zhí)行maven的clean命令或重啟IDEA,這些操作可以有效解決啟動問題,需要的朋友可以參考下2024-10-10

