JAVA—咖啡館

          ——歡迎訪問rogerfan的博客,常來《JAVA——咖啡館》坐坐,喝杯濃香的咖啡,彼此探討一下JAVA技術,交流工作經驗,分享JAVA帶來的快樂!本網站部分轉載文章,如果有版權問題請與我聯系。

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

          Maven 2.0:編譯、測試、部署、運行
          http://www.ideagrace.com/html/doc/2006/06/14/00847.html

          二、maven2安裝
          1、首先去官方網站下載之:http://maven.apache.org/download.html,我選擇的是截至目前最新版本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中輸入http://m2eclipse.codehaus.org/
          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 http://maven.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>http://maven.apache.org</url>  
          9. </project>  

          注意:有關這個文件的作用和各節點的作用不是本文的描述重點,可以到maven的官方網站查閱http://maven.apache.org/目前為止,所有的準備工作都已經就緒,現在我們就以一個主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://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>  
          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>http://maven.apache.org</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] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom
          06-8-4 上午09 時46 分49 秒: Downloaded [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom
          06-8-4 上午09 時46 分51 秒: Downloading [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar
          06-8-4 上午09時47分00秒: Downloaded [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar
          ----------------------------------------------------------------
          補充修正:如果出現錯誤提示同時你手頭也有架包的話可以采用maven的指令進行本地化安裝。比如我在安裝hibernate的架包時告訴我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這個提示是說可以先到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。在配置文件中加入如下節點信息即可<localrepository></localrepository>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>http://maven.apache.org</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配置一下就可以編譯了。很方便?,F在就做一個介紹。

          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的操作步驟做一個指南性的說明,實際應用還有很多東西需要實踐。如果發現哪里有錯誤和紕漏也歡迎批評指正!
          posted on 2009-07-13 14:55 rogerfan 閱讀(590) 評論(0)  編輯  收藏 所屬分類: 【開源技術】
          主站蜘蛛池模板: 灵石县| 开原市| 富裕县| 井陉县| 邓州市| 兴化市| 宾川县| 寻甸| 九台市| 神木县| 五大连池市| 杭锦旗| 龙游县| 厦门市| 诸暨市| 天长市| 宁武县| 无极县| 砚山县| 衡山县| 固镇县| 乌苏市| 天等县| 桑植县| 江华| 托里县| 渝北区| 太谷县| 梁平县| 临泉县| 修文县| 依安县| 宣汉县| 大连市| 沅陵县| 华蓥市| 若羌县| 阜城县| 荣成市| 河源市| 揭阳市|