Maven

🍅 Java學習路線：搬磚工的Java學習路線
🍅 作者：程式員小王
🍅 程式員小王的博客：https://www.wolai.com/wnaghengjie/ahNwvAUPG2Hb1Sy7Z8waaF
🍅 掃描主頁左側二維碼，加我微信 一起學習、一起進步
🍅 歡迎點贊 👍 收藏 ?留言 📝

溫馨提示：如果需要詳細的線下筆記，PDF檔案方便保存，可以關注公眾號“程式員小王”回復“maven”領取PDF版本筆記

一、什么是Maven?

Maven 是一個專案管理工具，它包含了一個專案物件模型 (POM：Project Object Model)
是apache組織 開源的 專案構建工具
專案構建：指的是一個專案創建，編譯，測驗，打包（jar包：java專案|War包：javaWeb專案），部署
        維護等流程

二、為什么要用Maven?

1、maven構建的專案可以在多個IDE（集成開發環境）中移植

1、maven構建的專案可以在多個IDE（集成開發環境）中移植
   常見的IDE：IDEA、MyEclipse、Eclipse

2. maven支持本地部署，遠程熱部署

2. maven支持本地部署，遠程熱部署

   熱部署：在不關閉服務器的前提下部署專案應用

本地部署：服務器和開發環境放在同一個電腦上

遠程部署：服務器和開發環境不在同一個電腦上

遠程熱部署：在不停機的情況下，遠程進行熱部署

3、支持持續集成|持續發布（持續上線）

3、支持持續集成|持續發布（持續上線）
   Maven工具可以指定發布任務，在指定時間點，會自動完成專案編譯，測驗，打包，部署功能，
   如果專案一旦出現bug,出現的例外資訊會以報告的形式發送到指定郵箱（**解放人力** ）
       00:00 一次上線  bug 發送報告
       01:00 二次上線  如果第二次上線成功，第三次上線自動取消
       02:00  成功

傳統專案上線，當天凌晨所有程式員在那里等著

maven構建上線任務

    00:00 一次上線（自動 編譯，測驗，打包，部署）

               產生bug,將錯誤資訊，以報告形式發送到指定郵箱

    01:00 二次上線（自動 編譯，測驗，打包，部署）

               產生bug,將錯誤資訊，以報告形式發送到指定郵箱

              **如果第二次上線成功，第三次上線自動取消** 

    02:00 三次上線（自動 編譯，測驗，打包，部署） 成功

4、自動構建專案依賴（節省存盤資源，避免jar包沖突問題）

4、自動構建專案依賴（節省存盤資源，避免jar包沖突問題）
  倉庫（依賴 jar包）
  maven只引入框架核心jar包，自動解決jar包沖突問題，不需要負責粘貼jar包
  *注意：maven引入的是jar包的坐標
  
    一個jar包對應著有一個坐標
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.4.6</version>
  </dependency>

構建依賴分析：

通過分析發現：
maven 工程中不直接將 jar 包匯入到工程中，而是通過在 pom.xml 檔案中添加所需 jar包的坐標，
這樣就很好的避免了 jar 直接引入進來，在需要用到 jar 包的時候，只要查找 pom.xml 檔案，
再通過 pom.xml 檔案中的坐標，到一個專門用于”存放 jar 包的倉庫”(maven 倉庫)中根據坐標從
而找到這些 jar 包，再把這些 jar 包拿去運行，

那么問題來了
1：”存放 jar 包的倉庫”長什么樣？

2：通過讀取 pom.xml 檔案中的坐標，再到倉庫中找到 jar 包，會不會很慢？從而導致這種方式
不可行！

第一個問題：存放 jar 包的倉庫長什么樣，這一點我們后期會分析倉庫的分類，也會帶大家去看我們
的本地的倉庫長什么樣，

第二個問題：通過 pom.xml 檔案配置要引入的 jar 包的坐標，再讀取坐標并到倉庫中加載 jar 包，這
樣我們就可以直接使用 jar 包了，為了解決這個程序中速度慢的問題，maven 中也有**索引** 的概念，通
過建立索引，可以大大提高加載 jar 包的速度，使得我們認為 jar 包基本跟放在本地的工程檔案中再
讀取出來的速度是一樣的，這個程序就好比我們查閱字典時，為了能夠加快查找到內容，書前面的
目錄就好比是索引，有了這個目錄我們就可以方便找到內容了，一樣的在 maven 倉庫中有了索引我
們就可以認為可以快速找到 jar 包，

