Myeclipse專案加入maven支援
專案還是之前的專案,現在我要在原有專案中加入maven支援,但是myeclipse只能在建立web project時有選項可以為專案加入maven支援,但我的專案已經生成好久了,所以只能自已動手了。
步驟如下;(做完之後好幾天才寫的,難免有遺漏)
注:我的環境為:myeclipse7.5和maven2.2;myeclipse7.0自帶的好像是maven1.*(未查證),所以步驟可能不能,推薦使用maven2
1.修改目錄
先要將目錄結構改為maven專案的目錄結構做法是:
A:先將原src重新命名為"java",(如果使用svn改完命後要先提交,不然不讓建立src目錄)
B:建立"src"目錄,在src下建立"main"目錄,把重新命名的"java"目錄拽到"main"下,這時如果"java"變為普通目錄,那麼把它改為原始碼目錄(右鍵->build path-> use as source folder)
C: 把原來的WebRoot目錄重新命名為"webapp",把它拽到"main"下
D:建立其它所需目錄,src/test/java(原始碼目錄) ; src/test/resources ; src/main/resources ;target等.
由於改變了目錄所以現在專案已經無法再用原來的方法部署了,現在做下一部改下目錄的設定讓專案可以用原方法部署
2.將 webapp設定WebRoot目錄
到工作目錄你的專案下的.mymetadata(隱藏)檔案中的<attribute name="webrootdir" value="WebRoot" /> 改為
<attribute name="webrootdir" value="/src/main/webapp " />
修改專案下的.classpath檔案 中的 原始碼輸出路徑為: <classpathentry kind="src" output="src/main/webapp/WEB-INF/classes " path="src/main/java"/> 修改 主輸出路徑為:<classpathentry kind="output" path="src/main/webapp/WEB-INF/classes"
重啟eclipse,現在又可以以原來的方法部署專案了。
3.建立pom.xml檔案和對相關框架的依賴
新建一個web project專案並讓為它新增maven支援,然後再這個專案中加入你所使用的框架支援如:hibernate,spring,jsf等所有你需要並myEclipse可以提供的支援(這個過程可能要等一段時間,因為maven會自動到主映象站下載所需的jar包和pom檔案到本地庫),這時MyEclipse會為你在pom中加入你所需要的依賴關係。把這個pom.xml 檔案拷到你的專案根目錄並修改groupId和artifactId為你的專案的名子,現在在為專案加入一個maven的Build配置,讓MyEclipse認為這個專案是一個Maven專案,修改專案下的.project檔案 :
buildSpec小節 加入 :
<buildCommand>
<name>org.maven.ide.eclipse.maven2Builder</name>
<arguments>
</arguments>
</buildCommand>
natures小節中加入
<nature>org.maven.ide.eclipse.maven2Nature</nature>
重啟Eclipse,發現現在專案資料夾上已經有一個M圖示了,說明Eclipse已經認為這是一個Maven專案了
注:為了能使專案還能以原來的方法部署現在暫時不要刪除原來引用jar的的Build path,在最後再刪除它們
4.加入其它jar包的依賴
現在的pom.xml檔案已經有了我們所需框架的jap依賴定義了,但是你可能和我一樣有一些其它jar包的依賴要把它加入到pom.xml檔案,做法如下:先到maven的庫查詢網站去查詢你所需的jar檔案(注意版本),如果找到直接把它加入到你的pom.xml檔案中,如:
<dependency>
<groupId>mx4j</groupId>
<artifactId>mx4j</artifactId>
<version>3.0.1</version>
</dependency>
這時maven會自動到maven庫中去下載這個jar和這個jar所依賴的jar ,注意在你的maven更新過程中可能出現存在迴圈依賴的提示,這是因為你所加入的其它包中已經通過依賴關係加入了這個jar包,而你又手到加入了這個包,所以你只要放心的把你手動加入的依賴包定義刪除就行了。由於Maven會自動加入包的依賴關係,所以很可能會造成包的衝突,遇到最多的應該是hibernate的asm包衝突,這時你可以定義一下要求hibernate不下載指定的依賴jar,像這樣:
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate</artifactId>
<version>3.2.5.ga</version>
<exclusions>
<exclusion>
<groupId>asm</groupId>
<artifactId>asm</artifactId>
</exclusion>
<exclusion>
<groupId>asm</groupId>
<artifactId>asm-attrs</artifactId>
</exclusion>
<exclusion>
<groupId>cglib</groupId>
<artifactId>cglib</artifactId>
</exclusion>
</exclusions>
</dependency>
另外我還遇到了xfire的spring1.2和我使用的spring2.0衝突
<dependency>
<groupId>org.codehaus.xfire</groupId>
<artifactId>xfire-spring</artifactId>
<version>1.2.6</version>
<exclusions>
<exclusion>
<groupId>org.springframework</groupId>
<artifactId>spring</artifactId>
</exclusion>
<exclusion>
<groupId>org.springframework</groupId>
<artifactId>spring-mock</artifactId>
</exclusion>
</exclusions>
</dependency>
現在已經為專案加入了maven遠端庫中已有的jar支援了,但是有可能像我一樣還需要一些在maven遠端庫中不存在的jar,像這樣的問題有兩個解決辦法一種是在公司內部自已架一個maven庫,這種做法很費力,但如果你的公司很大,並且有很多maven專案的話,用這種方法就比較實用和方便的,我用的是第二種方法,直接把所需的jar加入到本地庫上,並在pom中引用,方法如下:
A:你要先下載一個maven裝到你的機器中(不知道怎樣直接使用MyEclipse的maven),裝好後在命令列執行mvn -v 如果正確反回則安裝成功(安裝很簡單,解壓後設下環境變數就行了,一個是M2_HOME,並把你的%M2_HOME%/bin加入到path中,另外確保你有JAVA_HOME的環境變數)
B:執行mvn命令將jar加入到本地庫,這是我加入一個shark包的命令如下:
mvn install:install-file -Dfile=sharkcaching-lru.jar -DgroupId=com.dgsoft.extend -DartifactId=sharkcaching-lru -Dversion=2.2.1 -Dpackaging=jar
注意修改為你的。引數依次為:jar檔名,組織名,定義名,版本,型別。
C:把你加入的jar定義到pom.xml,針對上面的有如下定義:
<dependency>
<groupId>com.dgsoft.extend</groupId>
<artifactId>sharkcaching-lru</artifactId>
<version>2.2.1</version>
</dependency>
D:如果你也和我一樣有很多這樣的包,那麼和以寫一個.bat檔案(我在linux下是.sh),方便以後加入,另外我還用DELPHI寫了一個自動查詢資料夾下的*.jar檔案並自動生成安裝jar到本地庫的bat(或sh)檔案和pom.xml檔案的小程式,如果有需要可以給我留言,我可以傳上來。
現在萬事俱備,只欠東風了,下面做最後一步
5.修改專案的包引用為pom.xml所設定的依賴。
現在我們可以把原來專案的包引用改成使用maven的依賴庫了,做法很簡單,修改你專案的.classpath配置檔案,把原來的包引用全部刪除,並加入maven的依賴引用,我的.classpath檔案最後是這樣的,發出來為大家做參考
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry kind="src" output="src/main/webapp/WEB-INF/classes" path="src/main/java"/>
<classpathentry kind="src" output="target/test-classes" path="src/test/java"/>
<classpathentry excluding="**" kind="src" output="target/test-classes" path="src/test/resources"/>
<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/J2SE-1.5"/>
<classpathentry kind="con" path="org.maven.ide.eclipse.MAVEN2_CLASSPATH_CONTAINER"/>
<classpathentry kind="output" path="src/main/webapp/WEB-INF/classes"/>
</classpath>
因為我使用的是javaee5專案,所以黑色加粗部分的配置你的可能和我的不一樣
重啟Eclipse ,在專案上右鍵->properties->java build path->order and Export 中的 Maven Dependencies中的勾打上。
現在專案上即可以用原來的方式部署,除錯,也可以使用maven的構建、測試等Maven功能了。
最後說下我在過程中遇到的問題,你可能遇不到,也可能遇到:
1.Maven依賴包衝突,前面說過了。
2.修改pom.xml的依賴包後,eclipse對maven包的引用並不重新整理,這可能是Myeclipse7.5的一個bug, 我在試用8.5時好像就沒這個問題了,解決方法是在修改了pom.xml的依賴後,在專案上右鍵-> Maven4MyEclipse->執行一下Enable Nested Modules或Disable Nested Modules就會重新整理MyEclipse的Maven Dependencies引用了。
3.xfire的jaxb-api的jar包和jdk1.6的rt.jar衝突,這個問題很怪,雖然Eclipse提示程式碼錯誤,但是我把專案部署到jdk1.6的伺服器上,這部分功能還是好使的。但是eclipse提示錯誤看起來還是很不爽的。要解決這個問題你需要一個1.5的jdk,但是我在.classpath中已經配置了使用1.5的jdk了,但是eclipse還使用1.6的jdk呢,因為你的eclipse並不知道jdk1.5的存在,只要在你的eclipse設定的jres中查詢到1.5的jdk後項目就會自動使用1.5的jdk引用做為build path了(注:不用將jdk1.5設為預設jdk)。
4.javaee相關包不存在或衝突:
不存在的原因是你的pom.xm中的依賴設定中使用了provided定義生存週期,這個設定是認為在環境中已經存在這個包了所以就不再部署了,只要改一下生存週期就行了,衝突也是一樣的(一般是openejb的javaee-api和tomcat的javaeeapi衝突),只要加上這個關鍵字就行了。我的javaee部分配置最後如下:
<!-- java EE 5 -->
<dependency>
<groupId>org.apache.openejb</groupId>
<artifactId>javaee-api</artifactId>
<version>5.0-1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.faces</groupId>
<artifactId>jsf-impl</artifactId>
<version>1.2_04</version>
</dependency>
<dependency>
<groupId>javax.faces</groupId>
<artifactId>jsf-api</artifactId>
<version>1.2_04</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.1</version>
<scope>provided</scope>
</dependency>
5.其它問題,主要是包的依賴和衝突等問題比較多,描述起來不太容易,有些我也記不太清楚了,而且和我的專案有關別人遇到的機會不大就不在此描述了。
做此操作遇到最多問題的地方就是依賴jar包的問題,所以在最好將最後一步操作(移除舊引用)儘可能延後,這樣可以方便新舊jar 包的對比。