1. 程式人生 > >maven的介紹及如何獲取jar包

maven的介紹及如何獲取jar包

3.0.5 所有 mave 命令行模式 項目開發 onf 聯網 右鍵 減少

本文轉載自 https://www.cnblogs.com/whgk/p/7112560.html

該篇文章篇幅較長,大概的思路如下

          maven的介紹,初步認識,獲取jar包的三個關鍵屬性 --> 介紹倉庫(獲取的jar包從何而來)-->用命令行管理maven項目(創建maven項目) --> 用myeclipse創建maven項目 -->詳細介紹pom.xml中的依賴關系(坐標獲取、定位jar包的各種屬性講解。

                              --WH

一、簡單的小問題?

    解釋之前,提1個小問題。

      1.1、假如你正在Eclipse下開發兩個Java項目,姑且把它們稱為A、B,其中A項目中的一些功能依賴於B項目中的某些類,那麽如何維系這種依賴關系的呢?

        很簡單,這不就是跟我們之前寫程序時一樣嗎,需要用哪個項目中的哪些類,也就是用別人寫好了的功能代碼,導入jar包即可。所以這裏也如此,可以將B項目打成jar包,然後在A項目的Library下導入B的jar文件,這樣,A項目就可以調用B項目中的某些類了。

        這樣做幾種缺陷

          如果在開發過程中,發現B中的bug,則必須將B項目修改好,並重新將B打包並對A項目進行重編譯操作

          在完成A項目的開發後,為了保證A的正常運行,就需要依賴B(就像在使用某個jar包時必須依賴另外一個jar一樣),兩種解決方案,第一種,選擇將B打包入A中,第二種,將B也發布出去,等別人需要用A時,告訴開發者,想要用A就必須在導入Bjar包。兩個都很麻煩,前者可能造成資源的浪費(比如,開發者可能正在開發依賴B的其它項目,B已經存儲到本地了,在導入A的jar包的話,就有了兩個B的jar),後者是我們常遇到的,找各種jar包,非常麻煩(有了maven就不一樣了)

      1.2、我們開發一個項目,或者做一個小demo,比如用SSH框架,那麽我們就必須將SSH框架所用的幾十個依賴的jar包依次找出來並手動導入,超級繁瑣。 

    

    上面兩個問題的描述,其實都屬於項目與項目之間依賴的問題[A項目使用SSH的所有jar,就說A項目依賴SSH],人為手動的去解決,很繁瑣,也不方便,所以使用maven來幫我們管理

二、maven到底是什麽?

    Maven是基於項目對象模型(POM project object model),可以通過一小段描述信息(配置)來管理項目的構建,報告和文檔的軟件項目管理工具[百度百科]

    這種又是大白話,如果沒明白maven是什麽,那麽上面這句話跟沒說一樣,我自己覺得,Maven的核心功能便是合理敘述項目間的依賴關系,通俗點講,就是通過pom.xml文件的配置獲取jar包,而不用手動去添加jar包,而這裏pom.xml文件對於學了一點maven的人來說,就有些熟悉了,怎麽通過pom.xml的配置就可以獲取到jar包呢?pom.xml配置文件從何而來?等等類似問題我們需要搞清楚,如果需要使用pom.xml來獲取jar包,那麽首先該項目就必須為maven項目,maven項目可以這樣去想,就是在java項目和web項目的上面包裹了一層maven,本質上java項目還是java項目,web項目還是web項目,但是包裹了maven之後,就可以使用maven提供的一些功能了(通過pom.xml添加jar包)。

    所以,根據上一段的描述,我們最終的目的就是學會如何在pom.xml中配置獲取到我們想要的jar包,在此之前我們就必須了解如何創建maven項目,maven項目的結構是怎樣,與普通java,web項目的區別在哪裏,還有如何配置pom.xml獲取到對應的jar包等等,這裏提前了解一下我們如何通過pom.xml文件獲取到想要的jar的,具體後面會詳細講解該配置文件。

    pom.xml獲取junit的jar包的編寫。

          技術分享圖片

    為什麽通過groupId、artifactId、version三個屬性就能定位一個jar包?

        加入上面的pom.xml文件屬於A項目,那麽A項目肯定是一個maven項目,通過上面這三個屬性能夠找到junit對應版本的jar包,那麽junit項目肯定也是一個maven項目,junit的maven項目中的pom.xml文件就會有三個標識符,比如像下圖這樣,然後別的maven項目就能通過這三個屬性來找到junit項目的jar包了。所以,在每個創建的maven項目時都會要求寫上這三個屬性值的。

          技術分享圖片

        

        

三、maven的安裝

    這一步maven環境的配置,我覺得有必要安裝一下,目的為了使用命令行創建maven項目,和使用命令行操作maven項目。這裏不細講,給出鏈接,跟安裝jdk環境類似,maven的安裝教程和配置

還有註意,我以下用的是maven3.0.4版本(比較低的),你們可以下載最新的版本,最好是使用jdk1.7.

四、倉庫的概念

    通過pom.xml中的配置,就能夠獲取到想要的jar包(還沒講解如何配置先需要了解一下倉庫的概念),但是這些jar是在哪裏呢?就是我們從哪裏獲取到的這些jar包?答案就是倉庫。

    倉庫分為:本地倉庫、第三方倉庫(私服)、中央倉庫

      4.1、本地倉庫

          Maven會將工程中依賴的構件(Jar包)從遠程下載到本機一個目錄下管理,每個電腦默認的倉庫是在 $user.home/.m2/repository下

                  技術分享圖片

              例如我的就在:C:\Users\Administrator\.m2\repository

          一般我們會修改本地倉庫位置,自己創建一個文件夾,在從網上下載一個擁有相對完整的所有jar包的結合,都丟到本地倉庫中,然後每次寫項目,直接從本地倉庫裏拿就行了

              技術分享圖片  這裏面有很多各種各樣我們需要的jar包。

          修改本地庫位置:在$MAVEN_HOME/conf/setting.xml文件中修改,

               技術分享圖片 

               技術分享圖片 

          D:\java\maven\repository:就是我們自己創建的本地倉庫,將網上下載的所有jar包,都丟到該目錄下,我們就可以直接通過maven的pom.xml文件直接拿。

      4.2、第三方倉庫

          第三方倉庫,又稱為內部中心倉庫,也稱為私服

          私服:一般是由公司自己設立的,只為本公司內部共享使用。它既可以作為公司內部構件協作和存檔,也可作為公用類庫鏡像緩存,減少在外部訪問和下載的頻率。(使用私服為了減少對中央倉庫的訪問

          私服可以使用的是局域網,中央倉庫必須使用外網

          也就是一般公司都會創建這種第三方倉庫,保證項目開發時,項目所需用的jar都從該倉庫中拿,每個人的版本就都一樣。

          註意:連接私服,需要單獨配置。如果沒有配置私服,默認不使用

      4.3、中央倉庫

          Maven內置了遠程公用倉庫:http://repo1.maven.org/maven2

          這個公共倉庫是由Maven自己維護,裏面有大量的常用類庫,並包含了世界上大部分流行的開源項目構件。目前是以java為主

          工程依賴的jar包如果本地倉庫沒有,默認從中央倉庫下載

      總結:獲取jar包的過程

              技術分享圖片

五、使用命令行管理maven項目

      5.1、創建maven java項目

          自己創建一個文件夾,在該文件夾下按shift+右擊,點開使用命令行模式,這樣創建的maven[java]項目就在該文件夾下了。

          命令:mvn archetype:create -DgroupId=com.wuhao.maven.quickstart -DartifactId=simple -DarchetypeArtifactId=maven-archetype-quickstart

            mvn:核心命令

            archetype:create:創建項目,現在maven高一點的版本都棄用了create命令而使用generate命令了。

            -DgroupId=com.wuhao.maven.quickstart :創建該maven項目時的groupId是什麽,該作用在上面已經解釋了。一般使用包名的寫法。因為包名是用公司的域名的反寫,獨一無二

            -DartifactId=simple:創建該maven項目時的artifactId是什麽,就是項目名稱

            -DarchetypeArtifactId=maven-archetype-quickstart:表示創建的是[maven]java項目

          運行的前提:需要聯網,必須上網下載一個小文件

                技術分享圖片

          運行成功後

                技術分享圖片  

          在D:\java\maven\demo下就會生成一個simple的文件,該文件就是我們的maven java項目

                技術分享圖片

      5.2、maven java項目結構

          simple
            ---pom.xml    核心配置,項目根下
            ---src
             ---main      
                ---java    java源碼目錄
               ---resources  java配置文件目錄
             ---test
               ---java    測試源碼目錄
               ---resources  測試配置目錄

          技術分享圖片

          圖中有一個target目錄,是因為將該java項目進行了編譯,src/main/java下的源代碼就會編譯成.class文件放入target目錄中,target就是輸出目錄。

      5.3、創建 maven web 項目

          命令:mvn archetype:create -DgroupId=com.wuhao.maven.quickstart -DartifactId=myWebApp -DarchetypeArtifactId=maven-archetype-webapp -Dversion=0.0.1-snapshot

          其他都差不多,創建maven web項目的話 -DarchetypeArtifactId=maven-archetype-webapp 比創建java項目多了一個 -Dversion=0.01-snapshot, 在創建java項目的時候也可以加上這個,如果不寫,會默認幫我們加上1.0-snapshot。

              技術分享圖片

           在D:\java\maven\demo下就會生成一個myWebApp的文件 

              技術分享圖片    

      5.4、maven web項目結構

          pom.xml 核心配置
          src/main/java java源碼
          src/main/resources java配置
          src/main/webapp myeclipse web項目中 WebRoot目錄
             |-- WEB-INF
            |-- web.xml
          src/test 測試
          target 輸出目錄

      5.5、命令操作maven java或web項目

          編譯:mvn compile  --src/main/java目錄java源碼編譯生成class (target目錄下)

          測試:mvn test    --src/test/java 目錄編譯

          清理:mvn clean    --刪除target目錄,也就是將class文件等刪除

          打包:mvn package  --生成壓縮文件:java項目#jar包;web項目#war包,也是放在target目錄下

          安裝:mvn install   --將壓縮文件(jar或者war)上傳到本地倉庫

          部署|發布:mvn deploy  --將壓縮文件上傳私服

      5.6、例子:使用命令操作maven java項目

          註意:使用命令時,必須在maven java項目的根目錄下,及可以看到pom.xml

          描述:將maven java項目打包上傳到本地倉庫供別人調用

            使用 mvn install

                技術分享圖片

            在本地倉庫中查看是否有該項目

                D:\java\maven\repository\com\wuhao\maven\quickstart\simple\1.0-SNAPSHOT

                技術分享圖片

            通過在本地倉庫中的目錄可以發現為什麽通過groupId、artifactId、version可以定位到倉庫中得jar包,也可以知道為什麽groupId要使用公司域名的反寫(因為這樣唯一,不會與別的項目重名導致查找到的內容不精確)

      5.7、maven項目的完整生命周期,當執行生命周期後面命令時,前面步驟的命令自動執行

                技術分享圖片

          紅色標記字體的意思就是當我們直接使用mvn install命令對項目進行上傳至本地倉庫時,那麽前面所有的步驟將會自動執行,比如源代碼的編譯,打包等等。

      5.8、其他命令

          maven java或web項目轉換Eclipse工程

             mvn eclipse:eclipse

             mvn eclipse:clean  清楚eclipse設置信息,又從eclipse工程轉換為maven原生項目了    

          ...轉換IDEA工程

             mvn idea:idea

             mvn idea:clean  同上 

六、使用Myeclipse創建maven自定義項目

    使用myeclpse創建項目前,需要在myeclipse中配置maven的一些信息

      比如:配置本地倉庫、安裝自定義maven(myeclipse中高版本自帶了maven)等,這裏省略。

      6.1、java項目

          1、選擇maven project,如果右鍵新建沒有,通過other獲得

              技術分享圖片

          2、創建一個簡單項目(跳過骨架選擇)

              技術分享圖片

          3、設置項目參數,創建java項目

              技術分享圖片

              技術分享圖片

              

          4、創建java項目結果

              技術分享圖片

          

      6.2、創建maven web項目

          1、同上

          2、同上

          3、設置項目參數,其他一樣,選擇打包方式不一樣。

                技術分享圖片

          4、創建web項目結果

                技術分享圖片

          5、可能報錯1:pom.xml報錯

                技術分享圖片

             結果如下

                技術分享圖片     

             然後需要更新一下項目,就不報錯了。

                技術分享圖片

          6、報錯2,編寫jsp時報錯

                技術分享圖片     

            錯誤信息為缺少serlvet-jar和jsp-jar包

                  技術分享圖片  

            解決:使用pom.xml定位導入相應的jar包

                  技術分享圖片    

              找到jsp-jar包,scope的作用是表示該jar包的作用範圍,provided表示在編譯和測試期有效,在運行期則無效。具體後面講解pom.xml時會講解到。     

                  技術分享圖片

              找到servle-jar包

                  技術分享圖片

              pom.xml中檢查,修改

                  技術分享圖片

              修改完後,發現兩個jar包都加載進來了,項目完好,不在報錯了。

                   技術分享圖片 

      6.3、創建maven項目

          都一樣,在項目參數那裏修改即可

                  技術分享圖片

          結果

                  技術分享圖片

          maven項目一般沒用,在開發中將一個項目拆分成多個項,就需要使用maven項目(pom項目)將其他子項目進行整合,下一章節講解,很重要。很重要。

      6.4、myeclipse maven操作

                  技術分享圖片

        6--9 都是快捷方式

          9 測試,相當於命令行 mvn test

          8 安裝,相當於命令行 mvn install 作用:將其上傳到本地倉庫,具體見上面講解

          7 關聯源碼,這個不需要解釋吧,平常我們使用別的jar包也關聯過源碼

          6 清理,mvn clean

        5 maven bulid  執行maven命令,等效 mvn

                  技術分享圖片

        4 maven build 5快速的操作

          如果沒有操作過,與5相同

          如果操作過一次,將直接執行上一次5的命令

          如果操作多次,將提供選擇框

      6.5、例子,將maven web項目發布到tomcat運行

          命令:tomcat:run

                  技術分享圖片

          通過網址即可訪問,同時會將該項目上傳到本地倉庫。

七、pom.xml的依賴關系講解(重點)

    之前一直在使用pom.xml中找jar包最關鍵的三個屬性,groupId、artifactId、version,應該有些印象了,也知道為什麽通過這三個能找到對應的jar包,但是沒有細講其中的一些小的知識點,比如上面添加servlet-jar和jsp-jar的依賴時,出現的一些屬性就不太懂,所以,這一章節,就將依賴關系全面分析。

    7.1、如何獲取坐標(也就是三個關鍵屬性值)

      方式1:使用網站搜索[從中央倉庫拿]

        步驟一:百度搜索關鍵字“maven repository”

              技術分享圖片

        步驟二:輸入關鍵字查詢獲得需要內容,確定需要版本

              技術分享圖片

        

        步驟三、獲得坐標

              技術分享圖片

       方式2、使用本地倉庫,通過myeclipse獲得坐標

         上面已經介紹過了如何從本地倉庫獲取對應jar,這裏在簡單闡述一下

         步驟一:添加依賴,pom.xml文件中,右鍵  

              技術分享圖片  

         步驟二:獲得坐標

              技術分享圖片 

  

      7.2、依賴(坐標)的常見配置

         為了避免不知道說的哪些配置屬性,看下面圖就明白了,就是dependency下的屬性配置,全部有9個,講其中的7個。

               技術分享圖片 

         groupId、artifactId、version是依賴的基本坐標,缺一不可,這三個可以不用將,都知道,重要的是除了這三個之外的配置屬性需要我們理解

         type:依賴的類型,比如是jar包還是war包等

            默認為jar,表示依賴的jar包

            註意:<type>pom.lastUpdated</type> 這個我們在上面添加servlet-jar的時候就遇到過,看到lastUpdated的意思是表示使用更新描述信息,占位符作用,通俗點講,選擇該類型,jar包不會被加載進來,只是將該jar包的一些描述信息加載進來,使別的jar包在引用他時,能夠看到一些相關的提示信息,僅此而已,所以說他是個占位符,只要記住他的jar包不會被加載進來。

         optional:標記依賴是否可選。默認值false

            比如struts2中內置了log4j這個記錄日誌的功能,就是將log4j內嵌入struts2的jar包中,而struts2有沒有log4j這個東西都沒關系,有它,提示的信息更多,沒它,也能夠運行,只是提示的信息就相對而言少一些,所以這個時候,就可以對它進行可選操作,想要它就要,不想要,就設置為false。

         exclusions:排除傳遞依賴,解決jar沖突問題

            依賴傳遞的意思就是,A項目 依賴 B項目,B項目 依賴 C項目,當使用A項目時,就會把B也給加載進來,這是傳遞依賴,依次類推,C也會因此給加載進來。

            這個有依賴傳遞有好處,也有壞處,壞處就是jar包的沖突問題,比如,A 依賴 B(B的版本為1),C 依賴 B(B的版本為2),如果一個項目同時需要A和C,那麽A,C都會傳遞依賴將B給加載進來,問題就在這裏,兩個B的版本不一樣,將兩個都加載進去就會引起沖突,這時候就需要使用exclusions這個屬性配置了。maven也會有一個機制避免兩個都加載進去,maven 默認配置在前面的優先使用,但是我們還是需要使用exclusions來配置更合理,這裏使用spring bean 和 struts2 spring plugin 來舉例子說明這個問題並使用exclusions解決這個問題。(spring bean 和 struts2 spring plugin都需要依賴spring-core,但版本不一樣)

            從本地倉庫中找到這兩個jar包

                  技術分享圖片

            maven自己的解決方案如下

              maven 默認配置在前面的優先使用,下面是證明

                先將spring-beans加載進去的,所以會將spring-beans依賴的spring-core的版本加載進來。

                     技術分享圖片       

                先將struts2-spring-plugin加載進來,那麽就會將其依賴的spring-core的版本加載進來

                     技術分享圖片 

              

            使用exclusions來配置

               即使struts2-spring-plugin 配置在前面,也需要使用3.2.0版本。則需要為struts2-spring-plugin 排除依賴(不使用3.0.5依賴)

                    技術分享圖片 

               註意:這樣,就將struts2-spring-plugin依賴的spring-core的版本排除依賴了,也就是該依賴的spring-core不會在加載進來,查看代碼,看是否符合要求,如果不符合要求,需要手動的修改 

                    技術分享圖片

         scope:依賴範圍,意思就是通過pom.xml加載進來的jar包,來什麽範圍內使用生效,範圍包括編譯時,運行時,測試時

                    技術分享圖片

            compile:默認值,如果選擇此值,表示編譯、測試和運行都使用當前jar

            test:表示只在測試時當前jar生效,在別的範圍內就不能使用該jar包。例如:junit 。此處不寫也不報錯,因為默認是compile,compile包擴了測試

            runtime,表示測試和運行時使用當前jar,編譯時不用該jar包。例如:JDBC驅動。JDBC驅動,在編譯時(也就是我們寫代碼的時候都是采用接口編程,壓根就沒使用到JDBC驅動包內任何東西,只有在運行時才用的到,所以這個是典型的使用runtime這個值的例子),此處不寫也不報錯,理由同上

            provided,表示編譯和測試時使用當前jar,運行時不在使用該jar了。例如:servlet-api、jsp-api等。【必須填寫】

               什麽意思呢? 在我們以前創建web工程,編寫servlet或者jsp時,就沒導入過jar包把,因為myeclipse或者別的ide幫我們提供了這兩個jar包,內置了,所以我們在編譯期測試期使用servlet都不會報缺少jar包的錯誤,而在運行時期,離開了myeclipse或別的ide,就相當於缺失了這兩個jar包,但此時tomcat又會幫我們提供這兩個jar,以便我們不會報錯,所以,這兩個很特殊。看圖

               1、開發階段(MyEclipse提供),看下圖以此證明我們說的

                  java web 5.0項目:技術分享圖片 

                  java web 6.0項目:技術分享圖片

               2、運行階段(tomcat提供)   

                      技術分享圖片

               所以,根據這個特點,如果使用maven開發項目,就不是web項目了,那麽myeclipse就不會在給我們提供這兩個jar包,我們就必須自己手動通過坐標從倉庫中獲取,但是針對上面的分析,當運行的時候,tomcat會幫我們提供這兩個jar包,所以我們自己從倉庫中獲取的jar包就不能和tomcat中的沖突,那麽就正好可以通過provided這個屬性,來設置這兩個jar的作用範圍,就是在變異時期和測試時期生效即可。

               這個例子就可以解釋上面創建maven web時產生的錯誤和解決方案了。

    

            system:表示我們自己手動加入的jar包,不屬於maven倉庫(本地,第三方等),屬於別得類庫的這樣的jar包,只在編譯和測試期生效,運行時無效。一般不用                    

      7.3、依賴調節原則

          這個就是maven解決傳遞依賴時jar包沖突問題的方法,按照兩種原則,上面已經介紹了一種了,就是下面的第二原則

            1、第一原則:路徑近者優先原則

                    A-->B-->C-->D-->X(1.6)

                    E-->D-->X(2.0)

               使用X(2.0),因為其路徑更近 

            2、第二原則:第一聲明者優先原則。就是如果路徑相同,maven 默認配置在前面的優先使用

                    A-->B --> X(1.6)

                    C-->D--> X(2.0)

               這樣就是路徑相同,那麽如果A在前面,C在後面,則使用X(1.6)

            maven會先根據第一原則進行選擇,第一原則不成,則按第二原則處理。

            

八、總結

      這篇文章的篇幅有點長,也消耗了我挺多的時間的,因為其中遇到一些bug,一直找不出原因,一度想放棄,但還是堅持了下來,這也只是maven的入門,知道大概怎麽用,看別的應該就看得懂,其實項目中真正用的還是下一節所要講解的。

      如何搭建私服?

      如何從私服中獲取jar包

      使用maven對父工程與子模塊的拆分和聚合。

      下一節就講這些東西把,加油。

maven的介紹及如何獲取jar包