學(xué)習(xí)maven的使用,看到一篇很實(shí)用的入門教程 收藏
學(xué)習(xí)maven的使用,看到一篇很實(shí)用的入門教程(菜鳥級入門) 收藏
一、前言
早就知道m(xù)aven 在java 項(xiàng)目的管理方面名聲顯赫,于是就想著學(xué)習(xí)掌握之,于是查閱了大量文檔。發(fā)現(xiàn)這些文檔的作者都是java 的大腕,大多都是站在掌握了一定maven 基礎(chǔ)的角度上進(jìn)行介紹,讓我這初學(xué)者看的云里霧里不知所云。于是又去查看maven 的官方網(wǎng)站,總算是有所了解,但一旦動手實(shí)際操作卻又霧里看花。唉,沒辦法,就只有一遍一遍的動手嘗試,經(jīng)過種
種磨難總算是有一點(diǎn)眉目了?,F(xiàn)在就將我的經(jīng)驗(yàn)寫出來,一來避免將來遺忘,二來也給和我一樣的菜鳥們提供一點(diǎn)點(diǎn)的方便。呵呵。本文的主題在于實(shí)用操作,個(gè)中原理還是麻煩大家去查一下java大腕們的文章吧。這里推薦兩篇文章:
二、maven2安裝
1、首先去官方網(wǎng)站下載之:
http://maven.apache.org/download.html ,我選擇的是截至目前最新版本maven2.0.4版本
2、設(shè)置環(huán)境變量:Maven2下載完后,我將其解壓到我的計(jì)算機(jī)的d:\maven204下,目錄結(jié)構(gòu)如下:
D:\
|--Maven204
|-- bin
|-- conf
|-- core
|-- lib
|-- local
環(huán)境變量:(操作系統(tǒng)windows2003)
我的電腦----屬性----高級----環(huán)境變量,點(diǎn)擊“系統(tǒng)變量”下的新建,輸入:變量名 MAVEN_HOME; 變量值d:\Maven204,在系統(tǒng)變量列表中找到系統(tǒng)變量path,打開之,在變量值中追加”;%MAVEN_HOME%\bin”,至此環(huán)境變量設(shè)置完畢。
檢查一下是否已經(jīng)完成安裝,打開dos窗口,輸入mvn –v,如果出現(xiàn)以下信息則表示maven2已經(jīng)安裝成功:
X:〉mvn –v
Maven Version 2.0.4
我已經(jīng)說得夠詳細(xì)了,還不行?那我只能說你比我還菜。
三、用maven2創(chuàng)建第一個(gè)java工程
1、選擇一個(gè)根目錄,我的java工作目錄是D:\eclipse\workspace
2、打開dos窗口采用cd命令進(jìn)入D:\eclipse\workspace目錄下
3、輸入下列指令
D:\eclipse\workspace>mvn archetype:create -DgroupId=com.efn -DartifactId=study
指令執(zhí)行完畢會出現(xiàn)如下的目錄結(jié)構(gòu):
study
|-- pom.xml
`-- src
|-- main
| `-- java
| `-- com
| `-- mycompany
| `-- app
| `-- App.java
`-- test
`-- java
`-- com
`-- mycompany
`-- app
`-- AppTest.java
四、生成eclipse工程文件
我采用的開發(fā)工具是eclipse,所以用maven的eclipse參數(shù)生成eclipse工程文件。輸入如下
1、 采用dos的cd命令進(jìn)入study目錄
2、 輸入指令:mvn eclipse:eclipse 如下所示:
D:\eclipse\workspace\study>mvn eclipse:eclipse
指令執(zhí)行完畢后,發(fā)現(xiàn)多了兩個(gè)文件:.classpath和.project
五、下載maven的eclipse插件
1、打開eclipse
2、打開菜單 help -Software updates-Find and Install
3、選擇第二項(xiàng),進(jìn)入下一步
4、點(diǎn)擊按鈕“New Remote Site…”
5、在Name中輸入:Maven2,在URL中輸入
http://m2eclipse.codehaus.org/ Ok,現(xiàn)在一切都是自動化的,你所需要做的就是等待并按提示按按鈕。
六、導(dǎo)入工程
剛才已經(jīng)生成了eclipse的工程文件,現(xiàn)在導(dǎo)入之。菜單File-import ,按“下一步”,選擇工程文件導(dǎo)入完畢后,工程管理透視圖就會出現(xiàn)study節(jié)點(diǎn)了,在工程節(jié)點(diǎn)上,按鼠標(biāo)右鍵,打開彈出菜單,選擇maven2菜單項(xiàng),彈出子菜單->Enable,點(diǎn)擊之打開,在Group Id中輸入:study即可。
打開study的pom.xml文件,會有如下類似內(nèi)容:
xml 代碼
< project xmlns = "
http://maven.apache.org/POM/4.0.0 http://maven. " apache.org/maven-v4_0_0.xsd >
< modelVersion > 4.0.0 </ modelVersion >
< groupId > com.efn </ groupId >
< artifactId > study </ artifactId >
< packaging > jar </ packaging >
< version > 1.0-SNAPSHOT </ version >
< name > Maven Quick Start Archetype </ name >
< url >
http://maven.apache.org </ url >
< dependencies >
< dependency >
< groupId > junit </ groupId >
< artifactId > junit </ artifactId >
< version > 3.8.1 </ version >
</ dependency >
</ dependencies >
</ project >
如果本地倉庫沒有,則向?qū)aven的服務(wù)器下載架包,并在控制臺輸出下載日志如下:
06-8-4 上午09時(shí)21分07秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)21分11秒: Reading /study/pom.xml
06-8-4 上午09時(shí)21分11秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)21分18秒: Reading /study/pom.xml
06-8-4 上午09時(shí)21分18秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)21分19秒: Reading /study/pom.xml
06-8-4 上午09時(shí)21分19秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)36分33秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)37分11秒: Reading / study /pom.xml
06-8-4 上午09時(shí)37分11秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)37分15秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)40分07秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)40分08秒: Reading / study /pom.xml
06-8-4 上午09時(shí)40分08秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)46分24秒: Reading / study /pom.xml
06-8-4 上午09時(shí)46分24秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)46分28秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)46分40秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)46分47秒: Local repository folder "" does not exist
06-8-4 上午09時(shí)46分47秒: Reading / study /pom.xml
06-8-4 上午09時(shí)46分47秒: Local repository folder "" does not exist
06-8-4 上午09 時(shí)46 分49 秒: Downloading [central] ->
http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom 06-8-4 上午09 時(shí)46 分49 秒: Downloaded [central] ->
http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom 06-8-4 上午09 時(shí)46 分51 秒: Downloading [central] ->
http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar 06-8-4 上午09時(shí)47分00秒: Downloaded [central] ->
http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar ----------------------------------------------------------------
補(bǔ)充修正:如果出現(xiàn)錯誤提示同時(shí)你手頭也有架包的話可以采用maven的指令進(jìn)行本地化安裝。比如我在安裝hibernate的架包時(shí)告訴我jta無法下載。要求本地化安裝,給出的提示如下:
1) javax.transaction:jta:jar:1.0.1B
Try downloading the file manually from:http://java.sun.com/products/jta.Then , install it using the command:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta \ -Dversion=1.0.1B -Dpackaging=jar -Dfile=/path/to/filePath to dependency:
1) com.efn:mywebapp:war:1.0-SNAPSHOT
2) org.hibernate:hibernate:jar:3.1rc2
3) javax.transaction:jta:jar:1.0.1B
----------
1 required artifact is missing.for artifact: com.efn:mywebapp-1.0-SNAPSHOT.war這個(gè)提示是說可以先到sun的網(wǎng)站下載jta架包,然后采用命令行的方式按要求安裝,因?yàn)槲冶緛砭陀写思馨?,于是拷到一個(gè)方便的位置,比如c:\,然后在命令行下輸入:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=C:/jta.jar
執(zhí)行完畢后,一切OK!
--------------------------------------------------------------
2、手工配置
手工配置比起自動化來說是麻煩了些,不過任何東東掌握在自己手里總歸是吃飽喝足誰也不服了不是J。而且配置一次就可以受益終身。更重要的是能解決自動化完成不了的任務(wù)。比如我現(xiàn)在要配置oracle的jdbc驅(qū)動,采用自動化就提示我下載不了讓我改變下載地址等等,真累。
算了還是自己來吧。
手工配置前還是先介紹一下相關(guān)背景知識。首先了解一下jar倉庫的概念,maven采用集中化的方式管理架包,凡用maven構(gòu)建的java工程都可以重用統(tǒng)一管理下的架包,所以必須有一個(gè)統(tǒng)一存放jar文件的地方,這就是jar倉庫,不論是開發(fā)還是部署都會建立一個(gè)本地倉庫。這個(gè)倉庫的位置默認(rèn)是 X:\Documents and Settings\Administrator.LIPENG\.m2\repository(X是你操作系統(tǒng)所在盤符)下,你可以修改配置文件改變默認(rèn)的輸出位置。該配置文件在maven目錄下的conf子目錄下。文件名叫settings.xml。在配置文件中加入如下節(jié)點(diǎn)信息即可D:/Repository。不過不建議改變,好像eclipse的maven插件只認(rèn)默認(rèn)的輸出位置。我就是在這方面出了問題搞了半天才發(fā)現(xiàn)是輸出路徑的問題,也許是我還
沒有玩轉(zhuǎn)插件。誰要是解決此問題別忘了跟大家共享。
現(xiàn)在我們分析一下配置文件pom.xml的結(jié)構(gòu),以junit為例,格式如下:
xml 代碼
< dependencies >
< dependency >
< groupId > junit </ groupId >
< artifactId > junit </ artifactId >
< version > 3.8.1 </ version >
</ dependency >
</ dependencies >
在來看看本地倉庫目錄結(jié)構(gòu)
Repository
`-- junit
|-- junit
| `-- 3.8.1
| `-- junit-3.8.1.jar
現(xiàn)在大家應(yīng)該明白了吧,多余的話不說啦。照葫蘆畫瓢就是。不過注意先建目錄后寫配置文件,否則一旦保存,智能的插件就馬上開始下載了…
現(xiàn)在開始手動建立oracle的jdbc目錄并配置文件,首先建立目錄結(jié)構(gòu)如下:
Repository
`-- ojdbc
|-- ojdbc
| `-- 14
| `-- ojdbc-14.jar
如果你手頭的jar文件名叫ojdbc14.jar,則改為ojdbc-14.jar,寫配置文件:
xml 代碼
< dependency >
< groupId > ojdbc </ groupId >
< artifactId > ojdbc </ artifactId >
< version > 14 </ version >
</ dependency >
那么現(xiàn)在一個(gè)完整的pom.xml文件如下:
xml 代碼
<? xml version = "1.0" ?>
< project >
< modelVersion > 4.0.0 </ modelVersion >
< groupId > com.mycompany.app </ groupId >
< artifactId > myapp </ artifactId >
< name > Maven Quick Start Archetype </ name >
< version > 1.0-SNAPSHOT </ version >
< url >
http://maven.apache.org </ url >
< dependencies >
< dependency >
< groupId > ojdbc </ groupId >
< artifactId > ojdbc </ artifactId >
< version > 14 </ version >
</ dependency >
< dependency >
< groupId > junit </ groupId >
< artifactId > junit </ artifactId >
< version > 3.8.1 </ version >
</ dependency >
</ dependencies >
</ project >
保存之,則發(fā)現(xiàn)工程管理透視圖發(fā)生了一點(diǎn)變化,依此方法再加上jdbc的架包,現(xiàn)在可以開始寫程序了,建一個(gè)類并添加main函數(shù),編寫程序如下:
java 代碼
public static void main( String[] args )
{
Connection conn = null ;
PreparedStatement ps = null ;
ResultSet rs = null ;
try {
Class.forName( "oracle.jdbc.driver.OracleDriver" );
conn = DriverManager.getConnection( "jdbc:oracle:thin:@(description=(ad dress_list=(address=(protocol=TCP)(port=1521)(host=192.168.0.240)))(connect_data=(SE RVER = DEDICATED)(SERVICE_NAME = db.efriendnet.com)))" , "efnx" , "efnx" );
ps = conn.prepareStatement( "select * From tb_partyinfo" );
rs = ps.executeQuery();
while (rs.next())
{
System.out.println(rs.getString( "topic" ));
}
} catch (Exception e) {
System.out.print(e.getMessage());
}
finally
{
if (rs != null ) { try {rs.close();} catch (SQLException e) {}}
if (ps != null ) { try {ps.close();} catch (SQLException e) {}}
if (conn != null ) { try {conn.close();} catch (SQLException e) {}}
}
}
別忘了import相應(yīng)的包
八、編譯程序
采用maven構(gòu)建系統(tǒng),則編譯過程就獨(dú)立了出來。這時(shí)你再用eclipse自帶的編譯工具就不起作用了。所以要想編譯、調(diào)試、運(yùn)行還要做一些工作。以前是在dos命令行方式下進(jìn)行編譯,現(xiàn)在的插件很好用,在eclipse配置一下就可以編譯了。很方便?,F(xiàn)在就做一個(gè)介紹。
Eclipse有一個(gè)擴(kuò)展工具就是用來集成其他構(gòu)建工具的在工程的節(jié)點(diǎn)上點(diǎn)擊鼠標(biāo)右鍵,選擇屬性,在“編譯”的右邊窗口選擇”新建”按鈕,在對話框的“name”中輸入:study,點(diǎn)擊“Browse Workspace…”列出工程列表供選擇。
選擇完畢后,在goals中輸入package。別忘了apply.好了,讓我們Run吧。如果一切正常,
控制臺會打出maven的編譯信息如下:
[INFO] ---------------------------------------------------------------------
[INFO] Building Maven Quick Start Archetype
[INFO] task-segment: [package]
[INFO] ---------------------------------------------------------------------
[INFO] resources:resources
[INFO] Using default encoding to copy filtered resources.
[INFO] compiler:compile
[INFO] Nothing to compile - all classes are up to date
[INFO] resources:testResources
[INFO] Using default encoding to copy filtered resources.
[INFO] compiler:testCompile
[INFO] Nothing to compile - all classes are up to date
[INFO] surefire:test
[INFO] Surefire report directory: D:\eclipse\workspace\study\target\s
urefire-reports
-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running com.efn.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.157 sec
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] jar:jar
[INFO] Building jar: D:\eclipse\workspace\study\target\study-1.0-SNAPSHOT.jar
[INFO] ----------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ---------------------------------------------------------------------
[INFO] Total time: 4 second
[INFO] Finished at: Fri Aug 04 10:55:42 CST 2006
[INFO] Memory 2M/7M
[INFO] --------------------------------------------------------------------
注意,別忘了每一次程序改動完畢后都要經(jīng)過這一步編譯。因?yàn)檫@是maven的編譯器!
九、調(diào)試程序
經(jīng)過以上步驟我們已經(jīng)完成了mave管理下的軟件生命周期,但是作為一個(gè)程序開發(fā)人員我們還要進(jìn)行調(diào)試。這里的調(diào)試設(shè)置和普通的java程序的調(diào)試是一樣的。
首先,打開debug對話框:
因?yàn)槭且粋€(gè)一般的java應(yīng)用程序,所以我們選擇 Java Application,點(diǎn)擊“New”按鈕,輸入一些相應(yīng)的參數(shù),apply-Debug
Ok,一切正常!希望你也順利!
十、結(jié)束語
本文只是簡單的對maven的操作步驟做一個(gè)指南性的說明,實(shí)際應(yīng)用還有很多東西需要實(shí)踐。如果發(fā)現(xiàn)哪里有錯誤和紕漏也歡迎批評指正!