1. 程式人生 > >maven介紹(作用,核心概念,用法,常用命令,擴張及配置)

maven介紹(作用,核心概念,用法,常用命令,擴張及配置)

maven介紹(作用,核心概念,用法,常用命令,擴張及配置)

maven作用,核心概念(pom,repositories,artifact,build lifecycle,goal),用法(archetype意義及建立各種專案),maven常用引數和命令以及簡單故障排除
1、maven的作用
      maven是一個專案構建和管理的工具,提供了幫助管理、構建、文件、報告、依賴、scms、釋出,分發的方法。可以方便的編譯程式碼、進行依賴管理、管理二進位制庫等
      maven的好處在於可以將專案過程規範化、自動化、高效化以及強大的可擴充套件性
      利用maven自身及其外掛還可以獲得程式碼檢查報告、單元測試覆蓋率、實現持續整合等等
2、maven核心概念
      21、pom
               pom是指project object model。pom是一個xml,是maven工作的基礎,在執行task或是goal,maven會去專案根目錄下讀取pom.xml獲取配置資訊。
               pom檔案中包含了專案的資訊和maven build專案所需的配置資訊,通常有專案資訊(如版本,成員)、專案的依賴、外掛和goal,build選項等等
               pom是可以繼承的,通常對於一個大型專案或是多個module的情況,子模組的pom需要指定父模組的pom
               pom檔案中節點含義:
project pom檔案的頂級元素
modelVersion 所使用的object model版本,為了確保穩定的使用,這個元素是強制性的。除非maven開發者升級模板,否則不需要修改
groupId 是專案建立團體或組織的唯一標誌符,通常是域名倒寫,如groupId  org.apache.maven.plugins就是為所有maven外掛預留的
artifactId 是專案artifact唯一的基地址名
packaging artifact打包的方式,如jar、war、ear等等。預設為jar。這個不僅表示專案最終產生何種字尾的檔案,也表示build過程使用什麼樣的lifecycle。
version artifact的版本,通常能看見為類似0.0.1-SNAPSHOT,其中SNAPSHOT表示專案開發中,為開發版本
name 表示專案的展現名,在maven生成的文件中使用
url表示專案的地址,在maven生成的文件中使用
description 表示專案的描述,在maven生成的文件中使用
dependencies 表示依賴,在子節點dependencies中新增具體依賴的groupId artifactId和version
build 表示build配置
parent 表示父pom
            其中groupID:artifactId:version唯一確定了一個artifact
      2.2 Artifact
這個有點不好解釋,大致說就是一個專案將要產生的檔案,可以是jar檔案,原始檔,二進位制檔案,war檔案,甚至是pom檔案。每個artifact都由groupId:artifactId:version組成的識別符號唯一識別。需要被使用(依賴)的artifact都要放在倉庫(見Repository)中
2.3 Repositories
Repositories是用來儲存Artifact的。如果說我們的專案產生的Artifact是一個個小工具,那麼Repositories就是一個倉庫,裡面有我們自己建立的工具,也可以儲存別人造的工具,我們在專案中需要使用某種工具時,在pom中宣告dependency,編譯程式碼時就會根據dependency去下載工具(Artifact),供自己使用。
對於自己的專案完成後可以通過mvn install命令將專案放到倉庫(Repositories)中
倉庫分為本地倉庫和遠端倉庫,遠端倉庫是指遠端伺服器上用於儲存Artifact的倉庫,本地倉庫是指本機儲存Artifact的倉庫,對於windows機器本地倉庫地址為系統使用者的.m2/repository下面。
對於需要的依賴,在pom中新增dependency即可,可以在maven的倉庫中搜索:http://mvnrepository.com/

2.4 Build Lifecycle
是指一個專案build的過程。maven的Build Lifecycle分為三種,分別為default(處理專案的部署)、clean(處理專案的清理)、site(處理專案的文件生成)。他們都包含不同的lifecycle。
Build Lifecycle是由phases構成的,下面重點介紹default Build Lifecycle幾個重要的phase
validate 驗證專案是否正確以及必須的資訊是否可用
compile 編譯原始碼
test 測試編譯後的程式碼,即執行單元測試程式碼
package 打包編譯後的程式碼,在target目錄下生成package檔案
integration-test 處理package以便需要時可以部署到整合測試環境
verify 檢驗package是否有效並且達到質量標準
install 安裝package到本地倉庫,方便本地其它專案使用
deploy 部署,拷貝最終的package到遠端倉庫和替他開發這或專案共享,在整合或釋出環境完成

2.5 Goal
goal代表一個特定任務
A goal represents a specific task (finer than a build phase) which contributes to the building and managing of a project.

mvn package表示打包的任務,通過上面的介紹我們知道,這個任務的執行會先執行package phase之前的phase
mvn deploy表示部署的任務
mven clean install則表示先執行clean的phase(包含其他子phase),再執行install的phase。
3、maven用法
主要講下Archetype以及幾種常用專案的建立
maven建立專案是根據Archetype(原型)建立的。下面先介紹下Archetype
3.1 Archetype
原型對於專案的作用就相當於模具對於工具的作用,我們想做一個錘子,將鐵水倒入模具成型後,稍加修改就可以了。
類似我們可以根據專案型別的需要使用不同的Archetype建立專案。通過Archetype我們可以快速標準的建立專案。利用Archetype建立完專案後都有標準的資料夾目錄結構
既然Archetype相當於模具,那麼當然可以自己再造模具了啊,建立Archetype
下面介紹利用maven自帶的集中Archetype建立專案。建立專案的goal為mvn archetype:generate,並且指定archetypeArtifactId,其中archetypeArtifactId見maven自帶的archetypeArtifactId

