MAVEN教程——入門

說明：本文來自：http://wentao365.iteye.com/blog/903396/

Maven是一個採用純Java編寫的開 源項目管理工具。Maven採用了一種被稱之爲project object model (POM)概念來管理項目，所有的項目配置信息都被定義在一個叫做POM.xml的文件中，通過該文件，Maven可以管理項目的整個聲明週期，包括編 譯，構建，測試，發佈，報告等等。目前Apache下絕大多數項目都已經採用Maven進行管理。而Maven本身還支持多種插件，可以方便更靈活的控制 項目。 

1：http://maven.apache.org/download.html 下載最新版本 Maven 3.0.2 (Binary zip) 
 

2：解壓到 D: 
 

3：配置環境變量 
   MAVEN_HOME : D:\apache-maven-3.0.2 
   MAVEN : %MAVEN_HOME%\bin 
  (可選） MAVEN_OPTS : -Xms256m -Xmx512m 

   在path 前面 加上 %MAVEN%; 
 

4：驗證安裝是否成功 
在命令行上輸入 ： mvn -version; 回車，如看到下面信息表示安裝成功： 

 

5：創建項目 
在命令行上輸入 ：mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app 回車， 

 

如果你是首次運行該命令(goal)，maven將要花一些時間去把最新的工具包(Maven 把它叫作artifacts)下載到你的本地倉庫。 

 

命令執行完後你將看到maven生成了一個名爲my-app的目錄，這個名字就是你在命令中指定的artifactId,進入該目錄，你將發現以下標準的項目結構： 

 

其中:src/main/java 目錄包含了項目的源代碼，src/test/java 目錄包含了項目的測試代碼，pom.xml是項目的項目對象模型（Project Object Model or POM）。 

6：POM 
pom.xml 文件是maven對一個項目的核心配置，這個文件將包含你希望如何構建項目的大多數配置信息。POM大而複雜，但你不用全部去了解，只要使用一些常用的配置就可以了。下面列出這個POM的內容： 

引用

<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.mycompany.app</groupId> 
  <artifactId>my-app</artifactId> 
  <version>1.0-SNAPSHOT</version> 
  <packaging>jar</packaging> 

  <name>my-app</name> 
  <url>http://maven.apache.org</url> 

  <properties> 
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
  </properties> 

  <dependencies> 
    <dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>3.8.1</version> 
      <scope>test</scope> 
    </dependency> 
  </dependencies> 
</project> 

7：第5步我們做了什麼 

引用

mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app

執行Maven 命令（goal）archetype:create，並且設置了一些參數( -DgroupId=com.mycompany.app -DartifactId=my-app) 

在這個命令中，前綴 archetype 是包含create命令的一個maven的plugin。這個goal命令根據項目原型（符合maven標準的項目模板）建立了一個簡單的項目。 

現在可以確定地說，一個maven plugin 就是一些有着相同目的的goals命令的集合，例如 jboss-maven-plugin 這個插件，就是爲了處理各種和jboss相關的任務。 

8：Build 項目 
在命令行上 輸入 ： cd my-app 回車，進入到 項目路徑下 

 

再輸入 mvn package 回車這時命令行將會打印出各種動作，並且以下面一段信息結束： 

 

與首次執行的命令(那是一個goal) 

引用

archetype:create

不同,這次執行的只是一個簡單的命令---package。不同於goal,這是一個phase(階段)，一個phase是指構建生命週期的一個階段，構建生命週期是指有序的一系列phase。當給出一個phase，Maven將執行所有的在此階段前的phase及其自身，例如，如果我們執行compile階段，實際上執行的階段有： 

引用

validate 
generate-sources 
process-sources 
generate-resources 
process-resources 
compile

你可以使用以下的命令來測試新編譯和打包出來的jar包， 

引用

java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App

這時將打印出最經典的： 

引用

Hello World!

 

9：運行Maven工具 

雖然很難列出一張非常全面的表，但在此可先列出最普通的默認的生命週期階段: 

引用

validate：驗證工程是否正確，所有需要的資源是否可用。 
compile：編譯項目的源代碼。   
test：使用合適的單元測試框架來測試已編譯的源代碼。這些測試不需要已打包和佈署。 
Package：把已編譯的代碼打包成可發佈的格式，比如jar。 
integration-test：如有需要，將包處理和發佈到一個能夠進行集成測試的環境。 
verify：運行所有檢查，驗證包是否有效且達到質量標準。 
install：把包安裝在本地的repository中，可以被其他工程作爲依賴來使用。 
Deploy：在集成或者發佈環境下執行，將最終版本的包拷貝到遠程的repository，使得其他的開發者或者工程可以共享。 
clean：清除先前構建的artifacts（在maven中，把由項目生成的包都叫作artifact）。 
site：爲項目生成文檔站點。 

  
上面列出的各個Phases（階段）實際上對應着潛在的goals，特殊的每個階段執行的特殊的goals由項目的類型所決定，例如：如果項目的類型是jar,package階段將默認執行jar:jar的goals,如果項目類型是war,那麼package階段執行的goals將是war:war。 
有件有趣的事情需要注意，那就是phases和goals需要按一定的順序來執行。 
mvn clean dependency:copy-dependencies package 
這個命令將先清除項目，然後拷貝依賴，最後把項目打包，當然，在打包之前，會先執行此階段之前的階段.如compile,test等. 
生成站點 
mvn site 
這個階段生成基於pom.xml配置的項目信息。你可以在target/site目錄下看到生成的文檔。