maven總結 | 超詳細的Maven實戰配置資料
- 2020 年 3 月 31 日
- 筆記
概述
- Maven是一個項目管理和綜合工具。
- Maven 翻譯為"專家"、"內行",是 Apache 下的一個純 Java 開發的開源項目 。
- 利用一個中央資訊片斷能管理一個項目的構建、報告和文檔等步驟 。
- 基於項目對象模型(POM) ,可以通過一小段描述資訊來管理項目的構建,報告和文檔的項目管理工具軟體 。
- 可以對 java、C#,Ruby,Scala 和其他語言編寫的項目進行構建、依賴管理 。
功能
- 在多個開發團隊環境時,Maven可以設置按標準在非常短的時間裡完成配置工作。由於大部分項目的設置都很簡單,並且可重複使用,Maven讓開發人員的工作更輕鬆,同時創建報表,檢查,構建和測試自動化設置。
- Maven 能夠幫助開發者完成以下工作 :
- Builds #構建 Documentation #文檔生成 Reporting #報告 Dependencies #依賴 SCMs #SCMs Releases #發布 Distribution #分發 mailing list #郵件列
- 概括地說,Maven簡化和標準化項目建設過程。處理編譯,分配,文檔,團隊協作和其他任務的無縫連接。Maven增加可重用性並負責建立相關的任務。
特點
- 項目設置遵循統一的規則
- 任意工程中共享
- 依賴管理包括自動更新
- 一個龐大且不斷增長的庫
- 可擴展,能夠輕鬆編寫 Java 或腳本語言的插件
- 只需很少或不需要額外配置即可即時訪問新功能
- 基於模型的構建 − Maven能夠將任意數量的項目構建到預定義的輸出類型中,如 JAR,WAR 或基於項目元數據的分發,而不需要在大多數情況下執行任何腳本
- 項目資訊的一致性站點 − 使用與構建過程相同的元數據,Maven 能夠生成一個網站或PDF,包括您要添加的任何文檔,並添加到關於項目開發狀態的標準報告中
- 發布管理和發布單獨的輸出 − Maven 將不需要額外的配置,就可以與源程式碼管理系統(如 Subversion 或 Git)集成,並可以基於某個標籤管理項目的發布。它也可以將其發布到分發位置供其他項目使用。Maven 能夠發布單獨的輸出,如 JAR,包含其他依賴和文檔的歸檔,或者作為源程式碼發布
- 向後兼容性 − 您可以很輕鬆的從舊版本 Maven 的多個模組移植到 Maven 3 中
- 子項目使用父項目依賴時,正常情況子項目應該繼承父項目依賴,無需使用版本號
- 並行構建 − 編譯的速度能普遍提高20 – 50 %
- 更好的錯誤報告 − Maven 改進了錯誤報告,它為您提供了 Maven wiki 頁面的鏈接,您可以點擊鏈接查看錯誤的完整描述
下載、安裝
- 環境要求
- Maven 是一個基於 Java 的工具,所以要做的第一件事情就是安裝 JDK 。
項目 |
要求 |
---|---|
JDK |
Maven 3.3 要求 JDK 1.7 或以上 Maven 3.2 要求 JDK 1.6 或以上 Maven 3.0/3.1 要求 JDK 1.5 或以上 |
記憶體 |
無 |
磁碟 |
Maven 自身安裝需要大約 10 MB 空間 |
作業系統 |
無 |
- 下載:
- windows:*-bin-zip
- linux、mac:*-bin-tar-gz
- 官網:http://maven.apache.org/download.cgi
- 不同平台,下載不同文件包:
- 安裝:
- 下載解壓
#下載 wget http://mirror.bit.edu.cn/apache/maven/maven-3/3.6.0/binaries/apache-maven-3.6.0-bin.tar.gz #解壓 tar -zvxf apache-maven-3.6.0-bin.tar.gz #授權 sudo mv -f apache-maven-3.6.0 /usr/local/
- 編輯 /etc/profile 文件 sudo vim /etc/profile,在文件末尾添加如下程式碼:
export MAVEN_HOME=/usr/local/apache-maven-3.6.0 export PATH=${PATH}:${MAVEN_HOME}/bin
- 保存文件,並運行如下命令使環境變數生效:
#使文件生效 source /etc/profile
- 在控制台輸入如下命令,如果能看到 Maven 相關版本資訊,則說明 Maven 已經安裝成功
mvn -v
- 解壓下載的文件:apache-maven-3.6.0-bin.zip
- 添加 M2_HOME 和 MAVEN_HOME
- 在控制台輸入如下命令,如果能看到 Maven 相關版本資訊,則說明 Maven 已經安裝成功
- 右鍵 "電腦",選擇 "屬性",之後點擊 "高級系統設置",點擊"環境變數",來設置環境變數,有以下系統變數需要配置:
- 新建系統變數 MAVEN_HOME

- 編輯系統變數 Path,添加變數值:;%MAVEN_HOME%bin