3.2 quick start工程
建立一個簡單的quick start專案,指定 -DarchetypeArtifactId為maven-archetype-quickstart,如下命令
Xml程式碼 收藏程式碼
mvn archetype:generate -DgroupId=com.trinea.maven.test -DartifactId=maven-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
其中DgroupId指定groupId,DartifactId指定artifactId,DarchetypeArtifactId指定ArchetypeId,
DinteractiveMode表示是否使用互動模式,互動模式會讓使用者填寫版本資訊之類的,非互動模式採用預設值
現在我們可以利用2.4的build Lifecycle進行一些操作,先命令列到工程根目錄下
編譯 mvn compile
打包 mvn package,此時target目錄下會出現maven-quickstart-1.0-SNAPSHOT.jar檔案,即為打包後文件
打包並安裝到本地倉庫mvn install,此時本機倉庫會新增maven-quickstart-1.0-SNAPSHOT.jar檔案。
3.3 web工程
建立一個簡單的web專案,只需要修 -DarchetypeArtifactId為maven-archetype-webapp即可,如下命令
mvn archetype:generate -DgroupId=com.trinea.maven.web.test -DartifactId=maven-web -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
其他:
src\main\resources資料夾是用來存放資原始檔的,maven工程預設沒有resources資料夾,如果我們需要用到類似log4j.properties這樣的配置檔案,就需要在src\main資料夾下新建resources資料夾,並將log4j.properties放入其中。
test需要用到資原始檔,類似放到src\test下
對於apache的log4j沒有log4j.properties檔案或是目錄錯誤,會報如下異常
log4j:WARN No appenders could be found for logger (org.apache.commons.httpclient.HttpClient).
log4j:WARN Please initialize the log4j system properly.

4、maven常用引數和命令
主要介紹maven常用引數和命令以及簡單故障排除
4.1 mvn常用引數
mvn -e 顯示詳細錯誤
mvn -U 強制更新snapshot型別的外掛或依賴庫(否則maven一天只會更新一次snapshot依賴)
mvn -o 執行offline模式,不聯網更新依賴
mvn -N僅在當前專案模組執行命令,關閉reactor
mvn -pl module_name在指定模組上執行命令
mvn -ff 在遞迴執行命令過程中,一旦發生錯誤就直接退出
mvn -Dxxx=yyy指定java全域性屬性
mvn -Pxxx引用profile xxx
 
4.2 首先是2.4 Build Lifecycle中介紹的命令
mvn test-compile 編譯測試程式碼
mvn test 執行程式中的單元測試
mvn compile 編譯專案
mvn package 打包,此時target目錄下會出現maven-quickstart-1.0-SNAPSHOT.jar檔案,即為打包後文件
mvn install 打包並安裝到本地倉庫,此時本機倉庫會新增maven-quickstart-1.0-SNAPSHOT.jar檔案。
每個phase都可以作為goal,也可以聯合,如之前介紹的mvn clean install
 
4.3 maven 日用三板斧
mvn archetype:generate 建立maven專案
mvn package 打包,上面已經介紹過了
mvn package -Prelease打包,並生成部署用的包,比如deploy/*.tgz
mvn install 打包並安裝到本地庫
mvn eclipse:eclipse 生成eclipse專案檔案
mvn eclipse:clean 清除eclipse專案檔案
mvn site 生成專案相關資訊的網站
 
4.4 maven外掛常用引數
mvn -Dwtpversion=2.0 指定maven版本
mvn -Dmaven.test.skip=true 如果命令包含了test phase,則忽略單元測試
mvn -DuserProp=filePath 指定使用者自定義配置檔案位置
mvn -DdownloadSources=true -Declipse.addVersionToProjectName=true eclipse:eclipse 生成eclipse專案檔案,嘗試從倉庫下載原始碼,並且生成的專案包含模組版本(注意如果使用公用POM,上述的開關預設已開啟)
 
4.5 maven簡單故障排除
mvn -Dsurefire.useFile=false如果執行單元測試出錯,用該命令可以在console輸出失敗的單元測試及相關資訊
set MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=256m 調大jvm記憶體和持久代,maven/jvm out of memory error
mvn -X maven log level設定為debug在執行
mvndebug 執行jpda允許remote debug
mvn –help 這個就不說了。。
 
5、maven擴充套件
maven常用外掛配置和使用
 
6、maven配置
為了修改maven建立專案預設以來的jdk版本,看了下maven配置
maven2.0預設使用jdk1.5導致反省、@override 等annotation不可用。可用兩種方法修改jdk版本
第一種:修改專案的pom.xml,影響單個專案,治標不治本
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>1.6</source>
                <target>1.6</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>
pom中增加build配置,指定java版本為1.6
第二種:修改maven配置,影響maven建立的所有專案
到maven安裝目錄的conf資料夾下,修改settings.xml檔案,如下:
<profiles>   
    <profile>     
      <id>jdk-1.6</id>       
      <activation>       
        <activeByDefault>true</activeByDefault>       
        <jdk>1.6</jdk>       
      </activation>       
      <properties>       
        <maven.compiler.source>1.6</maven.compiler.source>       
        <maven.compiler.target>1.6</maven.compiler.target>       
        <maven.compiler.compilerVersion>1.6</maven.compiler.compilerVersion>       
      </properties>       
    </profile>      
</profiles>
這樣便能對所有預設的maven專案指定jdk為1.6