(轉載)maven詳解
轉載: http://www.cnblogs.com/hongwz/p/5456578.html
Maven詳解
一.前言
以前做過的項目中,沒有真正的使用過Maven,只知道其名聲很大,其作用是用來管理jar 包的。最近一段時間在項目過程中使用Maven,用Maven構建的web項目,其項目結構只停留在了解階段,沒有深入的使用與理解,剛好最近看了一篇關於Maven的詳解;就開始深入學習一下Maven的具體應用。
二.Maven的作用
- 在開發中,為了保證編譯通過,我們會到處去尋找jar包,當編譯通過了,運行的時候,卻發現"ClassNotFoundException",我們想到的是,難道還差jar包?
- 每個Java項目的目錄結構都沒有一個統一的標準,配置文件到處都是,單元測試代碼到底應該放在那裏也沒有一個權威的規範。
- 因此,我們就要用到Maven(使用Ant也可以,不過編寫Ant的xml腳本比較麻煩)----一個項目管理工具。
- Maven主要做了兩件事:
- 統一開發規範與工具
- 統一管理jar包
下面我們來對比一下,首先建立一個普通的Java工程,是這樣的:
這個我們都很熟悉,src下建包寫代碼,那麽配置文件放在哪裏?單元測試代碼放在哪裏?沒有一個統一標準,更多時候都是開發者的自由發揮,每個人有自己的風格,這並不十分適合團隊協作。接下來,看一下使用maven構建一個普通Java項目之後的目錄結構:
看到使用Maven構建的普通Java項目,對源代碼、單元測試代碼、資源乃至後續需要的文件都有專門的目錄規劃。
上面的最後有一個pom.xml,這是Maven的核心配置文件,pom稱為Project Object Model(項目對象模型),它用於描述整個Maven項目,所以也稱為Maven描述文件。
當然事情不會這麽簡單,接下來,繼續進入Maven的世界吧。
pom.xml
打開pom.xml,最基礎的是這樣的:
1 2 3 4 5 6 7 8 9 10 |
<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.xrq.withmaven</groupId>
<artifactId>withmaven</artifactId>
<version>0.0.1-SNAPSHOT</version>
<build/>
</project>
|
因為這個配置文件是Maven的核心,因此有必要詳細解讀一下pom.xml,來先看一下上面的幾個:
1、modelVersion
指定了當前Maven模型的版本號,對於Maven2和Maven3來說,它只能是4.0.0
2、groupId
顧名思義,這個應該是公司名或是組織名。一般來說groupId是由三個部分組成,每個部分之間以"."分隔,第一部分是項目用途,比如用於商業的就是"com",用於非營利性組織的就 是"org";第二部分是公司名,比如"tengxun"、"baidu"、"alibaba";第三部分是你的項目名
3、artifactId
可以認為是Maven構建的項目名,比如你的項目中有子項目,就可以使用"項目名-子項目名"的命名方式
4、version
版本號,SNAPSHOT意為快照,說明該項目還在開發中,是不穩定的版本。在Maven中很重要的一點是,groupId、artifactId、version三個元素生成了一個Maven項目的基本坐標,這非常重要,我在使用和研究Maven的時候多次感受到了這點。
在上面的這些元素之外,還有一些元素,同樣羅列一下:
1、packing
項目打包的類型,可以使jar、war、rar、ear、pom,默認是jar
2、dependencies和dependency
前者包含後者。前面說了,Maven的一個重要作用就是統一管理jar包,為了一個項目可以build或運行,項目中不可避免的,會依賴很多其他的jar包,在Maven中,這些依賴就被稱為dependency。
說到這裏,就有一個本地倉庫和遠程倉庫的概念了。官方下載的本地倉庫的配置在"%MAVEN_HOME%\conf\settings.xml"裏面,找一下"localRepository"就可以了;MyEclipse默認的本地倉庫的地址在"{user.home}/.m2/repository"路徑下,同樣找一下"localRepository"就可以找到MyEclipse默認的本地倉庫了。
本地倉庫和遠程倉庫是這樣的,Maven工程首先會從本地倉庫中獲取jar包,當無法獲取指定jar包時,本地倉庫會從遠程倉庫(中央倉庫)中下載jar包,並放入本地倉庫以備將來使用。
舉個例子,比方說我的項目中用到了MyBatis,那麽可以這麽配置:
1 2 3 4 5 6 7 |
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.2.5</version>
</dependency>
</dependencies>
|
之前有說過groupId、artifactId、version唯一標識一個Maven項目,有了這三個元素,我們就可以去遠程倉庫下載MyBatis3.2.5.jar到本地倉庫了。回想我們之前的做法,如果要MyBatis的jar包,發現沒有,然後去網上下載一個,需要另外的jar包,然後去網上下載一個,但是有了Maven,就方便多了,只需要配置jar包對應的dependency依賴,Maven會自動幫助我們去遠程倉庫中下載jar包到本地倉庫中。
3、properties
properties是用來定義一些配置屬性的,例如project.build.sourceEncoding(項目構建源碼編碼方式),可以設置為UTF-8,防止中文亂碼,也可定義相關構建版本號,便於日後統一升級。
4、build
build表示與構建相關的配置,比如build下有finalName,表示的就是最終構建之後的名稱。
接著解釋一下Maven的目錄結構:
- main目錄下是項目的主要代碼,test目錄下存放測試相關的代碼
- 編譯輸出後的代碼會放在target目錄下
- src/main/java下存放Java代碼,src/main/resources下存放配置文件
- 這裏沒有webapp,Web項目會有webapp目錄,webapp下存放Web應用相關代碼
- pom.xml是Maven項目的配置文件
三.Maven環境配置
常用的開發工具Idea、MyEclipse裏面都已經集成了Maven了,不過最好是從官網下一個配置到自己電腦裏,開發工具裏的可能有少許的Bug。
首先去Maven官網,下載Maven的包,地址為http://maven.apache.org/download.cgi,找到下面的部分,點擊就可以下載了:
下載完解壓,然後配置一下環境變量,和JDK的環境變量配置類似:
這樣配置完就可以了,驗證一下,windows+r打開命令窗口,輸入"mvn --version",如果有下面的內容這表示Maven配置OK:
Maven入門使用常見問題
1、我從SVN上下載了一個以Maven構建的工程,下載完畢沒有jar包怎麽辦?
從資源庫上下載下來的Maven工程,是沒有jar包的,此時可以這麽做:
(1)刪除Maven工程,但是刪除的時候不要刪除本地工程裏面的Maven工程,只刪除MyEclipse中的Maven工程
(2)右鍵Import->Maven4MyEclipse->Existing Maven Projects,導入你的Maven工程,此時MyEclipse在構建工程的時候,假如你的本地倉庫中沒有dependcy中的jar包,便會去遠程倉庫下載jar包到本地倉庫中。你的工程導入完畢之後,Library應該是這樣的:
2、重新下載Maven工程所依賴的jar包、導入jar包都需要觸發Maven工程的build workspace,那麽如何才能觸發Maven工程的build workspace?
找到一個pom.xml,隨便修改一下,加一個空格、減一個空格什麽的,ctrl+s保存一下,便會觸發Maven工程的build workspace了
3、本地倉庫的目錄結構是什麽樣子的?
groupId、artifactId、version確定一個唯一的Maven,比方說我有一個mybatis的dependcy:
1 2 3 4 5 |
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.2.5</version>
</dependency>
|
那麽mybatis的jar包應該在%Maven倉庫地址%\org\mybatis\mybatis\3.2.5\這一路徑下,看到了吧,先groupId,再mybatis,最後version,每個名字都是一個文件夾的名字
4、有些jar包在dependcy裏面有配置,Import了Maven工程,下載完工程所依賴的jar包之後,發現本地倉庫裏面卻沒有,怎麽辦?
可能是原先下載jar包的時候出了什麽問題,從artifactId目錄開始刪除以下的所有文件/文件夾,然後觸發一次Maven工程的build workspace就可以了
5、本地倉庫中確定已經有jar包了,工程裏面卻報錯,說找不到jar包,該怎麽辦?
應該有很多解決辦法,目前解決的一種辦法是,MyEclipse->Window->Preferences->搜索Maven->User Settings,Update Settings和Reindex點一下就好了。另外,可以嘗試一下把本地Maven倉庫內的jar包刪除一下,然後重新build workspace,可能也可以。
(轉載)maven詳解