在eclipse项目中使用maven管理依赖2008-03-04 14:03概览:
如何导入maven项目至eclipse中
建立自有Maven Java类库服务器
建立符合maven代码库标准的自定义类库
Maven在管理Java类库方面有巨大的优势，像白衣所说就是非常“环保”。
我们平时用IDE开发都是把所需要的类库一股脑的全丢到项目目录下，然后全部添加到ide的构建路径中，如果用了SVN/CVS，这样会很容易就把这些庞大的类库提交到代码库中，如果是j2ee项目，光类库可能就有百兆，严重影响checkout速度，如果是远程开发就不敢想象了。而引入maven来管理依赖，就可以很好的控制依赖项的版本，并且项目中不存在具体依赖lib，只有对于依赖的描述，来源也可以很好的集中控制。
我们的项目在eclipse wtp下开发，而项目的依赖我用maven来管理，并且同时也不影响wtp的正常使用，以下是整合eclipse和maven的方法和步骤，关于maven的使用这里不做介绍，相关的文档网上有很多，本文仅做简单介绍：
以一个webapp项目my-webapp为例
1. 建立支持maven的eclipse项目
首先用maven来建立标准布局的webapp项目，然后用maven生成eclipse wtp项目配置信息，再用eclipse导入即可
下面先说说第一种：
1.1 生成maven项目
生成标准布局的webapp项目，在控制台执行下面命令(groupId后面是包名，artifactId后面是项目名称)：
mvn archetype:create -DgroupId=net.jeffrey
-DartifactId=my-webapp
-DarchetypeArtifactId=maven-archetype-webapp
生成标准布局的普通java项目，执行：
mvn archetype:create -DgroupId=net.jeffrey -DartifactId=my-app
完成后你会看到已经生成了一个名为my-webapp的文件夹，这就是刚刚生成好的项目目录
在my-webapp根目录下，你会看到名为pom.xml的文件，这个就是maven的项目描述文件
编辑pom配置项目所需依赖，例如下面
Maven的代码库是这样的目录结构，groupId是该类库所属的组织，作为文件目录，包名结构映射成目录结构，artifactId就是具体的类库名称了，是groupId的一个子目录，version是版本号，每个版本都有一个单独的目录，里面放置的就是具体的jar包。
比如spring-2.0.jar在maven代码库中的路径就是org/springframework/spring/2.0/spring-2.0.jar
关于依赖的写法，可以去这里查询：http://mvnrepository.com/
1.2 生成eclipse项目
在控制台下进入项目目录，如果是从maven webapp项目生成eclipse wtp，执行：
mvn –Dwtpversion=1.0 eclipse:eclipse（wtp1.0以上版本均可用）
普通eclipse项目执行：mvn eclipse:eclipse
然后在eclipse中import项目即可
1.3 在eclipse中设置maven路径变量
刚导入的项目上会有错误标记，不用担心，因为还没有设置maven的类库变量
打开项目的属性框，在Java Build Path里我们可以看到项目依赖类库的路径都已经给自动设置好了
[img]http://dl.iteye.com/upload/attachment/249003/48ee201e-2bae-3620-9c69-ba908d9c8168.jpg[/img]
下面设置maven的路径变量M2_REPO
Window -> Preferences -> Java -> Build Path -> Classpath Variables，New
Name命名为M2_REPO，路径为你的本地的maven类库地址，这里为C:/Documents and Settings/jeffrey/.m2/repository，设置成功后重新编译，发现项目的错误标记已经消除了，至此，eclipse项目已经导入成功了
1.4 为项目添加新的依赖
编辑pom文件，添加新的dependency，保存後
在控制台分别执行：
mvn eclipse:clean
mvn -Dwtpversion=1.0 eclipse:eclipse
在eclipse中刷新项目即可看到新的依赖项已经添加到eclipse项目中
1.5 非maven标准的项目布局
前面已经介绍了如何新建一个maven项目并导入到eclipse中，但对于已有的wtp项目，其项目布局是不符合maven方式的（eclipse下wtp项目web目录在项目根目录下WebContent，maven布局是在src/main/webapp），这就不能直接通过eclipse:eclipse来生成eclipse的依赖
但可以通过改写项目pom文件来指定源码目录和测试源码目录：
xml 代码
<build>
<finalName>my-webappfinalName>
<sourceDirectory>srcsourceDirectory>
<testSourceDirectory>testtestSourceDirectory>
build>
对于web根目录，还没有什么好办法来特别指定，如果哪位朋友知道，麻烦指教。
2. 建立Maven2的本地代码库服务器，也就是常说的“私服”
官方的maven repository服务器特别的慢，还记得上次海底电缆事故么？官方的服务器根本就无法访问，那段时间简直要抓狂。并且官方服务器类库版本通常不是最新，有时候想用最新版的还得自己动手。（下面会介绍如何自己动手做），所以建立一个自己的本地代码服务器对于整个团队就特别有意义。
Maven的服务器很简单，一个普通的http服务器就行，比如apache，装好apache以后。
将你本地代码库文件夹拷贝到apache安装目录下htpdocs/maven2，windows用户是C:\Documents and Settings\jeffrey\.m2\repository，linux下是 /home/Jeffrey/.m2/repository（注意.m2在linux下是隐藏文件夹）
启动apache服务器，在浏览器中输入http://localhost/maven2/repository，应该可以查看到repository的文件目录
编辑项目pom，指定本地的代码库服务器
在project中加入：
xml 代码
<repositories>
<repository>
<id>mylibsid>
<url>http://localhost/maven2/repositoryurl>
repository>
repositories>
可以加入多个repository，mvn会按照顺序检索，如果都没有找到，最后会去找官方的服务器
3. 添加新的类库到本地代码服务器中
在maven官网有很多类库都找不到，只能自己动手，丰衣足食。
请先确认官网确实没有的情况下再自己做，毕竟还是挺麻烦的
可在以下两个网站查阅：http://mvnrepository.com/，http://repo1.maven.org/maven2/
前面已经说明了maven代码库的文件目录组织方式，同一个jar对于每个版本都有一个独立的文件夹来存放，除了jar还要有该jar的描述文件.pom，以及他们的校验文件.sh1
.pom文件里定义了该jar的名称、版本以及该jar所依赖到的其他jar（这也就是为什么引入一个jar却带出一大堆的jar来）
最简单的pom如下：
为jar和pom生成校验文件
可以通过一个ant任务来做：
xml 代码
<target name="checksum" description="Generate checksum file for jar and pom">
<checksum algorithm="SHA" fileext=".sha1">
<fileset dir="d:/javalib" id="id">
<include name="**/*.pom" />
<include name="**/*.jar" />
<include name="**/*.xml" />
<exclude name="**/*.sh1" />
fileset>
checksum>
target>
把生成好的sh1文件和jar、pom按照前面介绍的结构布局拷贝到apache的代码库中，当然你也可以直接拷到本地代码库中。
xml 代码
xml version="1.0" encoding="UTF-8"?>
<project>
<modelVersion>4.0.0modelVersion>
<groupId>net.jeffreygroupId>
<artifactId>xxxartifactId>
<version>1.0version>
<dependencies>
dependencies>
project>
xml 代码
<dependencies>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>springartifactId>
<version>2.0version>
<scope>compilescope>
dependency>
dependencies>
