保姆級神器 Maven,再也不用擔心專案構建搞崩了

沉默王二發表於2021-11-23

今天來給大家介紹一款專案構建神器——Maven,不僅能幫我們自動化構建,還能夠抽象構建過程,提供構建任務實現;它跨平臺,對外提供了一致的操作介面,這一切足以使它成為優秀的、流行的構建工具,從此以後,再也不用擔心專案搞崩了。

PS:星標這種事,只能求,不求沒效果,come on。《Java 程式設計師進階之路》在 GitHub 上已經收穫了 675 枚星標,小夥伴們趕緊去點點了,衝 700 啦

https://github.com/itwanger/toBeBetterJavaer

總結一下 Maven 的優點,主要有以下 3 點:

  • 依賴管理:Maven 能幫助我們解決軟體包依賴的管理問題,不再需要提交大量的 jar 包、引入第三方庫;
  • 規範目錄結構:Maven 標準的目錄結構有助於專案構建的標準化,通過配置 profile 還可以根據不同的環境(開發環境、測試環境,生產環境)讀取不同的配置檔案;
  • 方便整合:能夠整合在 IDE 中更方便使用。

一、安裝 Maven

由於 JDK 是 Maven 安裝的前置條件,所以請使用 java -version 確認是否已經安裝了 JDK:

我本人使用的是 macOS,所以可以有兩種安裝方式,一種官網下載,手動安裝;一種直接使用 brew 一鍵安裝

我們先介紹官網下載,手動安裝,該方式同樣適用於 Windows 系統,差別可參照 Maven 官網安裝教程:

http://maven.apache.org/install.html

1)一種官網下載,手動安裝

第一步,去官網下載 Maven 安裝包:

官網地址:http://maven.apache.org/download.cgi

很多初學者在官網下載的時候不知道選哪一個,這裡做一下簡單的介紹。

  • bin(binary)代表由 Java 原始檔編譯後的二進位制 class 檔案,src(source)代表Java 原始檔。
  • 一般情況下,選擇 bin 檔案進行安裝就 OK 了;如果你想自己編譯,可選 src 版本。
  • tar.gz 壓縮格式適用於 Unix 作業系統,zip 適用於 Windows 作業系統;但不是絕對的。

第二步,解壓下載的安裝包,複製該路徑:

  • bin 目錄:該包含了 Maven 執行的所有指令碼,用來配置 Java 命令,準備執行環境,然後執行 Java 命令。
  • boot 目錄:該目錄只包含了一個 plexus-classworlds-xxx-jar 檔案,該檔案是一個類載入器框架,相當於預設的 Java 類載入器,提供了更加豐富的語法以便配置,Maven 使用該載入器載入自己的類庫。
  • conf 目錄:該目錄包含了一個非常重要的檔案 settings.xml。可以直接修改該檔案,用來全域性定製 Maven 的行為;也可以複製該檔案到 ~/.m2/ 目錄下(~表示使用者目錄),修改該檔案可以在使用者範圍內定製 Maven 的行為。
  • lib 目錄:該目錄包含了Maven執行時所需要的 Java 類庫,包括Maven 依賴的第三方類庫,比如 slf4j-api.jar。

第三步,配置環境變數

開啟終端,輸入 vim ~/.bash_profile 命令開啟 bash_profile 檔案:

bash_profile 檔案用於配置環境變數和啟動程式,詳細介紹可參照:

https://www.cnblogs.com/kevingrace/p/8072860.html

在檔案中新增設定環境變數的命令:

export M2_HOME=/Users/maweiqing/cmower/save/apache-maven-3.8.3
export PATH=${PATH}:${M2_HOME}/bin

儲存後退出,可以執行 source ~/.bash_profile 使配置生效:

第四步,檢視配置是否生效

輸入 mvn -v 命令,如果輸出以下內容,表示配置成功:

如未生效,可再開一個終端視窗嘗試 mvn -v 命令。

2)brew 一鍵安裝

第一步,使用 brew install maven 命令一鍵安裝,並自動配置環境變數

第二步,使用 mvn -v 命令檢視版本

二、Maven 配置檔案大盤點

Maven 是基於 POM(Project Object Model) 進行的,專案的所有配置都會放在 pom.xml 檔案中,包括專案的型別、名字,依賴關係,外掛定製等等。

<?xml version="1.0" encoding="UTF-8"?>
<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>
    <groupId>com.itwanger</groupId>
    <artifactId>MavenDemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>MavenDemo</name>
</project>
  • 第一行是XML頭,指定了該xml文件的版本和編碼方式。
  • project 是根元素,宣告瞭一些POM相關的名稱空間及xsd元素。
  • modelVersion指定了當前POM的版本,對於Maven 3來說,值只能是4.0.0。
  • groupId定義了專案屬於哪個組織,通常是組織域名的倒序,比如說我的域名是 itwanger.com,所以groupId就是 com.itwanger。
  • artifactId定義了專案在組織中的唯一ID。
  • version指定了專案當前的版本,SNAPSHOT意為快照,說明該專案還處於開發中。
  • name 宣告瞭一個對於使用者更為友好的專案名稱。

