maven構建與使用

1,首先到http://maven.apache.org/download.html 下載合適的Maven版本,我下載的是Maven 2.0.9 (zip)。

2,解壓文件到你想安裝的目錄,我的是F:/apache-maven-2.0.9。

3,在環境變量的用戶變量中增加名爲M2_HOME,值爲F:/apache-maven-2.0.9的變量,注意在目錄F:/apache- maven-2.0.9的最後不要加/,即不能爲F:/apache-maven-2.0.9/。同時添加名爲M2,值爲%M2_HOME%/bin的環 境變量。在環境變量path的值中加入%M2%.

4,控制檯運行mvn -version,顯示如下信息,則maven基本安裝完成


 

App工程
    可以使用Maven的archetype插件來創建新工程,命令如下:
    D:/maven/demo>mvn archetype:create -DgroupId=ce.demo.mvn -DartifactId=app
該工程的 groupId是ce.demo.mvn,那麼該工程的源文件將放在Java包ce.demo.mvn中。artifactId是app,那麼該工程根目 錄的名稱將爲app。

WebApp工程
    我們仍然如創建app工程一樣使用archetype插件來創建webapp工程,命令如下:
    D:/maven/demo>mvn archetype:create -DgroupId=ce.demo.mvn -DartifactId=webapp -DarchetypeArtifactId=maven-archetype-webapp
    第一次運行此命令時,也會從central倉庫中下載一些與Web應用相關的artifact(如javax.servlet)。此命令與創建app的命 令的不同之處是,多設置了一個屬性archetypeArtifacttId,該屬性的值爲maven-archetype-webapp。即告訴 Maven,將要創建的工程是一個Web應用工程。創建app工程時沒有使用該屬性值,是由於archetype默認創建的是應用程序工程。同樣的,執行 完該命令之後,會出現如下標準目錄佈局:

 

四、生成eclipse工程文件
我採用的開發工具是 eclipse,所以用maven的eclipse參數生成eclipse工程文件。輸入如下
1、 採用dos的cd命令進入study目錄
2、 輸入指令:mvn eclipse:eclipse 如下所示:
D:/eclipse/workspace/study>mvn eclipse:eclipse
指令執行完畢後,發現多了兩個文件:.classpath和.project


五、下載maven的eclipse插件
1、打開 eclipse
2、打開菜單 help -Software updates-Find and Install
3、選擇第二項,進入下 一步
4、點擊按鈕“New Remote Site…”
5、在Name中輸入:Maven2,在URL中輸入 [url]http://m2eclipse.codehaus.org/[/url]
Ok,現在一切都是自動化的,你所需要做的就是等待並按提 示按按鈕。

六、導入工程
剛纔已經生成了eclipse的工程文件,現 在導入之。菜單File-import ,按“下一步”,選擇工程文件導入完畢後,工程管理透視圖就會出現study節點了,在工程節點上,按鼠標右鍵,打開彈出菜單,選擇maven2菜單項, 彈出子菜單->Enable,點擊之打開,在Group Id中輸入:study即可。

打開study的pom.xml文件,會有如下類似內容:

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 [url]http://maven.apache.org/maven-v4_0_0.xsd[/url]" >       < 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 > [url]http://maven.apache.org[/url] </ url >    </ project >   

注意:有關這個文件的作用和各節點的作用不是本文的描述重點,可以 到maven的官方網站查閱[url]http://maven.apache.org/[/url] 目 前爲止,所有的準備工作都已經就緒,現在我們就以一個主main函數訪問數據庫爲例介紹在實際開發中的使用。

七、搭建架包
每一個java工程都不免使用第三方的架 包,Maven的好處就是可以統一管理這些架包,並使多個java工程共享這些架包。我們所需要做的就是按規則編輯pom.xml文件。Maven已經非 常智能,使用maven的eclipse插件的嚮導,只要輸入參數就可以將配置文件生成出來。我們的例子是用jdbc方式訪問oracle的數據庫。所以 需要jdbc和oracle的架包的支持。下面我們就來搭建這兩個架包到study工程裏來。

有兩種方式可以採用:
1、自動向導
第一種是採用向 導方式並讓嚮導直接去maven的服務器上下載你需要的架包,這種方式存在一定的風險,一來可能maven的服務器上並沒有你需要的東東,二來每次智能的 maven總是去尋找那並不存在的東東。拋出一大堆紅字提示不說,達不到預期目標纔是讓人鬱悶。不過爲了保證文檔的完整性,還是給出操作步驟。以 junit爲例(這個東東倒是沒有問題,呵呵)當工程的maven被Enable後,彈出菜單的maven2子菜,選擇子菜單的“Add Dependency”菜單項,在Query中輸入“junit”,嚮導會自動列出相關列表供選擇。選擇你最需要的架包,按“OK” 按鈕。
如果 你的本地倉庫已經存在該架包,則嚮導只在pom.xml加入依賴項信息,pom.xml文件的內容如下
xml 代碼
< project   xmlns = "http://maven.apache.org/POM/4.0.0"   xmlns:xsi ="http:// [url]www.w3.org/2001/XMLSchema-instance[/url]"   xsi:schemaLocation ="http://maven.apache.org/POM/4.0.0 [url]http://maven.[/url] " 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 > [url]http://maven.apache.org[/url] </ url >    < dependencies >    < dependency >    < groupId > junit </ groupId >    < artifactId > junit </ artifactId >    < version > 3.8.1 </ version >    </ dependency >    </ dependencies >    </ project >   
如果本地倉庫沒有,則嚮導會去maven的服務器下載架包,並在控制檯輸出 下載日誌如下:
06-8-4 上午09時21分07秒: Local repository folder "" does not exist
06-8-4 上午09時21分11秒: Reading /study/pom.xml
06-8-4 上午09時21分11秒: Local repository folder "" does not exist
06-8-4 上午09時21分18秒: Reading /study/pom.xml
06-8-4 上午09時21分18秒: Local repository folder "" does not exist
06-8-4 上午09時21分19秒: Reading /study/pom.xml
06-8-4 上午09時21分19秒: Local repository folder "" does not exist
06-8-4 上午09時36分33秒: Local repository folder "" does not exist
06-8-4 上午09時37分11秒: Reading / study /pom.xml
06-8-4 上午09時37分11秒: Local repository folder "" does not exist
06-8-4 上午09時37分15秒: Local repository folder "" does not exist
06-8-4 上午09時40分07秒: Local repository folder "" does not exist
06-8-4 上午09時40分08秒: Reading / study /pom.xml
06-8-4 上午09時40分08秒: Local repository folder "" does not exist
06-8-4 上午09時46分24秒: Reading / study /pom.xml
06-8-4 上午09時46分24秒: Local repository folder "" does not exist
06-8-4 上午09時46分28秒: Local repository folder "" does not exist
06-8-4 上午09時46分40秒: Local repository folder "" does not exist
06-8-4 上午09時46分47秒: Local repository folder "" does not exist
06-8-4 上午09時46分47秒: Reading / study /pom.xml
06-8-4 上午09時46分47秒: Local repository folder "" does not exist
06-8-4 上午09 時46 分49 秒: Downloading [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom[/url]
06-8-4 上午09 時46 分49 秒: Downloaded [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom[/url]
06-8-4 上午09 時46 分51 秒: Downloading [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar[/url]
06-8-4 上午09時47分00秒: Downloaded [central] -> [url]http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar[/url]
----------------------------------------------------------------
補 充修正:如果出現錯誤提示同時你手頭也有架包的話可以採用maven的指令進行本地化安裝。比如我在安裝hibernate的架包時告訴我jta無法下 載。要求本地化安裝,給出的提示如下:
1) javax.transaction:jta:jar:1.0.1B
Try downloading the file manually from:[url]http://java.sun.com/products/jta.Then[/url], 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這個提示是說可以先到sun的網站下載jta架包,然後採用命令行的方式按要求安 裝,因爲我本來就有此架包,於是拷到一個方便的位置,比如c:/,然後在命令行下輸入:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=C:/jta.jar
執行完畢後,一切OK!
--------------------------------------------------------------

2、手工配置
        手工配置比起自動化來說是麻煩了些,不過任何東東掌握在自己手裏總歸是吃飽喝足誰也不服了不是J。而且配置一次就可以受益終身。更重要的是能解決自動化完 成不了的任務。比如我現在要配置oracle的jdbc驅動,採用自動化就提示我下載不了讓我改變下載地址等等,真累。
        算了還是自己來吧。
        手工配置前還是先介紹一下相關背景知識。首先了解一下jar倉庫的概念,maven採用集中化的方式管理架包,凡用maven構建的java工程都可以重 用統一管理下的架包,所以必須有一個統一存放jar文件的地方,這就是jar倉庫,不論是開發還是部署都會建立一個本地倉庫。這個倉庫的位置默認是 X:/Documents and Settings/Administrator.LIPENG/.m2/repository(X是你操作系統所在盤符)下,你可以修改配置文件改變默認 的輸出位置。該配置文件在maven目錄下的conf子目錄下。文件名叫settings.xml。在配置文件中加入如下節點信息即可D:/Repository。 不過不建議改變,好像eclipse的maven插件只認默認的輸出位置。我就是在這方面出了問題搞了半天才發現是輸出路徑的問題,也許是我還
沒 有玩轉插件。誰要是解決此問題別忘了跟大家共享。
現在我們分析一下配置文件pom.xml的結構,以junit爲例,格式如下:
xml 代碼
< dependencies >    < dependency >    < groupId > junit </ groupId >    < artifactId > junit </ artifactId >    < version > 3.8.1 </ version >    </ dependency >    </ dependencies >   
在來看看本地倉庫目錄結構
Repository
`-- junit
|-- junit
| `-- 3.8.1
| `-- junit-3.8.1.jar
現在大家應該明白了 吧,多餘的話不說啦。照葫蘆畫瓢就是。不過注意先建目錄後寫配置文件,否則一旦保存,智能的插件就馬上開始下載了…

現在開始手動建立oracle的jdbc目錄並配置文件,首先建立 目錄結構如下:
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 >   
那麼現在一個完整的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 > [url]http://maven.apache.org[/url] </ 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 >   

保存之,則發現工程管理透視圖發生了一點變化,依此方法再加上 jdbc的架包,現在可以開始寫程序了,建一個類並添加main函數,編寫程序如下:
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相應的包

八、編譯程序
採用maven構建系統,則編譯過程就獨立了 出來。這時你再用eclipse自帶的編譯工具就不起作用了。所以要想編譯、調試、運行還要做一些工作。以前是在dos命令行方式下進行編譯,現在的插件 很好用,在eclipse配置一下就可以編譯了。很方便。現在就做一個介紹。

Eclipse有一個擴展工具就是用來集成其他構建工具的在工程的 節點上點擊鼠標右鍵,選擇屬性,在“編譯”的右邊窗口選擇”新建”按鈕,在對話框的“name”中輸入:study,點擊“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] --------------------------------------------------------------------
注 意,別忘了每一次程序改動完畢後都要經過這一步編譯。因爲這是maven的編譯器!

九、調試程序
經過以上步驟我們已經完成了mave管理下的 軟件生命週期,但是作爲一個程序開發人員我們還要進行調試。這裏的調試設置和普通的java程序的調試是一樣的。
首先,打開debug對話框:
        因爲是一個一般的java應用程序,所以我們選擇 Java Application,點擊“New”按鈕,輸入一些相應的參數,apply-Debug
Ok,一切正常!希望你也順利!

十、結束語
本文只是簡單的對maven的操作步驟做一個指 南性的說明,實際應用還有很多東西需要實踐。如果發現哪裏有錯誤和紕漏也歡迎批評指正!
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章