轉自:http://www.cnblogs.com/adolfmc/archive/2012/07/31/2616908.html
1 下載下傳源代碼:mvn dependency:sources -DdownloadSources=true -DdownloadJavadocs=true
maven常用指令介紹
這裡主要是在eclipse中使用maven,是以隻使用到了一部分指令,整理下來友善以後查閱。
生成清除Eclipse項目結構:
mvn eclipse:eclipse
mvn eclipse:clean
清理(删除target目錄下編譯内容)
mvn clean
僅打包Web頁面檔案
mvn war:exploded
編譯項目
mvn compile
打包釋出
mvn package
打包時跳過測試
mvn package -Dmaven.test.skip=ture
還有很多指令目前還沒有使用到,以後遇到再補充
本文位址:http://blog.csdn.net/kongxx/article/details/6993501
Maven用了很久了,指令一直記不住,其實想想就那個幾個常用的,今天寫下來,幫着記憶吧
- 建立一個簡單的Java工程:mvn archetype:create -DgroupId=com.mycompany.example -DartifactId=Example
- 創 建一個java的web工程:mvn archetype:create -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DgroupId=com.mycompany.app -DartifactId=my-webapp
- 打包:mvn package
- 編譯:mvn compile
- 編譯測試程式:mvn test-compile
- 清空:mvn clean
- 運作測試:mvn test
- 生成站點目錄: mvn site
- 生成站點目錄并釋出:mvn site-deploy
- 安裝目前工程的輸出檔案到本地倉庫: mvn install
- 安 裝指定檔案到本地倉庫:mvn install:install-file -DgroupId=<groupId> -DartifactId=<artifactId> -Dversion=1.0.0 -Dpackaging=jar -Dfile=<myfile.jar>
- 檢視實際pom資訊: mvn help:effective-pom
- 分析項目的依賴資訊:mvn dependency:analyze 或 mvn dependency:tree
- 跳過測試運作maven任務: mvn -Dmaven.test.skip=true XXX
- 生成eclipse項目檔案: mvn eclipse:eclipse
- 檢視幫助資訊:mvn help:help 或 mvn help:help -Ddetail=true
- 檢視插件的幫助資訊:mvn <plug-in>:help,比如:mvn dependency:help 或 mvn ant:help 等等。
常用指令
1. 建立Maven的普通java項目:
mvn archetype:create
-DgroupId=packageName
-DartifactId=projectName
2. 建立Maven的Web項目:
mvn archetype:create
-DgroupId=packageName
-DartifactId=webappName
-DarchetypeArtifactId=maven-archetype-webapp
3. 編譯源代碼: mvn compile
4. 編譯測試代碼:mvn test-compile
5. 運作測試:mvn test
6. 産生site:mvn site
7. 打包:mvn package
8. 在本地Repository中安裝jar:mvn install
9. 清除産生的項目:mvn clean
10. 生成eclipse項目:mvn eclipse:eclipse
11. 生成idea項目:mvn idea:idea
12. 組合使用goal指令,如隻打包不測試:mvn -Dtest package
13. 編譯測試的内容:mvn test-compile
14. 隻打jar包: mvn jar:jar
15. 隻測試而不編譯,也不測試編譯:mvn test -skipping compile -skipping test-compile
( -skipping 的靈活運用,當然也可以用于其他組合指令)
16. 清除eclipse的一些系統設定:mvn eclipse:clean
http://cloudera.iteye.com/blog/424795
maven 簡單實用教程
1. Maven介紹
1.1. 簡介
java編寫的用于建構系統的自動化工具。
目前版本是2.0.9,注意maven2和maven1有很大差別,閱讀第三方文檔時需要區分版本。
1.2. Maven資源
- 見官方網站;
- The 5 minute test,官方簡易入門文檔;
- Getting Started Tutorial,官方入門文檔;
- Build Cookbook,官方的cookbook;
- POM Reference,POM檔案的設定參考
- Settings Reference ,settings檔案的設定參考
- Better Builds with Maven,免費的電子書,下載下傳需要注冊。
1.3. Maven和Ant的差別
Maven正在逐漸取代Ant,很多java開源軟體(Spring、Struts2 ……)已經使用maven。
- 不需要寫複雜的處理腳本;
- 聲明式的類庫依賴管理。
1.4. Maven的基本功能
- 建構:比如生成class、jar、war或者ear檔案
- 生成文檔:比如生成javadoc、網站文檔
- 生成報告:比如junit測試報告
- 生成依賴類庫:生成文檔,說明項目多其他軟體的依賴
- 有關SCM:SCM(Software Configuration Management),軟體配置管理,比如版本控制,比如bug管理等等
- 釋出:生成供釋出的分發包,比如生成Struts2的分發包,供送出給使用者使用
- 部署:比如,web應用程式,自動部署到指定的伺服器上
通過我寫的商品管理的小例子,示範結合maven和svn的功能。
2. Maven使用
2.1. Maven的安裝和配置
- 從官方網站下載下傳最新的Maven分發包http://maven.apache.org/download.html,目前為2.0.9;
- 解壓縮到本地;
- 配置maven, 将maven/bin目錄設定到windows環境變量Path中
- 檢查maven是否安裝成功, 在指令行中執行
mvn -version
2.2. Maven的基本使用
Maven的基本使用介紹通過指令行編寫簡單的java和web項目。
2.2.1. 實作Java項目
通過maven在指令行下建立普通java項目,也就是main方法執行的項目或者jar檔案的類庫。
2.2.1.1. 建立Maven項目
執行:
mvn archetype:generate
在互動界面中:
- Choose a number: 回車即可,也就是選擇15
- Define value for groupId: 輸入組織id,比如easymorse.com
- Define value for artifactId:輸入項目名稱,比如helloworld
- Define value for version: 輸入版本号,可以直接回車,預設是1.0-SNAPSHOT
- Define value for package: java的包名,比如com.easymorse
- 然後回車表示确認上述輸入即可。
觀察helloworld目錄(Define value for artifactId輸入的項目名稱)下生成的檔案和目錄:
- 項目建構檔案: pom.xml
- 代碼架構: src\main\java\com\easymorse\App.java
- 測試代碼: src\test\java\com\easymorse\AppTest.java
2.2.1.2. 運作Maven項目
指令行進入helloworld目錄Define value for artifactId輸入的項目名稱)。
項目打包
mvn package
檢查指令生成了什麼?
- target目錄
- 編譯了代碼
- 編譯了測試代碼
- 使用junit測試并生成的報告
- 生成代碼的jar檔案
運作打包的jar檔案:
java -cp target\helloworld-1.0-SNAPSHOT.jar com.easymorse.App
編譯源程式
mvn compile
編譯并測試
mvn test
清空生成的檔案
mvn clean
将maven項目轉化為eclipse項目
指令行運作:
mvn eclipse:eclipse
打開eclipse,菜單選擇:file>import>general>existing projects into workspace,在對話框中選中目錄,導入即可。
如果要清除有關eclipse項目的配置資訊:
mvn -Dwtpversion=1.0 eclipse:clean
聯合使用
mvn eclipse:clean clean
2.2.2. 實作Web項目
通過maven在指令行下建立java web項目。
2.2.2.1. 建立Maven項目
在指令行輸入,這一步和建立java項目類似:
mvn archetype:generate
互動步驟說明:
- Choose a number: 回車即可,也就是選擇18,這裡和java普通項目不一樣
需要在pom.xml檔案中增加servlet容器的插件:
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>tomcat-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.mortbay.jetty</groupId>
<artifactId>maven-jetty-plugin</artifactId>
<version>6.1.6</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.6</source>
<target>1.6</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
- tomcat插件
- jetty插件
- 編譯插件的配置
repository目錄的作用
repository的位置,在使用者目錄的.m2目錄下。
repository目錄的作用,對依賴類庫的緩存。
2.2.2.2. 運作Maven項目
mvn package
啟動tomcat
mvn tomcat:run
啟動jetty
mvn jetty:run
轉化為eclipse項目
mvn -Dwtpversion=1.5 eclipse:eclipse
這樣生成wtp插件的web項目。
另外,需要在eclipse裡建立一個classpath變量,名稱為:M2_REPO,值為系統使用者下.m2/repository目錄。
3. POM檔案的基本配置
3.1. POM介紹
3.1.1. 什麼是POM
Project Object Model,項目對象模型。
通過xml格式儲存的pom.xml檔案。
作用類似ant的build.xml檔案,功能更強大。
該檔案用于管理:源代碼、配置檔案、開發者的資訊和角色、問題追蹤系統、組織資訊、項目授權、項目的url、項目的依賴關系等等。
3.1.2. 快速浏覽
一個完整的pom.xml檔案,放置在項目的根目錄下。
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<!-- The Basics -->
<groupId>...</groupId>
<artifactId>...</artifactId>
<version>...</version>
<packaging>...</packaging>
<dependencies>...</dependencies>
<parent>...</parent>
<dependencyManagement>...</dependencyManagement>
<modules>...</modules>
<properties>...</properties>
<!-- Build Settings -->
<build>...</build>
<reporting>...</reporting>
<!-- More Project Information -->
<name>...</name>
<description>...</description>
<url>...</url>
<inceptionYear>...</inceptionYear>
<licenses>...</licenses>
<organization>...</organization>
<developers>...</developers>
<contributors>...</contributors>
<!-- Environment Settings -->
<issueManagement>...</issueManagement>
<ciManagement>...</ciManagement>
<mailingLists>...</mailingLists>
<scm>...</scm>
<prerequisites>...</prerequisites>
<repositories>...</repositories>
<pluginRepositories>...</pluginRepositories>
<distributionManagement>...</distributionManagement>
<profiles>...</profiles>
</project>
3.2. 基本設定
3.2.1. 協作關系
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.codehaus.mojo</groupId>
<artifactId>my-project</artifactId>
<version>1.0</version>
<packaging>war</packaging>
</project>
- groupId : 組織辨別,例如:org.codehaus.mojo,在M2_REPO目錄下,将是: org/codehaus/mojo目錄。
- artifactId : 項目名稱,例如:my-project,在M2_REPO目錄下,将是:org/codehaus/mojo/my-project目錄。
- version : 版本号,例如:1.0,在M2_REPO目錄下,将是:org/codehaus/mojo/my-project/1.0目錄。
- packaging : 打包的格式,可以為:pom , jar , maven-plugin , ejb , war , ear , rar , par
3.2.2. POM間關系
3.2.2.1. 依賴關系
依賴關系清單(dependency list)是POM的重要部分。
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.0</version>
<scope>test</scope>
</dependency>
...
</dependencies>
- groupId , artifactId , version :
- scope : compile(default),provided,runtime,test,system
- exclusions
如何查到依賴的類庫?
一般可以通過這個網站:http://www.mvnrepository.com
比如查詢hibernate,可以找到結果清單中的hibernate類庫條目。
點選:http://www.mvnrepository.com/artifact/org.hibernate/hibernate,
選擇版本,比如3.2.6ga,即:http://www.mvnrepository.com/art ... /hibernate/3.2.6.ga
複制文章中的:
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate</artifactId>
<version>3.2.6.ga</version>
</dependency>
到pom.xml檔案中即可。
是否還需要找到hibernate依賴的pom?
不需要,hibernate也會有pom,maven會通過它的pom自動找到它依賴的類庫。
3.2.2.2. 繼承關系
繼承其他pom.xml配置的内容。
maven提供了一個類似java.lang.Object的頂級父pom.xml檔案。
可以通過下面指令檢視目前pom.xml受到超pom.xml檔案的影響:
mvn help:effective-pom
建立一個各種項目可複用的pom.xml檔案:http://easymorse.googlecode.com/svn/trunk/pom/pom.xml
部署要複用的pom.xml檔案:
mvn install
在自己的pom檔案中繼承上述pom:
<parent>
<groupId>com.easymorse</groupId>
<artifactId>pom</artifactId>
<version>0.1</version>
</parent>
3.2.2.3. 聚合關系
用于将多個maven項目聚合為一個大的項目。
比如目錄結構如下:
.
|-- pom.xml
|-- module-a
`-- pom.xml
|-- module-b
`-- pom.xml
|-- module-c
`-- pom.xml
|-- foo-all
`-- pom.xml
那麼總的pom.xml檔案類似:
...
<modules>
<module>module-a</module>
<module>module-b</module>
<module>module-c</module>
<module>foo-all</module>
</modules>
</project>
參考文檔:http://maven.apache.org/plugins/maven-eclipse-plugin/reactor.html
原文示例有誤,見:modules.rar
3.2.3. 其他配置
maven的屬性,是值的占位符,類似EL,類似ant的屬性,比如${X},可用于pom檔案任何指派的位置。
有以下分類:
- env.X:作業系統環境變量,比如${env.PATH}
- project.x:pom檔案中的屬性,比如:<project><version>1.0</version></project>,引用方式:${project.version}
- settings.x:settings.xml檔案中的屬性,比如:<settings><offline>false</offline></settings>,引用方式:${settings.offline}
- Java System Properties:java.lang.System.getProperties()中的屬性,比如java.home,引用方式:${java.home}
- 自定義:在pom檔案中可 以:<properties><installDir>c:/apps/cargo-installs< /installDir></properties>,引用方式:${installDir}
3.3. 其他
3.3.1. 設定離線
在.m2目錄下建立settings.xml檔案(如果沒有的話)
<settings 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/settings-1.0.0.xsd">
<offline>true</offline>
</settings>
3.3.2. 安裝第三方包
經常有第三方包,因為一些原因,在網上repository上沒有,需要自己動手安裝。
比如sun某些版本的jar檔案,比如oracle的驅動。
已oracle驅動程式為例,比如驅動路徑為c:/driver/ojdbc14.jar,是10.2.0.3.0版本
在該網址能夠查到:http://www.mvnrepository.com/artifact/com.oracle/ojdbc14 artifactId和groupId。
mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc14 -Dversion=10.2.0.3.0 -Dpackaging=jar -Dfile=c:/driver/ojdbc14.jar
這樣就可以在pom中依賴引用了:
<dependency>
<groupId>com.oracle</groupId>
<artifactId>ojdbc14</artifactId>
<version>10.2.0.3.0</version>
</dependency>
3.3.3. 部署到tomcat
tomcat配置有管理權限的使用者:conf\tomcat-users.xml
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="manager"/>
<user username="marshal" password="password" roles="manager"/>
</tomcat-users>
在pom檔案的tomcat插件中添加:
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>tomcat-maven-plugin</artifactId>
<configuration>
<url>http://localhost:8080/manager</url>
<server>myserver</server>
<path>/mycontext</path>
</configuration>
</plugin>
在.m2/settings.xml檔案中增加:
<settings 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/settings-1.0.0.xsd">
<servers>
<server>
<id>myserver</id>
<username>marshal</username>
<password>password</password>
</server>
</servers>
</settings>
運作打包部署,在maven項目目錄下:
mvn tomcat:deploy
然後通路:http://localhost:8080/mycontext/ 即可。
撤銷部署:
mvn tomcat:undeploy
啟動web應用:
mvn tomcat:start
停止web應用:
mvn tomcat:stop
重新部署:
mvn tomcat:redeploy
部署展開的war檔案:
mvn war:exploded tomcat:exploded
3.3.4. 未講到的内容
- settings.xml的配置
- pom.xml的詳細配置
- 自定義插件的方法:http://maven.apache.org/plugins/maven-archetype-plugin/examples/archetype.html
- 自定義goal的執行:<preGoal><postGoal>
- 插件的查詢和使用
- 搭建鏡像repository
- 在maven中調用ant