groupId、artifactId和version這三個元素定義了一個專案的基本座標,在Maven的世界裡,任何的jar和pom都是以基於這些座標進行區分的。

<project>
...
<dependencies>
    <dependency>
        <groupId>實際專案</groupId>
     <artifactId>模組</artifactId>
     <version>版本</version>
     <type>依賴型別</type>
     <scope>依賴範圍</scope>
     <optional>依賴是否可選</optional>
     <!—主要用於排除傳遞性依賴-->
     <exclusions>
         <exclusion>
           <groupId></groupId>
          <artifactId></artifactId>
       </exclusion>
     </exclusions>
  </dependency>
<dependencies>
...
</project>
  • dependencies 可以包含一個或者多個dependency元素,以宣告一個或者多個專案依賴。
  • grounpId、artifactId和version 組成了依賴的基本座標。
  • type 指定了依賴的型別,預設為 jar。
  • scope 指定了依賴的範圍(詳情見下面依賴範圍部分)。
  • optional 標記了依賴是否是可選的(詳情見下面依賴可選部分)。
  • exclusions 用來排除傳遞性依賴(詳情見下面依賴排除部分)。

依賴範圍有以下幾種:

  • compile,預設的依賴範圍,表示依賴需要參與當前專案的編譯,後續的測試、執行週期也參與其中,是比較強的依賴。
  • test,表示依賴僅僅參與測試相關的工作,包括測試程式碼的編譯和執行。比較典型的如 junit。
  • runntime,表示依賴無需參與到專案的編譯,不過後期的測試和執行需要其參與其中。
  • provided,表示打包的時候可以不用包進去,別的容器會提供。和 compile 相當,但是在打包階段做了排除的動作。
  • system,從參與程度上來說,和 provided 類似,但不通過 Maven 倉庫解析,可能會造成構建的不可移植,要謹慎使用。

關於傳遞性依賴

比如一個account-email專案為例,account-email有一個compile範圍的spring-code依賴,spring-code有一個compile範圍的commons-logging依賴,那麼commons-logging就會成為account-email的compile的範圍依賴,commons-logging是account-email的一個傳遞性依賴:

有了傳遞性依賴機制,在使用Spring Framework的時候就不用去考慮它依賴了什麼,也不用擔心引入多餘的依賴。Maven會解析各個直接依賴的POM,將那些必要的間接依賴,以傳遞性依賴的形式引入到當前的專案中。

關於依賴可選

專案中A依賴B,B依賴於X和Y,如果所有這三個的範圍都是compile的話,那麼X和Y就是A的compile範圍的傳遞性依賴,但是如果我想X、Y不作為A的傳遞性依賴,不給它用的話,可以按照下面的方式配置可選依賴:

<project>  
    <modelVersion>4.0.0</modelVersion>  
    <groupId>com.itwanger</groupId>  
    <artifactId>project-b</artifactId>  
    <version>1.0.0</version>  
    <dependencies>  
        <dependency>  
            <groupId>mysql</groupId>  
            <artifactId>mysql-connector-java</artifactId>  
            <version>5.1.10</version>  
            <optional>true</optional>  
        </dependency>  
        <dependency>  
            <groupId>postgresql</groupId>  
            <artifactId>postgresql</groupId>  
            <version>8.4-701.jdbc3</version>  
            <optional>true</optional>  
        </dependency>  
    </dependencies>  
</project>

關於依賴排除

有時候你引入的依賴中包含你不想要的依賴包,你想引入自己想要的,這時候就要用到排除依賴了,比如下圖中spring-boot-starter-web自帶了logback這個日誌包,我想引入log4j2的,所以我先排除掉logback的依賴包,再引入想要的包就行了。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.5.6</version>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- 使用 log4j2 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
    <version>2.5.6</version>
</dependency>

宣告exclustion的時候只需要groupId和artifactId,不需要version元素,因為groupId和artifactId就能唯一定位某個依賴。

三、Maven 倉庫

在 Maven 的術語中,倉庫是一個位置(place),專案中依賴的第三方庫以及外掛(可統稱為構件),都放在這裡。所有的 Maven 專案都可以共享這個倉庫,只需要根據依賴的座標,就可以在需要的時候找到倉庫中的依賴,並使用它們。

舉個例子,專案中使用了分頁外掛的依賴:

<dependency>
      <groupId>com.github.pagehelper</groupId>
      <artifactId>pagehelper-spring-boot-starter</artifactId>
      <version>1.1.0</version>