5、自動運行單元測驗

5、自動運行單元測驗
世界上沒有不存在 bug 的代碼，計算機喜歡 bug 就和人們總是喜歡美女帥哥一樣，為了追求美為
了減少 bug，因此寫完了代碼，我們還要寫一些單元測驗，然后一個個的運行來檢驗代碼質量，

6、一鍵構建

我們的專案，往往都要經歷編譯、測驗、運行、打包、安裝 ，部署等一系列程序，
1.什么是構建？
指的是專案從編譯、測驗、運行、打包、安裝 ，部署整個程序都交給 maven 進行管理，這個
程序稱為構建，
一鍵構建
指的是**整個構建程序，使用 maven 一個命令可以輕松完成整個作業，** 

Maven 規范化構建流程如下：每個階段使用一個命令完成

👉總結：如果現在有一種工具，可以把你從上面的繁瑣作業中解放出來，能幫你構建工程 ，管理 jar

包 ，編譯代碼 ，還能幫你自動運行單元測驗 ，打包 ，生成報表 ，甚至能幫你部署專案 ，生成 Web 站

點 ，你會心動嗎？Maven 就可以解決上面所提到的這些問題

三、maven工具的安裝配置

1、安裝 解壓即可

注意：檔案目錄不要太深 名字中不要有中文或空格

2、環境配置 環境變數中添加配置

Maven 是一個基于 Java 的工具，所以要做的第一件事情就是安裝 JDK，
  安裝 JDK1.8 + 版本 （將JAVA_HOME/bin 配置環境變數 path ），我使用的是 JDK8 相關版本
  
配置 MAVEN_HOME ，變數值就是你的 maven 安裝 的路徑（bin 目錄之前一級目錄）
右鍵 "計算機"，選擇 "屬性"，之后點擊 "高級系統設定"，點擊"環境變數"，
   來設定環境變數，有以下系統變數需要配置：
（1）新建系統變數 MAVEN_HOME，變數值：E:\Maven\apache-maven-3.3.9
（2）編輯系統變數 Path，添加變數值：%MAVEN_HOME%\bin
注意：注意多個值之間需要有分號隔開，然后點擊確定，

（1）新建系統變數 MAVEN_HOME，變數值：D:\develop\apache-maven-3.5.3

（2）編輯系統變數 Path，添加變數值：%MAVEN_HOME%\bin

（3）測驗組態檔是否成功

四、maven專案結構

1.src/main/java —— 存放專案的.java 檔案
2.src/main/resources —— 存放專案資源檔案，如 spring, hibernate 組態檔
3.src/test/java —— 存放所有單元測驗.java 檔案，如 JUnit 測驗類
4.src/test/resources —— 測驗資源檔案
5.target —— 專案輸出位置，編譯后的 class 檔案會輸出到此目錄
6.pom.xml——maven 專案核心組態檔

* 注意：如果是普通的 java 專案，那么就沒有 webapp 目錄，

作為一個 maven 工程，它的 src 目錄和 pom.xml 是必備的，

進入 src 目錄后，我們發現它里面的目錄結構如下

五、手工構建Maven專案

pom.xml：

<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>
    <!-- 基本設定 The Basics -->
    <!-- 企業或者公司 標識 域名倒置 -->
    <groupId>com.tjcu.edu</groupId>
    <!-- 專案 id 專案名-->
    <artifactId>maven_day1</artifactId>
    <!-- 版本 1.0.0.0.0  -->
    <version>1.0</version>
 </project>

Maven 規范化構建流程如下：每個階段使用一個命令完成

（1）mvn compile:編譯
（2）mvn clean ：清除
（3）mvn test:測驗
（4）mvn package :打包
 (5)mvn install 

1、mvn compile:編譯

compile 是 maven 工程的編譯命令
作用: 將 src/main/java 下的檔案編譯為 class 檔案輸出到 target目錄下， 

cmd 進入命令狀態，執行 mvn compile，如下圖提示成功：

會出現target包：

查看 target 目錄，class 檔案已生成，編譯完成，

2、mvn clean ：清除

clean 是 maven 工程的清理命令，執行 clean 會洗掉 target 目錄及內容，

3、mvn test:測驗

test 是 maven 工程的測驗命令 mvn test
作用： 會執行 src/test/java 下的單元測驗類，

cmd 執行 mvn test 執行 src/test/java 下單元測驗類

下圖為測驗結果，運行 1 個測驗用例，全部成功：

4、mvn package :打包

