java編寫的用于構(gòu)建系統(tǒng)的自動化工具。
目前版本是2.0.9,注意maven2和maven1有很大區(qū)別,閱讀第三方文檔時需要區(qū)分版本。
The 5 minute test,官方簡易入門文檔;
Getting Started Tutorial,官方入門文檔;
Build Cookbook,官方的cookbook;
POM Reference,POM文件的設(shè)置參考
Settings Reference ,settings文件的設(shè)置參考
Better Builds with Maven,免費的電子書,下載需要注冊。
Maven正在逐漸取代Ant,很多java開源軟件(Spring、Struts2 ……)已經(jīng)使用maven。
通過我寫的商品管理的小例子,演示結(jié)合maven和svn的功能。
從官方網(wǎng)站下載最新的Maven分發(fā)包http://maven.apache.org/download.html,當(dāng)前為2.0.9;
mvn -version
Maven的基本使用介紹通過命令行編寫簡單的java和web項目。
通過maven在命令行下創(chuàng)建普通java項目,也就是main方法執(zhí)行的項目或者jar文件的類庫。
執(zhí)行:
mvn archetype:generate
在交互界面中:
觀察helloworld目錄(Define value for artifactId輸入的項目名稱)下生成的文件和目錄:
測試代碼: src\test\java\com\easymorse\AppTest.java
命令行進入helloworld目錄Define value for artifactId輸入的項目名稱)。
項目打包
mvn package
檢查命令生成了什么?
運行打包的jar文件:
java -cp target\helloworld-1.0-SNAPSHOT.jar com.easymorse.App
編譯源程序
mvn compile
編譯并測試
mvn test
清空生成的文件
mvn clean
將maven項目轉(zhuǎn)化為eclipse項目
命令行運行:
mvn eclipse:eclipse
打開eclipse,菜單選擇:file>import>general>existing projects into workspace,在對話框中選中目錄,導(dǎo)入即可。
如果要清除有關(guān)eclipse項目的配置信息:
mvn -Dwtpversion=1.0 eclipse:clean
聯(lián)合使用
mvn eclipse:clean clean
通過maven在命令行下創(chuàng)建java web項目。
在命令行輸入,這一步和創(chuàng)建java項目類似:
mvn archetype:generate
交互步驟說明:
需要在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>
repository目錄的作用
repository的位置,在用戶目錄的.m2目錄下。
repository目錄的作用,對依賴類庫的緩存。
項目打包
mvn package
啟動tomcat
mvn tomcat:run
啟動jetty
mvn jetty:run
轉(zhuǎn)化為eclipse項目
mvn -Dwtpversion=1.5 eclipse:eclipse
這樣生成wtp插件的web項目。
打開eclipse,菜單選擇:file>import>general>existing projects into workspace,在對話框中選中目錄,導(dǎo)入即可。
另外,需要在eclipse里創(chuàng)建一個classpath變量,名稱為:M2_REPO,值為系統(tǒng)用戶下.m2/repository目錄。
Project Object Model,項目對象模型。
通過xml格式保存的pom.xml文件。
作用類似ant的build.xml文件,功能更強大。
該文件用于管理:源代碼、配置文件、開發(fā)者的信息和角色、問題追蹤系統(tǒng)、組織信息、項目授權(quán)、項目的url、項目的依賴關(guān)系等等。
一個完整的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.0http://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>
<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.0http://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>
依賴關(guān)系列表(dependency list)是POM的重要部分。
<dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.0</version><scope>test</scope></dependency>...</dependencies>
如何查到依賴的類庫?
一般可以通過這個網(wǎng)站:http://www.mvnrepository.com
比如查詢hibernate,可以找到結(jié)果列表中的hibernate類庫條目。
點擊:http://www.mvnrepository.com/artifact/org.hibernate/hibernate,
選擇版本,比如3.2.6ga,即:http://www.mvnrepository.com/art ... /hibernate/3.2.6.ga
復(fù)制文章中的:
<dependency><groupId>org.hibernate</groupId><artifactId>hibernate</artifactId><version>3.2.6.ga</version></dependency>
到pom.xml文件中即可。
是否還需要找到hibernate依賴的pom?
不需要,hibernate也會有pom,maven會通過它的pom自動找到它依賴的類庫。
繼承其他pom.xml配置的內(nèi)容。
maven提供了一個類似java.lang.Object的頂級父pom.xml文件。
可以通過下面命令查看當(dāng)前pom.xml受到超pom.xml文件的影響:
mvn help:effective-pom
創(chuàng)建一個各種項目可復(fù)用的pom.xml文件:http://easymorse.googlecode.com/svn/trunk/pom/pom.xml
部署要復(fù)用的pom.xml文件:
mvn install
在自己的pom文件中繼承上述pom:
<parent><groupId>com.easymorse</groupId><artifactId>pom</artifactId><version>0.1</version></parent>
用于將多個maven項目聚合為一個大的項目。
比如目錄結(jié)構(gòu)如下:
.|-- 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
maven的屬性,是值的占位符,類似EL,類似ant的屬性,比如${X},可用于pom文件任何賦值的位置。
有以下分類:
project.x:pom文件中的屬性,比如:<project><version>1.0</version></project>,引用方式:${project.version}
settings.x:settings.xml文件中的屬性,比如:<settings><offline>false</offline></settings>,引用方式:${settings.offline}
自定義:在pom文件中可以:<properties><installDir>c:/apps/cargo-installs</installDir></properties>,引用方式:${installDir}
在.m2目錄下創(chuàng)建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.0http://maven.apache.org/xsd/settings-1.0.0.xsd"><offline>true</offline></settings>
經(jīng)常有第三方包,因為一些原因,在網(wǎng)上repository上沒有,需要自己動手安裝。
比如sun某些版本的jar文件,比如oracle的驅(qū)動。
已oracle驅(qū)動程序為例,比如驅(qū)動路徑為c:/driver/ojdbc14.jar,是10.2.0.3.0版本
在該網(wǎng)址能夠查到: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>
tomcat配置有管理權(quán)限的用戶: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.0http://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應(yīng)用:
mvn tomcat:start
停止web應(yīng)用:
mvn tomcat:stop
重新部署:
mvn tomcat:redeploy
部署展開的war文件:
mvn war:exploded tomcat:exploded
自定義插件的方法:http://maven.apache.org/plugins/maven-archetype-plugin/examples/archetype.html
自定義goal的執(zhí)行:<preGoal><postGoal>