1. 程式人生 > >【maven】史上最全教程,看了必懂

【maven】史上最全教程,看了必懂

一、為什麼使用Maven這樣的構建工具【why】

  1. 一個專案就是一個工程
  • 如果專案非常龐大,就不適合使用package來劃分模組,最好是每一個模組對應一個工程,利於分工協作。
  • 藉助於maven就可以將一個專案拆分成多個工程
  1. 專案中使用jar包,需要複製、貼上到專案的lib中
  • 同樣的jar包重複的出現在不同的專案工程中,你需要做不停的複製貼上的重複工作。
  • 藉助於maven,可以將jar包儲存在“倉庫”中,不管在哪個專案只要使用引用即可就行。
  1. jar包需要的時候每次都要自己準備好或到官網下載
  • 藉助於maven我們可以使用統一的規範方式下載jar包,規範
  1. jar包版本不一致的風險
  • 不同的專案在使用jar包的時候,有可能會導致各個專案的jar包版本不一致,導致未執行錯誤。
  • 藉助於maven,所有的jar包都放在“倉庫”中,所有的專案都使用倉庫的一份jar包。
  1. 一個jar包依賴其他的jar包需要自己手動的加入到專案中
  • FileUpload元件->IO元件,commons-fileupload-1.3.jar依賴於commons-io-2.0.1.jar
  • 極大的浪費了我們匯入包的時間成本,也極大的增加了學習成本。
  • 藉助於maven,它會自動的將依賴的jar包匯入進來。

二、maven是什麼【what】

  1. maven是一款服務於java平臺的自動化構建工具
  • make->Ant->Maven->Gradle
  • 名字叫法:我們可以叫妹文也可以叫麥文,但是沒有叫媽文的。
  1. 構建
  • 構建定義:把動態的Web工程經過編譯得到的編譯結果部署到伺服器上的整個過程。
  • √ 編譯:java原始檔[.java]->編譯->Classz位元組碼檔案[.class]
  • √ 部署:最終在sevlet容器中部署的不是動態web工程,而是編譯後的檔案

  1. 構建的各個環節
  • [1] 清理clean:將以前編譯得到的舊檔案class位元組碼檔案刪除
  • [2] 編譯compile:將java源程式編譯成class位元組碼檔案
  • [3] 測試test:自動測試,自動呼叫junit程式
  • [4] 報告report:測試程式執行的結果
  • [5] 打包package:動態Web工程打War包,java工程打jar包
  • [6] 安裝install:Maven特定的概念-----將打包得到的檔案複製到“倉庫”中的指定位置
  • [7] 部署deploy:將動態Web工程生成的war包複製到Servlet容器下,使其可以執行

三、安裝maven

  1. 當前系統是否配置JAVA_HOME的環境變數
  2. 下載maven,解壓maven放在一個非中文無空格的路徑下

  1. 配置maven的相關環境變數
  • 在環境變數增加M2_HOME,路徑是maven解壓後的根目錄
  • 在環境變數裡的path中增加maven/bin的目錄
  1. 驗證:maven -v 檢視maven版本

四、第一個maven

  1. 建立約定的目錄結構(maven工程必須按照約定的目錄結構建立)
[1] 根目錄:工程名
    [2] |---src:原始碼
    [3] |---|---main:存放主程式
    [4] |---|---|---java:java原始碼檔案
    [5] |---|---|---resource:存放框架的配置檔案
    [6] |---|---test:存放測試程式
    [7] |---pom.xml:maven的核心配置檔案
  •  我們按照上面的資料夾目錄結構手動建立一下,不用任何IDE環境(手動的其實最有助於我們理解maven)

  1. 常用maven命令
- [1] mvn clean:清理 
- [2] mvn compile:編譯主程式
- [3] mvn test-compile:編譯測試程式
- [4] mvn test:執行測試 
- [5] mvn package:打包
- [6] mvn install:安裝
  • 執行 mvn compile

OK,執行完畢,你在pom.xml配置的依賴的包已經匯入到倉庫了,問題來了,倉庫預設的位置在哪? 倉庫的預設位置:c:\Usrs[登入當前系統的使用者名稱].m2\repository 剛才執行完compile之後,之前的資料夾發生了變化

  • 執行 mvn test-compile,target資料夾下面除了classes之外多了test-classes資料夾
  • 執行 mvn package,target資料夾下面又多了一個打好的jar包

  • 執行mvn clean,發現整個target資料夾都沒了。又回到了編譯之前我們手動建立的資料夾