package 是 maven 工程的打包命令

作用： （1）對于 java 工程執行 package 打成 jar 包
      （2）對于 web 工程打成 war包，

打包后;target中會有打包好的jar包

5、mvn install 安裝

install 是 maven 工程的安裝命令
作用：執行 install 將 maven 打成 jar 包或 war 包發布到本地倉庫，

從運行結果中，可以看出：
當后面的命令執行時，前面的操作程序也都會自動執行！

👉注意：

1、maven命令時后邊不能加分號

2、每個maven命令多對應一個依賴 ，第一次使用時需要下載 下載一次

下載要求網速的原因：需要去國外下載

六、Maven倉庫結構

1.默認本地庫
2.如果沒有就聯網去中心倉庫下載到本地倉庫（要求網路穩定）
3.配置阿里云鏡像倉庫（解決跨國下載資源網路不穩定問題）
4、修改本地倉庫位置

1、默認本地倉庫：

本地倉庫 ：用來存盤從遠程倉庫或中央倉庫下載的插件和 jar 包，專案使用一些插件或 jar 包，
優先從本地倉庫查找
默認本地倉庫位置在 ${user.dir}/.m2/repository，${user.dir}表示 windows 用戶目錄，

2、如果沒有就聯網去中心倉庫下載到本地倉庫（要求網路穩定）

中央倉庫 ：在 maven 軟體中內置一個遠程倉庫地址 http://repo1.maven.org/maven2 ，它是中
央倉庫，服務于整個互聯網，它是由 Maven 團隊自己維護，里面存盤了非常全的 jar 包，它包
含了世界上大部分流行的開源專案構件

3、配置阿里云鏡像倉庫（解決跨國下載資源網路不穩定問題）

遠程倉庫（阿里云云鏡像倉庫就是遠程倉庫也算是遠程倉庫，但是大多數公司都會有自己的遠程倉庫）：
如果本地需要插件或者 jar 包，本地倉庫沒有，默認去遠程倉庫下載，
遠程倉庫可以在互聯網內也可以在局域網內

<!-- 阿里云鏡像配置 -->
  <mirror>  
    <id>alimaven</id>  
    <name>aliyun maven</name>  
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>  
    <mirrorOf>central</mirrorOf>          
  </mirror>

4、修改本地倉庫位置

七、IDEA使用Maven工具

IDEA集成Maven工具步驟（引入外部Maven）

選擇file——>setting

八、創建Maven專案

1、普通java專案

（1）選擇 idea 提供好的 maven 的java 工程模板

（2）點擊 Next 填寫專案資訊

• 專案資訊注意事項：

1.父專案為空
2.artifact 專案骨架

• 坐標中Version版本區別：

1、snapshot 1.0快照版本 沒有開發完的版本
2、release 1.0 穩定版本  開發完的版本

（3）點擊 Next，此處不做改動，

點擊 Finish 后開始創建工程，耐心等待，直到出現如下界面，

（4）普通java新建專案需要改動

a、修改專案pom檔案

普通java專案需要
1、坐標
2、環境引數
3、依賴
注意：將<build>標簽及其內部資訊全部刪掉

修改后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.tjcu</groupId>
    <artifactId>maven_java</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--環境引數 編碼格式、jdk版本(要一致)-->
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.7</maven.compiler.source>
        <maven.compiler.target>1.7</maven.compiler.target>
    </properties>
    <!--依賴  添加jar包的位置 -->
    <dependencies>
        <!--默認添加的junit依賴-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>
        <!--添加其他的依賴-->
    </dependencies>
    
</project>

b、補全專案目錄結構

最終目錄結構不完整，需要自己手動補齊
src/main/resources
src/test/resources

2、創建Web專案

(1)選擇 idea 提供好的 maven 的web 工程模板

(2)點擊 Next 填寫專案資訊

(3)點擊 Next，此處不做改動，

(4)點擊 Finish 后開始創建工程，耐心等待，直到出現如下界面，

(5)新建專案需要改動

a、修改（pom.xml詳解）

專案需要
1、坐標
2、環境引數
3、依賴
4、打包方式

注意：將<build>標簽及其內部資訊全部刪掉

b、補全專案結構：

1.手動添加 src/main/java 目錄，如下圖右鍵 main 檔案夾——>New——>Directory

(6)tomcat部署

九、在專案中引入依賴

添加依賴需要指定依賴 jar 包的坐標，但是很多情況我們是不知道 jar 包的的坐標，可以通過如下方

式查詢：

