Maven学习记录

（注：待修改，内容未稳定）

 

一、安装maven的命令行
先安装JDK，设置好JAVA_HOME
然后在http://maven.apache.org/
下载http://maven.apache.org/download.html
解压后然后加入PATH环境变量。
（我个人更倾向于用msys配置JDK和Maven，方法类似）
在XP下默认本地仓库路径在
C:\Documents and Settings\Administrator\.m2

 

二、安装Eclipse的m2eclipse(Maven Integration, m2e)插件
1. 由于m2e依赖于Zest，所以需要先安装GEF/Zest插件
用浏览器打开http://www.eclipse.org/gef/zest/
左面Downloads->Update Manager进入链接，照指引复制URL到
Eclipse主菜单->Help->Install new software->Add Site
或者Downloads->Installation用下载工具下载，然后解压到Eclipse目录中
2. 安装m2e
打开Eclipse主菜单->Help->Install new software->Add Site添加
http://m2eclipse.sonatype.org/sites/m2e/，然后安装。
（如果无法搜索，可以用浏览器打开
http://m2eclipse.sonatype.org/sites/m2e/
选择版本，然后把地址复制下来，例如
http://m2eclipse.sonatype.org/sites/m2e/0.10.2.20100623-1649/
然后用Add Site添加安装）

 

三、创建maven工程
1. 使用m2e创建test工程
File->New->Other->Maven->Maven Project
Archetype选择maven-archetype-quickstart
Group ID和Artifact ID填test（或者随便起个名字）
创建后在Package Explorer的JRE System Library上右键->Properties，
把默认的J2SE-1.4改为JavaSE-1.6（如果有必要的话）
然后右键菜单->Run as->Maven test进行编译和测试
2. 其他创建方法
（关于手工创建工程，尚在学习研究中）

20110225补充:可以用mvn eclipse:eclipse生成（未验证）

20110310补充：生成动态网站工程的方法（仅对Eclipse JavaEE而言）见（七）

 

四、解决Missing artifact javax.transaction:jta:jar:1.0.1B:compile错误
当第一次使用Eclipse的m2e插件时，通常会出现这种错误。
解决方法是安装jta到本地仓库中。
1. 下载jta-1_0_1B-classes.zip
http://www.oracle.com/technetwork/java/javaee/tech/index.html
搜索Java Transaction API (JTA) 1.1进入，下载Class Files 1.0.1B（点击同意，然后下载）
2. 在命令行中执行安装
mvn install:install-file -Dfile=./jta-1_0_1B-classes.zip -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar
然后重新执行mvn
3. 在Eclipse中执行安装
File->Import->Maven->Install or deploy an artifact to a Maven repository
然后填入以下内容
Artifact file填jta-1_0_1B-classes.zip的绝对路径；
Group Id填javax.transaction
ArtifactId 填jta
Version填1.0.1B
Packaging填jar
然后在Package Explorer中对工程右键菜单->Run as->Maven test

 

五、修改settings.xml
有时需要修改远程repository的URL（默认是maven官网），如Hibernate的源码工程编译需要特定的repository才能顺利执行。
详细可以参考
http://community.jboss.org/wiki/BuildingHibernateFromSource35
使用前注意settings.xml要修改为自己的JDK目录
其实可以不必修改默认的仓库URL，不过在编译Hibernate的源码工程时这么做可能会比较方便（不需要改动太多东西）
1. 修改.m2\settings.xml
默认是C:\Documents and Settings\Administrator\.m2\settings.xml
会覆盖maven安装目录下的settings.xml
2. 直接修改maven安装目录下的settings.xml
不推荐这么做，感觉不太好。
3. 使用-s参数指定。
如果使用命令行编译，可以创建一个新的settings（例如我把Hibernate 3.5的settings保存为settings.xml）
（注意，settings.xml要修改为自己的JDK目录）
然后执行mvn -fae -s settings.xml test进行测试
4. 修改Eclipse的Preferences
主菜单->Preferences->Maven->User Settings
修改后Update Settings然后重新执行Run As->Maven test

 

--------------------------

20110225更新：

 

六、版本兼容问题：

有些工程需要Maven 2才能正常编译，例如appfuse。

怀疑是插件不兼容导致的。

如果插件出现错误，而且使用Maven 3以上，可以改用Maven 2试试。

 

 

---------------------------

20110310更新：

 

 

七、Maven工程转Eclipse Java EE的Dynamic Web Project工程的方法：

 

 

mvn eclipse:eclipse -Dwtpversion=1.0

 

参考自

http://struts.apache.org/2.x/docs/struts-2-spring-2-jpa-ajax.html

 

如果可以，尽量用Maven 2，不要用Maven 3。

 

八、pom.xml/build.xml范例

1. Struts2官方教程范例（有些包括Ant的build.xml范例）

http://struts.apache.org/2.x/docs/getting-started.html

http://struts.apache.org/2.x/docs/struts-2-spring-2-jpa-ajax.html

 

2. Hibernate手册中Ant的build.xml范例

http://oss.org.cn/ossdocs/framework/hibernate/reference-v3_zh-cn/tutorial.html#tutorial-firstapp-ant

 

（待补充）