</dependency>

那麼它對應的倉庫路徑是這樣的:

倉庫可以以下幾種:

1)本地倉庫

當Maven在執行編譯或測試時,如果需要使用依賴檔案,它總是基於座標使用本地倉庫的依賴檔案。

預設情況下,不管是Window還是macOS,或者是 Linux,每個使用者都會在自己的使用者目錄下有一個路徑名為 .m2/repository/ 的倉庫目錄。

如果你想自定義本地倉庫目錄地址,可以編輯檔案~/.m2/settings.xml,設定localRepository元素的值為你想要的倉庫地址,例如:

<localRepository>/path/to/local/repo</localRepository>

如果找不到 ~/.m2/settings.xml 的話,可以到 Maven 的安裝目錄(前文提到的 conf 目錄)下去拷貝。

2)遠端倉庫

預設情況下,本地倉庫是被註釋掉的,也就是空的,那麼就必須得給 Maven 配置一個可用的遠端倉庫,否則 Maven 在 build(構建)的時候就無法去下載依賴。

中央倉庫就是這樣一個可用的遠端倉庫,裡面包含了這個世界上絕大多數流行的開源 Java 類庫,以及原始碼、作者資訊、許可證資訊等等。

不過,預設的中央倉庫訪問速度比較慢,通常我們會選擇使用阿里的 Maven 遠端倉庫。

<repositories>
    <repository>
        <id>ali-maven</id>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
            <checksumPolicy>fail</checksumPolicy>
        </snapshots>
    </repository>
</repositories>
  • repositories 可以包含一個或者多個repository元素,以宣告一個或者多個倉庫。
  • id,倉庫宣告的唯一id,需要注意的是,Maven自帶的中央倉庫使用的id為central,如果其他倉庫也使用了該id,就會覆蓋中央倉庫的配置。
  • url,指向了倉庫的地址。
  • releases和snapshots,用來控制Maven對於釋出版構件和快照版構件的下載許可權。
  • enabled子元素為 true 時表示可以從倉庫下載釋出版構件和快照版構件。
  • updatePolicy 子元素用來配置Maven從遠處倉庫檢查更新的頻率。
  • 預設值是daily,表示每天檢查一次;
  • 可選值 never 表示從不檢查;
  • 可選值always表示每次構建時檢查更新;
  • 可選值interval表示每隔X分鐘檢查一次更新(X為任意整數)。
  • checksumPolicy 子元素用來配置Maven檢查校驗的策略。在下載構件的時候,Maven會去校驗,如果校驗失敗,
  • 當checksumPolicy的值為預設的warn時,Maven會在執行構建時輸出警告資訊;
  • 值為fail 時,Maven遇到校驗錯誤就讓構建失敗;
  • 值為ignore時,Maven將完全忽略校驗。

搭建遠端倉庫的另外一個目的是方便部署我們自己的專案構件至遠端倉庫供其他團隊成員使用,這時候需要配置distributionManagement元素:

<distributionManagement>
        <repository>
            <id>releases</id>
            <name>public</name>
            <url>http://59.50.95.66:8081/nexus/content/repositories/releases</url>
        </repository>
        <snapshotRepository>
            <id>snapshots</id>
            <name>Snapshots</name>
            <url>http://59.50.95.66:8081/nexus/content/repositories/snapshots</url>
        </snapshotRepository>
</distributionManagement>
  • repository表示釋出版本構件的倉庫。
  • snapshotRepository 表示快照版本(開發測試用)的倉庫。
  • 這兩個元素都需要配置id、name和url,id為遠端倉庫的唯一標識,name是為了方便閱讀,url表示倉庫的地址。

配置好了以後執行命令 mvn clean deploy,Maven就會將專案部署到對應的遠端倉庫。專案是快照還是釋出版本通過之前遠端倉庫配置項中的 releases 和 snapshots 來區分。

3)倉庫映象

如果倉庫X可以提供倉庫Y儲存的所有內容,那麼就可以認為X是Y的一個映象。通常我們會在 settings.xml 檔案中新增阿里雲映象:

<mirrors>
    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <mirrorOf>central</mirrorOf>        
    </mirror>
  </mirrors>

其中 mirrorOf 元素的可選項有:

  • *,匹配所有遠端倉庫。
  • external:*,匹配所有遠端倉庫,使用localhost的除外,使用 file:// 協議的除外。也就是說,匹配所有不在本機上的遠端倉庫。
  • repo1,repo2,匹配倉庫repo1和repo2,使用逗號分隔多個遠端倉庫。
  • *,!repo1,匹配所有遠端倉庫,repo1除外,使用感嘆號將倉庫從匹配中排除。

上例中 <mirrorOf>central</mirrorOf> 表示任何對於中央倉庫的請求都會轉至該映象。

4)私服