1、中心庫搜索網站：

http://search.maven.org/

http://mvnrepository.com/

網站搜索示例：

2、進行驗證

為了避免同一時間全球的很多人訪問網站設定了筆比較高級的驗證碼（驗證兩次，找輪船之類的）

3、進入到官網

4、搜索mybatis找到jar包

5、選擇專案所需要的jar包

選擇jar包原則，選擇下載量最多的，就是最好的，一般都是用于生成環境中的，不要最求最新版本

6、引入相關依賴：

7、手動重繪依賴和自動重繪依賴的方法

（1）手動重繪依賴

注意：如果不設定自動重繪 引入依賴之后需要手工重繪專案

（2）設定IDEA自動重繪maven專案配置

8、lifecycle是maven的生命周期

十、maven中jar包的依賴范圍

A 依賴 B，需要在 A 的 pom.xml 檔案中添加 B 的坐標，添加坐標時需要指定依賴范圍，依賴范圍包括：

scope:
1、compile【默認值】：作用于專案整個范圍
  編譯范圍，指 A 在編譯時依賴 B，此范圍為默認依賴范圍，編譯范圍的依賴會用在
  編譯、測驗、運行，由于運行時需要所以編譯范圍的依賴會被打包，
 
2、provided：不會出現在打包的產物里，由容器（服務器）提供
          provided 依賴只有在當 JDK 或者一個容器已提供該依賴之后才使用， 
          provided 依賴在編譯和測驗時需要，在運行時不需要，
          比如：servlet api 被 tomcat 容器提供，
注意：所以服務器中有的jar包，我們需要用provide，不然打包運行時會和服務器中的jar包沖突

3、runtime：最多生效到測驗環節
          runtime 依賴在運行和測驗系統的時候需要，但在編譯的時候不需要，
          比如：jdbc的驅動包，由于運行時需要所以 runtime 范圍的依賴會被打包， 
          
4、test：測驗時生效 junit中使用
        test 范圍依賴 在編譯和運行時都不需要，它們只有在測驗編譯和測驗運行階段可用
         比如：junit，由于運行時不需要所以 test范圍依賴不會被打包，
         
5、system：需要手工添加，不推薦使用
        system 范圍依賴與 provided 類似，但是你必須顯式的提供一個對于本地系統中JAR
        檔案的路徑，需要指定 systemPath 磁盤路徑，system依賴不推薦使用

十一、本地倉庫手工打入jar包

防止當前使用jar包在中心倉庫沒有

mvn install:install-file 
          -DgroupId=com.tjcu
          -DartifactId=ojdbc 
          -Dversion=14.0 
          -Dpackaging=jar 
          -Dfile=F:\百知筆記JavaWeb\JDBC\jdbc_day3\lib\mysql-connector-java-8.0.16.jar

說明:

手工匯入自己創建的jar包：

十二、洗掉下載失敗的命令

1、出現的問題

注意：maven所有下載失敗的jar包標識：.lastUpdated結尾檔案
這些下載失敗的檔案引起的問題：
1、下載想匯入成功的jar包，失敗的jar會占用位置，導致專案報錯
2、占存盤空間

2、下載失敗jar包解決辦法：

我們手寫一個bat檔案，使用回圈的辦法將本地倉庫中下載失敗的jar包進行自動洗掉

自動洗掉失敗jar包的腳本，洗掉maven倉庫中的失敗檔案.bat

腳本原始碼：

@echo off
rem create by sunhao(sunhao.java@gmail.com)
rem crazy coder
  
rem 這里寫你的倉庫路徑
set REPOSITORY_PATH=D:\develop\Repository
rem 正在搜索...
for /f "delims=" %%i in ('dir /b /s "%REPOSITORY_PATH%\*lastUpdated*"') do (
    del /s /q %%i
)
rem 搜索完畢
pause

使用演示：

十三、更新本地倉庫中的索引

讓idea知道你的本地倉庫更新了

📌 作者：王恒杰

📃 更新： 2021.10.25

? 勘誤： 無

📜 宣告： 由于作者水平有限，本文有錯誤和不準確之處在所難免，本人也很想知道這些錯誤，懇望讀者批評指正！
🍅 歡迎點贊 👍 收藏 ?留言 📝

溫馨提示：如果需要詳細的線下筆記，PDF檔案方便保存，可以關注公眾號“程式員小王”回復“maven”領取PDF版本筆記

這是小王的微信公眾號喲，如果需要PDF筆記可以私聊領取！