五、倉庫和座標

  1. pom.xml:Project Object Model 專案物件模型。它是maven的核心配置檔案,所有的構建的配置都在這裡設定。
  2. 座標:使用下面的三個向量在倉庫中唯一的定位一個maven工程
  3. maven工程的座標與倉庫中路徑的關係:

maven座標和倉庫對應的對映關係:[groupId][artifactId][version][artifactId]-[version].jar 去本地倉庫看一下此目錄:org\springframework\spring-core\4.3.4.RELEASE\spring-core-4.3.4.RELEASE.jar 果然是完全對應的(預設倉庫地址上面說過了哦,不要說不知道在哪,沒事下面我們再說一下倉庫)

  1. 倉庫
  • 倉庫的分類:
    • 1、本地倉庫:當前電腦上的倉庫,路徑上已經說過了哦
    • 2、遠端倉庫:
      • (1)私服:搭建在區域網中,一般公司都會有私服,私服一般使用nexus來搭建。具體搭建過程可以查詢其他資料
      • (2)中央倉庫:架設在Internet上,像剛才的springframework就是在中央倉庫上

六、依賴

  1. maven解析依賴資訊時會到本地倉庫中取查詢被依賴的jar包
  • 對於本地倉庫中沒有的會去中央倉庫去查詢maven座標來獲取jar包,獲取到jar之後會下載到本地倉庫
  • 對於中央倉庫也找不到依賴的jar包的時候,就會編譯失敗了
  1. 如果依賴的是自己或者團隊開發的maven工程,需要先使用install命令把被依賴的maven工程的jar包匯入到本地倉庫中

舉例:現在我再建立第二個maven工程HelloFriend,其中用到了第一個Hello工程裡類的sayHello(String name)方法 我們在給HelloFriend專案使用 mvn compile命令進行編譯的時候,會提示缺少依賴Hello的jar包。怎麼辦呢? 到第一個maven工程中執行 mvn install後,你再去看一下本地倉庫,你會發現有了Hello專案的jar包 一旦本地倉庫有了依賴的maven工程的jar包後,你再到HelloFriend專案中使用 mvn compile命令的時候,可以成功編譯

  1. 依賴範圍scope

  • compile,預設值,適用於所有階段(開發、測試、部署、執行),本jar會一直存在所有階段。
  • provided,只在開發、測試階段使用,目的是不讓Servlet容器和你本地倉庫的jar包衝突 。如servlet.jar。
  • runtime,只在執行時使用,如JDBC驅動,適用執行和測試階段。
  • test,只在測試時使用,用於編譯和執行測試程式碼。不會隨專案釋出。
  • system,類似provided,需要顯式提供包含依賴的jar,Maven不會在Repository中查詢它。

七、生命週期

Maven有三套相互獨立的生命週期,請注意這裡說的是“三套”,而且“相互獨立”,初學者容易將Maven的生命週期看成一個整體,其實不然。這三套生命週期分別是:

  1. Clean Lifecycle 在進行真正的構建之前進行一些清理工作。Clean生命週期一共包含了三個階段:
  • pre-clean 執行一些需要在clean之前完成的工作
  • clean 移除所有上一次構建生成的檔案
  • post-clean 執行一些需要在clean之後立刻完成的工作
  1. Default Lifecycle 構建的核心部分,編譯,測試,打包,部署等等。
  • 1、validate
  • 2、generate-sources
  • 3、process-sources
  • 4、generate-resources
  • 5、process-resources 複製並處理資原始檔,至目標目錄,準備打包
  • 6、compile 編譯專案的原始碼
  • 7、process-classes
  • 8、generate-test-sources
  • 9、process-test-sources
  • 10、generate-test-resources
  • 11、process-test-resources 複製並處理資原始檔,至目標測試目錄
  • 12、test-compile 編譯測試原始碼
  • 13、process-test-classes
  • 14、test 使用合適的單元測試框架執行測試。這些測試程式碼不會被打包或部署
  • 15、prepare-package
  • 16、package 接受編譯好的程式碼,打包成可釋出的格式,如 JAR
  • 17、pre-integration-test
  • 18、integration-test
  • 19、post-integration-test
  • 20、verify
  • 21、install 將包安裝至本地倉庫,以讓其它專案依賴。
  • 22、deploy 將最終的包複製到遠端的倉庫,以讓其它開發人員與專案共享