- 注意:注意多個值之間需要有分號隔開,然後點擊確定。
- windows:
- linux:
- mac:
POM
- POM( Project Object Model,項目對象模型 ) 是 Maven 工程的基本工作單元,是一個XML文件
- 包含了項目的基本資訊,用於描述項目如何構建,聲明項目依賴等
- POM 中可以指定以下配置 :
- 項目依賴
- 插件
- 執行目標
- 項目構建 profile
- 項目版本
- 項目開發者列表
- 相關郵件列表資訊
- 示例:
<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>
<!-- 公司或者組織的唯一標誌,並且配置時生成的路徑也是由此生成, 如com.companyname.project-group,maven會將該項目打成的jar包放本地路徑:/com/companyname/project-group -->
<groupId>com.companyname.project-group</groupId>
<!-- 項目的唯一ID,一個groupId下面可能多個項目,就是靠artifactId來區分的 -->
<artifactId>project</artifactId>
<!-- 版本號 -->
<version>1.0</version>
</project>
- 所有 POM 文件都需要 project 元素和三個必需欄位:groupId,artifactId,version。
- project:工程的根標籤 modelVersion:模型版本 groupId:這是工程組的標識。它在一個組織或者項目中通常是唯一的 artifactId:這是工程的標識。它通常是工程的名稱 version:這是工程的版本號。在 artifact 的倉庫中,它用來區分不同的版本
POM標籤大全
<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>
生命周期
- Maven 構建生命周期定義了一個項目構建跟發布的過程
- 一個典型的 Maven 構建(build)生命周期是由以下幾個階段的序列組成的:
- validate:驗證—–驗證項目—-驗證項目是否正確且所有必須資訊是可用的 compile:編譯—–執行編譯—-源程式碼編譯在此階段完成 test: 測試—–測試——–使用適當的單元測試框架(例如JUnit)運行測試 package:包裝—–打包——–創建JAR/WAR包如在 pom.xml 中定義提及的包 verify:檢查—–檢查——–對集成測試的結果進行檢查,以保證品質達標 install:安裝—–安裝——–安裝打包的項目到本地倉庫,以供其他項目使用 deploy:部署—–部署——–拷貝最終的工程包到遠程倉庫中,以共享給其他開發人員和工程
- Clean生命周期
- pre-clean:執行一些需要在clean之前完成的工作
- clean:移除所有上一次構建生成的文件
- post-clean:執行一些需要在clean之後立刻完成的工作
- 當我們執行 mvn post-clean 命令時,Maven 調用 clean 生命周期,它包含以下階段
- Default(build)生命周期
- 在開發環境中,使用下面的命令去構建、安裝工程到本地倉庫
mvn install
- 這是 Maven 的主要生命周期,被用於構建應用 ,包含23個階段
- 命令行調用:
- Site生命周期
- Site 插件一般用來創建新的報告文檔、部署站點等
倉庫
- 在 Maven 的術語中,倉庫是一個位置(place)
- Maven 倉庫是項目中依賴的第三方庫,這個庫所在的位置叫做倉庫
- 在 Maven 中,任何一個依賴、插件或者項目構建的輸出,都可以稱之為構件
- Maven 倉庫能幫助我們管理構件(主要是JAR),它就是放置所有JAR文件(WAR,ZIP,POM等等)的地方
- Maven 倉庫有三種類型 :
- 本地(local)
- 中央(central)
- 遠程(remote)
本地倉庫
- Maven 的本地倉庫,在安裝 Maven 後並不會創建 ,它是在第一次執行 maven 命令的時候才被創建
- 運行 Maven 的時候,Maven 所需要的任何構件都是直接從本地倉庫獲取的。如果本地倉庫沒有,它會首先嘗試從遠程倉庫下載構件至本地倉庫,然後再使用本地倉庫的構件
- 默認情況下,不管Linux還是 Windows,每個用戶在自己的用戶目錄下都有一個路徑名為 .m2/respository/ 的倉庫目錄
- Maven 本地倉庫默認被創建在 %USER_HOME% 目錄下。要修改默認位置,在 %M2_HOME%conf 目錄中的 Maven 的 settings.xml 文件中定義另一個路徑。
<settings
xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository>C:/MyLocalRepository</localRepository>
</settings>
- 當你運行 Maven 命令,Maven 將下載依賴的文件到你指定的路徑中
中央倉庫
- Maven 中央倉庫是由 Maven 社區提供的倉庫,其中包含了大量常用的庫
- 中央倉庫包含了絕大多數流行的開源Java構件,以及源碼、作者資訊、SCM、資訊、許可證資訊等
- 中央倉庫的關鍵概念 :
- 這個倉庫由 Maven 社區管理
- 不需要配置
- 需要通過網路才能訪問
- 要瀏覽中央倉庫的內容,maven 社區提供了一個 URL:http://search.maven.org/#browse。使用這個倉庫,開發人員可以搜索所有可以獲取的程式碼庫
遠程倉庫
- 如果 Maven 在中央倉庫中也找不到依賴的文件,它會停止構建過程並輸出錯誤資訊到控制台。為避免這種情況,Maven 提供了遠程倉庫的概念,它是開發人員自己訂製倉庫,包含了所需要的程式碼庫或者其他工程中用到的 jar 文件
倉庫搜索順序
當我們執行 Maven 構建命令時,Maven 開始按照以下順序查找依賴的庫 :
- 步驟 1 - 在本地倉庫中搜索,如果找不到,執行步驟 2,如果找到了則執行其他操作
- 步驟 2 - 在中央倉庫中搜索,如果找不到,並且有一個或多個遠程倉庫已經設置,則執行步驟 4,如果找到了則下載到本地倉庫中以備將來引用
- 步驟 3 - 如果遠程倉庫沒有被設置,Maven 將簡單的停滯處理並拋出錯誤(無法找到依賴的文件)
- 步驟 4 - 在一個或多個遠程倉庫中搜索依賴的文件,如果找到則下載到本地倉庫以備將來引用,否則 Maven 將停止處理並拋出錯誤(無法找到依賴的文件)
配置阿里雲倉庫
- Maven 倉庫默認在國外, 中國使用難免很慢,我們可以更換為阿里雲的倉庫。
- 第一步:修改 maven 根目錄下的 conf 文件夾中的 setting.xml 文件,在 mirrors 節點上,添加內容如下:
<mirrors> <mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors>
- 第二步: pom.xml文件里添加:
<repositories> <repository> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories>