maven詳解

一、前言
        早就知道maven 在java 項目的管理方面名聲顯赫,於是就想着學習掌握之,於是查閱了大量文檔。發現這些文檔的作者都是java 的大腕,大多都是站在掌握了一定maven 基礎的角度上進行介紹,讓我這初學者看的雲裏霧裏不知所云。於是又去查看maven 的官方網站,總算是有所瞭解,但一旦動手實際操作卻又霧裏看花。唉,沒辦法,就只有一遍一遍的動手嘗試,經過種
種磨難總算是有一點眉目了。現在就將我的經驗寫出來,一來避免將來遺忘,二來也給和我一樣的菜鳥們提供一點點的方便。呵呵。本文的主題在於實用操作,箇中原理還是麻煩大家去查一下java大腕們的文章吧。這裏推薦兩篇文章:


Maven 2.0:編譯、測試、部署、運行


Maven2 的新特性
[url]http://www-128.ibm.com/developerworks/cn/opensource/os-maven2/index.html[/url]


二、maven2安裝
1、首先去官方網站下載之:[url]http://maven.apache.org/download.html[/url],我選擇的是截至目前最新版本maven2.0.4版本
2、設置環境變量:Maven2下載完後,我將其解壓到我的計算機的d:\maven204下,目錄結構如下:
D:\
|--Maven204
|-- bin
|-- conf
|-- core
|-- lib
|-- local


環境變量:(操作系統windows2003)
        我的電腦----屬性----高級----環境變量,點擊“系統變量”下的新建,輸入:變量名 MAVEN_HOME; 變量值d:\Maven204,在系統變量列表中找到系統變量path,打開之,在變量值中追加”;%MAVEN_HOME%\bin”,至此環境變量設置完畢。
        檢查一下是否已經完成安裝,打開dos窗口,輸入mvn –v,如果出現以下信息則表示maven2已經安裝成功:
X:〉mvn –v
Maven Version 2.0.4


我已經說得夠詳細了,還不行?那我只能說你比我還菜。

 

三、用maven2創建第一個java工程
1、選擇一個根目錄,我的java工作目錄是D:\eclipse\workspace
2、打開dos窗口採用cd命令進入D:\eclipse\workspace目錄下
3、輸入下列指令
D:\eclipse\workspace>mvn archetype:create -DgroupId=com.efn -DartifactId=study
指令執行完畢會出現如下的目錄結構:
study
|-- pom.xml
`-- src
|-- main
| `-- java
| `-- com
| `-- mycompany
| `-- app
| `-- App.java
`-- test
`-- java
`-- com
`-- mycompany
`-- app
`-- AppTest.java


四、生成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 代碼

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

  2.   <modelVersion>4.0.0</modelVersion>  

  3.   <groupId>com.efn</groupId>  

  4.   <artifactId>study</artifactId>  

  5.   <packaging>jar</packaging>  

  6.   <version>1.0-SNAPSHOT</version>  

  7.   <name>Maven Quick Start Archetype</name>  

  8.   <url>[url]http://maven.apache.org[/url]</url>  

  9. </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 代碼

  1. <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>  

  2. <modelVersion>4.0.0</modelVersion>  

  3. <groupId>com.efn</groupId>  

  4. <artifactId>study</artifactId>  

  5. <packaging>jar</packaging>  

  6. <version>1.0-SNAPSHOT</version>  

  7. <name>Maven Quick Start Archetype</name>  

  8. <url>[url]http://maven.apache.org[/url]</url>  

  9. <dependencies>  

  10. <dependency>  

  11. <groupId>junit</groupId>  

  12. <artifactId>junit</artifactId>  

  13. <version>3.8.1</version>  

  14. </dependency>  

  15. </dependencies>  

  16. </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 代碼

  1. <dependencies>  

  2. <dependency>  

  3. <groupId>junit</groupId>  

  4. <artifactId>junit</artifactId>  

  5. <version>3.8.1</version>  

  6. </dependency>  

  7. </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 代碼

  1. <dependency>  

  2. <groupId>ojdbc</groupId>  

  3. <artifactId>ojdbc</artifactId>  

  4. <version>14</version>  

  5. </dependency>  

那麼現在一個完整的pom.xml文件如下:

xml 代碼

  1. <?xml version="1.0"?>

  2. <project>  

  3. <modelVersion>4.0.0</modelVersion>  

  4. <groupId>com.mycompany.app</groupId>  

  5. <artifactId>myapp</artifactId>  

  6. <name>Maven Quick Start Archetype</name>  

  7. <version>1.0-SNAPSHOT</version>  

  8. <url>[url]http://maven.apache.org[/url]</url>  

  9. <dependencies>  

  10. <dependency>  

  11. <groupId>ojdbc</groupId>  

  12. <artifactId>ojdbc</artifactId>  

  13. <version>14</version>  

  14. </dependency>  

  15. <dependency>  

  16. <groupId>junit</groupId>  

  17. <artifactId>junit</artifactId>  

  18. <version>3.8.1</version>  

  19. </dependency>  

  20. </dependencies>  

  21. </project>  


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

java 代碼

  1. public static void main( String[] args )   

  2. {   

  3. Connection conn = null;   

  4. PreparedStatement ps = null;   

  5. ResultSet rs = null;   

  6. try {   

  7. Class.forName("oracle.jdbc.driver.OracleDriver");   

  8. conn = DriverManager.getConnection("jdbc:oracle:thin:@(description=(address_list=(address=(protocol=TCP)(port=1521)(host=192.168.0.240)))(connect_data=(SERVER = DEDICATED)(SERVICE_NAME = db.efriendnet.com)))""efnx""efnx");   

  9. ps = conn.prepareStatement("select * From tb_partyinfo");   

  10. rs = ps.executeQuery();   

  11. while(rs.next())   

  12. {   

  13. System.out.println(rs.getString("topic"));   

  14. }   

  15. catch (Exception e) {   

  16. System.out.print(e.getMessage());   

  17. }   

  18. finally  

  19. {   

  20. if (rs != null) {try {rs.close();} catch (SQLException e) {}}   

  21. if (ps != null) {try {ps.close();} catch (SQLException e) {}}   

  22. if (conn != null) {try {conn.close();} catch (SQLException e) {}}   

  23. }   

  24. }  


別忘了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的操作步驟做一個指南性的說明,實際應用還有很多東西需要實踐。如果發現哪裏有錯誤和紕漏也歡迎批評指正!


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章