maven的基本使用

• Maven解決的問題

  • maven 是自動化構建工具。
  • 構建：是將工程編譯得到的結果部署到服務器上的過程
  • 編譯：.java文件通過javac編譯器，編譯為.class的字節(jié)碼文件。

• Maven對jar包的管理

  • 有一個倉庫的概念，統一管理jar包，而每一個jar用坐標來對應位置。對一個jar包而言，文件夾+名字+版本號，可以定位到唯一jar。
    • 倉庫
      • 本地倉庫(本機上的文件夾) -> 中央倉庫(maven提供) -> 遠程倉庫(私服)
      • 本地倉庫是否能找到jar包? 如果jar不存在，去遠程倉庫查找，如果遠程不存在，去中央倉庫查找。如果都找不到，報錯。

• Maven項目

  • 需要填寫 groupId artifactId version （坐標三要素）
    • groupId 代表jar所來源的渠道，對應文件夾的名字 （com.duyi / com.alibaba）
    • artifactId 代表項目的唯一名字 maven-duyi-demo.jar
    • version 代表版本號 1.0 2.0 ..
      • -SNAPSHOT(快照版本，不穩(wěn)定的)
      • -RELEASE(發(fā)布版本，穩(wěn)定的)
  • 創(chuàng)建項目后提示是否自動引入包？
    • 選擇自動引入 - enable auto-import
  • maven項目有一個約定好的目錄結構
    • 設計思想“約定優(yōu)于配置” 是統一規(guī)范
      • src 代碼總目錄
      • 分級為 main(核心代碼和資源)和test(測試代碼和資源)
        • 其中main又包含 java(存放代碼)和resources(存放資源)文件夾
        • pom.xml mvn的核心配置文件
          文件中一定存在項目被打包之后所對應的坐標三要素(創(chuàng)建項目時填寫的)

• maven的下載和配置

  • 官網地址: https://maven.apache.org/download.cgi
  • 下載 apache-maven-3.6.3-bin.zip (windows系統)
    settings.xml是maven軟件自身的配置文件
  • 解壓縮 -> 存放在英文路徑下 -> 進入到bin文件夾 -> copy路徑配置環(huán)境變量 (我的電腦右鍵)
  • 驗證 -> 命令提示符 -> 輸入mvn -v (查看版本號)
  • 關聯idea -> File -> settings -> 搜索maven -> 更改maven home directory為自己下載的maven目錄 -> 設置好settings.xml以及本地倉庫
  • 設置conf目錄下的settings.xml
    • 更改本地倉庫的配置
      C:\Users${用戶名}.m2\repository
    • 通過鏡像的方式更好的從中央倉庫下載jar包
      通常使用阿里云提供的鏡像 https://yq.aliyun.com/articles/703623

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

    • 把上述地址copy到settings文件的標簽下
  • 在idea的user settings file選項中 找到剛才配置的文件。
  • 如果出現報錯，查看報錯日志，Help -> show log in explorer
    • 如果出現報錯為

    ERROR -      #org.jetbrains.idea.maven - com.google.inject.CreationException: 
    Unable to create injector, see the following errors
    

    是版本不兼容的問題 更改為3.6.1版本

• maven的依賴

  • 存放到<dependencies>標簽下

  • 查找依賴坐標，通過https://mvnrepository.com網站找到

  • 以引用guava為例(google提供的使用最廣泛的jar)

    	<dependencies>
    	    <dependency>
    	        <groupId>com.google.guava</groupId>
    	        <artifactId>guava</artifactId>
    	        <version>28.1-jre</version>
    	    </dependency>
    	</dependencies>
    

  • 依賴有遞進關系
    當引入依賴時，默認引入它依賴的其他jar。
    項目A -> jar包B -> 相當于引入了jar包C

  • 剔除依賴的方式
    使用標簽, 以findbugs為例

     <exclusions>
        <exclusion>
            <groupId>com.google.code.findbugs</groupId>
            <artifactId>jsr305</artifactId>
        </exclusion>
      </exclusions> 
    

  • 依賴使用的范圍

    • 構建包含的流程：編譯、測試、運行、打包、安裝、部署
      compile test package install deploy
      在右側 maven projects標簽欄中 打開項目名下面的lifecycle
      如果沒有 去View - Tool windows中查找
      使用<scope>標簽 放在artifactId下面
      compile缺省值 伴隨著項目的整個生命周期而存在。
      provided已提供的 不需要將此依賴打包到項目最終的jar包里。
      runtime運行時使用
      比如<scope>runtime</scope>
      test 測試時使用
      system 自定義jar包位置 (不推薦)

• maven的生命周期

  • clean validate compile test package verify install site deploy

    1. clean 項目清理
    2. validate 校驗項目的可用性
    3. compile 編譯
    4. test 執(zhí)行單元測試
    5. package 打包
    6. verify 校驗測試結果
    7. install 安裝
    8. site 網站站點文件的創(chuàng)建(用的非常少)
    9. deploy 部署

  • 命令效果：

    • compile 編譯
      注意點1：再次驗證mvn -v里面的java運行目錄，是否是jdk所在目錄
      如果不是，說明環(huán)境變量缺少JAVA_HOME的配置
      注意點2：編譯時需要指定jdk的版本
      maven提供對全局jdk的配置(settings文件中標簽下)

      <profile>  
          <id>jdk-1.8</id>  
          <activation>  
              <activeByDefault>true</activeByDefault>  
              <jdk>1.8</jdk>  
          </activation>  
          <properties>    
              <maven.compiler.source>1.8</maven.compiler.source>    
              <maven.compiler.target>1.8</maven.compiler.target>    
              <maven.compiler.compilerVersion>1.8
              </maven.compiler.compilerVersion>    
         </properties>  
      </profile>
      

      • 正式編譯mvn clean compile
        編譯結果出現在根目錄下的target文件夾中
      • 執(zhí)行打包 mvn clean package
        打包結果，出現了項目的jar包
      • 執(zhí)行安裝 mvn clean install (打包文件存儲到本地倉庫中)
        本地倉庫中出現對應的文件夾和jar
      • 執(zhí)行部署 mvn clean deploy
        首先要配置遠程倉庫的地址，然后將打包文件上傳到遠程倉庫中

    • 跳過測試階段

      • 方式一： mvn package -DskipTests 雖然跳過單元測試的執(zhí)行，但仍然會編譯代碼，不是很推薦使用
      • 方式二： mvn package -Dmaven.test.skip=true （最最常用的命令之一）既不會執(zhí)行測試代碼也不會編譯。

    • 查看依賴樹

      • 方式一：pom.xml文件中右鍵 -> diagrams -> show dependencies
      • 方式二：mvn dependency:tree
        功能： 更好的解決jar包沖突問題