[使用心得]maven2之m2eclipse使用手册之一简介与配置文件settings.xml
近期因朋友项目中要用到maven2,所以顺带学习了一下,由于个人比较讨厌cmd的命令使用maven,所以没有去apache下在maven的安装文件使用,而eclipse正好提供了关于maven2的插件,结果发现不需要安装maven2的安装包即可拥有maven2的命令功能.本文章基于maven-2.2.1和m2eclipse0.10.0版本和eclipse-reporting-galileo-SR2版本(以包含eclipse-jee-galileo-SR2) 所写,如有跟其他版本有所出入请见谅
m2eclipse在线安装地址如下:
http://m2eclipse.sonatype.org/sites/m2e
安装前提必须Eclipse要求已经安装了以下插件:
subclipse(svn) 在线安装地址:http://subclipse.tigris.org/update_1.6.x
Mylyn在线安装地址:http://download.eclipse.org/tools/mylyn/update/e3.4/
Mylyn Extras (JIRA 支持): http://download.eclipse.org/tools/mylyn/
update/extras
AspectJ Tools Platform (AJDT)在线安装地址:http://download.eclipse.org/tools/ajdt/35/dev/update
Web Tools Platform (WTP)在线安装地址:http://download.eclipse.org/webtools/updates/
由于本机没有独立安装maven2的安装包,所以安装完毕后是没有setting.xml这个配置文件的,启动eclipse后如果没有之前没有指定本地jdk路径的话,会提示要求指定jdk在那个地方,编辑eclipse.ini加入以下两段文字:
-vm
C:/Program Files/Java/jdk1.6.0_20/bin
-vm:是指定当前虚拟机的位置,默认安装好的eclipse是没有该项的,记住-vm标记必须要在-vmargs前面加否则会出现报错,
C:/Program Files/Java/jdk1.6.0_20/bin:就是你本机jdk bin的位置了
对于eclipse.ini的位置是在你所解压的eclipse中的根目录例如我的就是在E:\JavaWorkingTools\IDETools\Eclipse\IDE\eclipse\eclipse.ini
还有一个很重要的东西,m2eclipse已经为你创建了一个{user.dir}/.m2/repository的本地中央仓库的文件夹,你可以通过配置settings.xml来更改本地中央仓库的文件夹
{user.dir}:就是你当前用户下的文件夹,例如我的是Edward
相对于maven2来说maven2的设置比maven1简单多了只有setting.xml和pom.xml。setting.xml用于配置对于仓库的设置和代理仓库等设置，而pom.xml则对当前项目的管理。
由于没有使用到maven2的安装包,装完m2eclipse是没有settings.xml的文件的,需要自己手动新建一个settings.xml文件.
对于settings.xml文件
settings.xml基本结构如下：
<settings 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/xsd/settings-1.0.0.xsd">
<localRepository/>
<interactiveMode/>
<usePluginRegistry/>
<offline/>
<pluginGroups/>
<servers/>
<mirrors/>
<proxies/>
<profiles/>
<activeProfiles/>
</settings>
settings.xml标签说明:
如下图:
主要的配置因素:
localRepository：表示本地库的保存位置，也就是maven2主要的jar保存位置，默认在${user.dir}/.m2/repository，如果需要另外设置，就换成其他的路径。
offline：如果不想每次编译，都去查找远程中心库，那就设置为true。当然前提是你已经下载了必须的依赖包。
Servers
在POM中的 distributionManagement元素定义了开发库。然而，特定的username和pwd不能使用于pom.xml，所以通过此配置来保存server信息
<servers>
<server>
<id>server001</id>
<username>test</username>
<password>test</password>
<privateKey>${usr.home}/.ssh/id_dsa</privateKey>
<passphrase>some_passphrase</passphrase>
<filePermissions>664</filePermissions>
<directoryPermissions>775</directoryPermissions>
<configuration></configuration>
</server>
</servers>
- id:server 的id,用于匹配distributionManagement库id，比较重要。
- username, password:用于登陆此服务器的用户名和密码
- privateKey, passphrase：设置private key，以及passphrase
- filePermissions, directoryPermissions：当库文件或者目录创建后，需要使用权限进行访问。参照unix文件许可，如664和775
Mirrors 表示镜像库，指定库的镜像，用于增加其他库(非常有用的一个设置)
<mirrors>
<mirror>
<id>planetmirror.com</id>
<name>PlanetMirror Australia</name>
<url>http://downloads.planetmirror.com/pub/maven2</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
- id,name:唯一的标志，用于区别镜像
- url:镜像的url
- mirrorOf:身份认证有 中心的:central 单一: *对于2.0.9版本以上还有
- * = everything
- external:* = everything not on the localhost and not file based.
- repo,repo1 = repo or repo1
- *,!repo1 = everything except repo1
Proxies
此设置，主要用于无法直接访问中心的库用户配置。
<proxies>
<proxy>
<id>myproxy</id>
<active>true</active>
<protocol>http</protocol>
<host>proxy.somewhere.com</host>
<port>8080</port>
<username>proxyuser</username>
<password>somepassword</password>
<nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
</proxy>
</proxies>
- id:代理的标志
- active：是否激活代理
- protocol, host, port:protocol://host:port 代理
- username, password：用户名和密码
- nonProxyHosts: 不需要代理的host
Profiles
类似于pom.xml中的profile元素，主要包括activation,repositories,pluginRepositories 和properties元素
刚开始接触的时候，可能会比较迷惑，其实profiles是maven2中比较强大的功能。从字面上来说，就是个性配置。
单独定义profile后，并不会生效，需要通过满足条件来激活。
repositories 和pluginRepositories
定义其他开发库和插件开发库。对于团队来说，肯定有自己的开发库。可以通过此配置来定义。
如下的配置，定义了本地开发库，用于release 发布。
<repositories>
<repository>
<id>repo-local</id>
<name>Internal 开发库</name>
<url>http://localhost:8081/repo-local</url>
<releases>
<enabled>true</enabled>
<updatePolicy>never</updatePolicy>
<checksumPolicy>warn</checksumPolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
<layout>default</layout>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>repo-local</id>
<name>Internal 开发库</name>
<url>http://localhost:8081/repo-local</url>
<releases>
<enabled>true</enabled>
<updatePolicy>never</updatePolicy>
<checksumPolicy>warn</checksumPolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
<layout>default</layout>
</pluginRepository>
</pluginRepositories>
releases, snapshots:每个产品的版本的Release或者snapshot(注：release和snapshot的区别，release一般是比较稳定的版本，而snapshot基本上不稳定，只是作为快照）
properties
maven 的properties作为placeholder值，如ant的properties。
包括以下的5种类型值：
- env.X：返回当前的环境变量
- project.x：返回pom中定义的元素值，如project.version
- settings.x：返回settings.xml中定义的元素
- java 系统属性：所有经过java.lang.System.getProperties()返回的值
- x：用户自己设定的值
Activation
用于激活此profile
<activation>
<activeByDefault>false</activeByDefault>
<jdk>1.5</jdk>
<os>
<name>Windows Seven</name>
<family>Windows</family>
<arch>x86</arch>
<version>5.1.2600</version>
</os>
<property>
<name>mavenVersion</name>
<value>2.0.9</value>
</property>
<file>
<exists>${basedir}/file2.properties</exists>
<missing>${basedir}/file1.properties</missing>
</file>
</activation>
- jdk:如果匹配指定的jdk版本，将会激活
- os:操作系统
- property：如果maven能检测到相应的属性
- file: 用于判断文件是否存在或者不存在
除了使用activation来激活profile，同样可以通过activeProfiles来激活
Active Profiles
表示激活的profile,通过profile id来指定。
<activeProfiles>
<activeProfile>env-test</activeProfile> 指定的profile id
</activeProfiles>