那我們在Hello的專案中執行 mvn install 命令,通過日誌看看中間經歷了什麼?

通過日誌我們發現,其實執行mvn install,其中已經執行了compile 和 test 。 總結:不論你要執行生命週期的哪一個階段,maven都是從這個生命週期的開始執行 外掛:每個階段都有外掛(plugin),看上面標紅的。外掛的職責就是執行它對應的命令。

  1. Site Lifecycle 生成專案報告,站點,釋出站點。
  • 1、pre-site 執行一些需要在生成站點文件之前完成的工作
  • 2、site 生成專案的站點文件
  • 3、post-site 執行一些需要在生成站點文件之後完成的工作,並且為部署做準備
  • 4、site-deploy 將生成的站點文件部署到特定的伺服器上

八、maven工程的依賴高階特性

  1. 依賴的傳遞性

WebMavenDemo專案依賴JavaMavenService1 JavaMavenService1專案依賴JavaMavenService2 pom.xml檔案配置好依賴關係後,必須首先mvn install後,依賴的jar包才能使用。

  • WebMavenDemo的pom.xml檔案想能編譯通過,JavaMavenService1必須mvn install
  • JavaMavenService的pom.xml檔案想能編譯通過,JavaMavenService2必須mvn install
  1. 依賴版本的原則
  • 路徑最短者優先原則

Service2的log4j的版本是1.2.7版本,Service1排除了此包的依賴,自己加了一個Log4j的1.2.9的版本,那麼WebMavenDemo專案遵守路徑最短優先原則,Log4j的版本和Sercive1的版本一致。

  • 路徑相同先宣告優先原則

這種場景依賴關係發生了變化,WebMavenDemo專案依賴Sercive1和Service2,它倆是同一個路徑,那麼誰在WebMavenDemo的pom.xml中先宣告的依賴就用誰的版本。

  1. 統一管理依賴的版本

為了統一管理版本號,可以使用properties標籤,裡面可以自定義版本的標籤名。在使用的地方使用${自定義標籤名}

九、build配置

<build>
  <!-- 專案的名字 -->
  <finalName>WebMavenDemo</finalName>
  <!-- 描述專案中資源的位置 -->
  <resources>
    <!-- 自定義資源1 -->
    <resource>
      <!-- 資源目錄 -->
      <directory>src/main/java</directory>
      <!-- 包括哪些檔案參與打包 -->
      <includes>
        <include>**/*.xml</include>
      </includes>
      <!-- 排除哪些檔案不參與打包 -->
      <excludes>
        <exclude>**/*.txt</exclude>
          <exclude>**/*.doc</exclude>
      </excludes>
    </resource>
  </resources>
  <!-- 設定構建時候的外掛 -->
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>2.1</version>
      <configuration>
        <!-- 原始碼編譯版本 -->
        <source>1.8</source>
        <!-- 目標平臺編譯版本 -->
        <target>1.8</target>
      </configuration>
    </plugin>
    <!-- 資源外掛(資源的外掛) -->  
    <plugin>  
      <groupId>org.apache.maven.plugins</groupId>  
      <artifactId>maven-resources-plugin</artifactId>  
      <version>2.1</version>  
      <executions>  
        <execution>  
          <phase>compile</phase>  
        </execution>  
      </executions>  
      <configuration>  
        <encoding>UTF-8</encoding>  
      </configuration> 
    </plugin>
    <!-- war外掛(將專案打成war包) -->  
    <plugin>  
      <groupId>org.apache.maven.plugins</groupId>  
      <artifactId>maven-war-plugin</artifactId>  
      <version>2.1</version>  
      <configuration>
        <!-- war包名字 -->  
        <warName>WebMavenDemo1</warName>
      </configuration>  
    </plugin>  
  </plugins>
</build>
  • 配置好build後,執行mvn package之後,在maven工程指定的target目錄裡war包和檔案都按照配置的生成了

最後推薦個最新最全的maven依賴項版本查詢網站:http://mvnrepository.c