私服是一種特殊的遠端倉庫,它架設在區域網內中,私服代理廣域網上的遠端倉庫,供區域網內的Maven使用者使用。當Maven需要下載構件的時候,先從私服請求,如果私服上不存在該構件,則從外部的遠端倉庫下載,並快取到私服上。

私服有以下好處:

  • 節省外網訪問速度
  • 加速Maven構建
  • 提高穩定性,增強控制
  • 降低中央倉庫的負荷

5)倉庫服務搜尋

推薦 2 個提供倉庫搜尋服務的網站:

四、使用 Maven

1)Maven 常見命令

  • mvn clean:表示執行清理操作(會預設把target資料夾中的資料清理)。
  • mvn clean compile:表示先執行清理之後執行編譯,會將程式碼編譯到target資料夾中。
  • mvn clean test:執行清理和測試。
  • mvn clean package:執行清理和打包。
  • mvn clean install:執行清理和安裝,會將打好的包安裝到本地倉庫中,以便其他的專案可以呼叫。
  • mvn clean deploy:執行清理和釋出(釋出到私服上面)。

2)Maven 常用 POM 屬性

  • ${project.build.sourceDirectory}:專案的主原始碼目錄,預設為src/main/java/
  • ${project.build.testSourceDirectory}:專案的測試原始碼目錄,預設為 /src/test/java/
  • ${project.build.directory}:專案構建輸出目錄,預設為 target/
  • ${project.build.outputDirectory}:專案主程式碼編譯輸出目錄,預設為 target/classes/
  • ${project.build.testOutputDirectory}:專案測試程式碼編譯輸出目錄,預設為 target/testclasses/
  • ${project.groupId}:專案的 groupId.
  • ${project.artifactId}:專案的 artifactId.
  • ${project.version}:專案的 version,於 ${version} 等價
  • ${project.build.finalName}:專案打包輸出檔案的名稱,預設為${project.artifactId}${project.version}

3)Intellij IDEA 配置 Maven

4)Maven 常用外掛

外掛是Maven的核心功能,它允許在多個專案中重用通用的構建邏輯。外掛可用於:

  • 建立jar檔案,
  • 建立war檔案,
  • 編譯程式碼,
  • 單元測試程式碼,
  • 建立專案文件等。

常用的外掛有:

  • maven-antrun-plugin,讓使用者在 Maven 專案中執行 Ant 任務。使用者可以直接在該外掛的配置以 Ant 的方式編寫 Target,然後交給該外掛的 run 目標去執行。在一些由 Ant 往 Maven 遷移的專案中,該外掛尤其有用。此外當你發現需要編寫一些自定義程度很高的任務,同時又覺得 Maven 不夠靈活時,也可以以 Ant 的方式實現之。maven-antrun-plugin 的 run 目標通常與生命週期繫結執行。
  • maven-assembly-plugin,製作專案分發包,該分發包可能包含了專案的可執行檔案、原始碼、readme、平臺指令碼等等。maven-assembly-plugin 支援各種主流的格式如 zip、tar.gz、jar 和 war 等,具體打包哪些檔案是高度可控的,例如使用者可以按檔案級別的粒度、檔案集級別的粒度、模組級別的粒度、以及依賴級別的粒度控制打包,此外,包含和排除配置也是支援的。maven-assembly-plugin 要求使用者使用一個名為assembly.xml的後設資料檔案來表述打包,它的 single 目標可以直接在命令列呼叫,也可以被繫結至生命週期。
  • maven-help-plugin,一個小巧的輔助工具,最簡單的help:system可以列印所有可用的環境變數和 Java 系統屬性。help:effective-pom和help:effective-settings最為有用,它們分別列印專案的有效 POM 和有效 settings,有效 POM 是指合併了所有父 POM(包括 Super POM)後的 XML,當你不確定 POM 的某些資訊從何而來時,就可以檢視有效 POM。
  • maven-javadoc-plugin,javadoc 外掛,將原始碼的 javadoc 釋出出去。

參考連結:

嘟嘟MD:http://tengj.top/2018/01/01/maven/
杭建:《Java 工程師修煉之道》
許曉斌:https://www.infoq.cn/article/2011/04/xxb-maven-7-plugin

希望大家能在閱讀完本篇文章後對 Maven 有一個初步的瞭解和掌握,並將這些技能在專案的實戰中加以練習,以達到專案工程化的要求。

這是《Java 程式設計師進階之路》專欄的第 72 篇(記得去點個 star 哦)。該專欄風趣幽默、通俗易懂,對 Java 愛好者極度友好和舒適?,內容包括但不限於 Java 基礎、Java 集合框架、Java IO、Java 併發程式設計、Java 虛擬機器、Java 企業級開發(SSM、Spring Boot)等核心知識點

https://github.com/itwanger/toBeBetterJavaer

相關文章