通向架构师的道路（第二十三天）maven与ant的奇妙整合

一、前言

我们在《万能框架spring》前四天中都用到了maven，接下去要讲述在SSX这样的架构下我们的“单元测试”是怎么进行的，但是在此之前我们再来深入入解一下maven，因为我们的单元测试需要用到的是junit+ant+junitreport这样的组合。而。。。。。。由于我们已经使用了maven，那么我们如何可以延续经典的junit+ant这样的单元测试的组合呢？其答案就是把maven和ant再进行组合一下。

二、用Maven任务在Ant中使用Maven依赖

Maven的一个重要特性是使用中央仓库，存储依赖和识别应用程序所需的库。Maven2还支持传递依赖（transitivedependency），这是一个强大的概念，它将用户需要声明的依赖限制到最小程度。Ant不支持“即开即用”的依赖管理。在Ant项目中，应用程序所需的全部程序库通常都存放在一个项目目录中。

三、使用maven-ant-task

3.1安装maven-ant-task

我们先下载maven-ant-tasks-2.1.3.jar（我也已经上传到了“我的资源”里了）；

下载完后把它放到我们的ant的lib目录下；

3.2 打包工程

这是一个传统的没有使用maven依赖库的ant的打包流程，从图上看很清晰，对吧？

在前面说了，ant打包时是需要所有的.jar文件都是事先已经在工程的WebContent/WEB-INF/lib目录下了，这也是大都数人所熟悉的。

但是Maven打包，就一个包依赖声明文件pom.xml，然后在打包时缺什么jarMaven会自动帮我们去下载，所以说Maven真是一个好东西，使用maven-ant-task我们可以把“声明classpath”这块来用maven-ant-task来做，即其它还是使用ant，就是在声明编译时即javac时需要用到的那些依赖包时再使用maven的特性。

因此，我们再来看上述这个纯ant工程打包流程在引入了maven-ant-task后会变成什么样子吧。

四、动手改造工程

我们此处以myssh2的工程来做例子，原来的pom.xml文件不动，增加ant的打包文件即build.xml文件。

4.1maven环境的重设置

我们前面的几天教程用的都是一个叫maveneclipse(m2 eclipse)的插件

它默认会把所有的maven依赖库下载到你的C:\Users\yourusername\.m2\repository这个目录下（以win7为例，如果你用的是XP那么这个目录应该在你的c:\documents and settings目录下），因此我们需要手动把我们的maven安装目录的下的conf\目录下的settings.xml文件也拷贝到

C:\Users\yourusername\.m2\repository目录下，还记得吗？

现在，我们在我们的apache-maven的安装目录即c:\maven目录下建立我们的repository，并且让m2eclipse插件也将repository指向C:\maven\repository。

更改c:\maven\conf\settings.xml文件

我们在原有的settings.xml文件中增加了如下的一段话

<localRepository>C:\maven\repository</localRepository>

然后回到eclipse点开window->preference->Maven->UserSettings，将我们的m2eclipse的设置配置成如下的样子

注意：

Local Repository再也不是“C:\Users\yourusername\.m2\repository”了，而是指向了我们的

c:\maven\repository目录了。

这样做还有一个好处就是你在重新装机时你的maven的local repository不会因为documents and settings目录的丢失而丢失了。

4.2编写build.xml

build.properties文件

# ant

appName=myssh2

webAppName=myssh2

webAppQAName=myssh2-UT

local.dir=C:/eclipsespace/${appName}

src.dir=${local.dir}/src/main/java

dist.dir=${local.dir}/dist

webroot.dir=${local.dir}/src/main/webapp

lib.dir=${local.dir}/lib

classes.dir=${webroot.dir}/WEB-INF/classes

resources.dir=${local.dir}/src/main/resources

请注意此处的${}这样的placeholder（替换符）的使用技巧

build.xml文件（红色加粗部分）

<?xml version="1.0" encoding="UTF-8"?>

<project name="myssh2" default="buildwar" xmlns:artifact="urn:maven-artifact-ant">

<property file="build.properties" />

<path id="maven-ant-tasks.classpath" path="C:/ant/lib/maven-ant-tasks-2.1.3.jar" />

<typedef resource="org/apache/maven/artifact/ant/antlib.xml" uri="urn:maven-artifact-ant"

classpathref="maven-ant-tasks.classpath" />

<artifact:pom id="maven.project" file="pom.xml" />

<artifact:dependencies filesetId="deps.fileset.compile" useScope="compile">

<!--<pom file="pom.xml"/>-->

<pom refid="maven.project" />

</artifact:dependencies>

<path id="compile.classpath">

<fileset dir="${lib.dir}">

<include name="*.jar" />

</fileset>

</path>

<target name="clean" description="Delete old build and dist directories">

<delete dir="${dist.dir}" />

<mkdir dir="${dist.dir}" />

<mkdir dir="${dist.dir}/${webAppName}" />

<mkdir dir="${dist.dir}/${webAppName}/WEB-INF" />

<mkdir dir="${dist.dir}/${webAppName}/WEB-INF/lib" />

<mkdir dir="${dist.dir}/${webAppName}/WEB-INF/classes" />

<mkdir dir="${dist.dir}/${webAppName}/css" />

<mkdir dir="${dist.dir}/${webAppName}/images" />

<mkdir dir="${dist.dir}/${webAppName}/jsp" />

</target>

<target name="download-libs" depends="clean">

<copy todir="${lib.dir}">

<fileset refid="deps.fileset.compile" />

<mapper type="flatten" />

</copy>

</target>

<target name="compile" description="Compile java sources" depends="download-libs">

<javac debug="true" destdir="${dist.dir}/${webAppName}/WEB-INF/classes"

includeAntRuntime="false" srcdir="${src.dir}">

<classpath refid="compile.classpath" />

</javac>

<copy todir="${dist.dir}/${webAppName}/WEB-INF/lib">

<fileset dir="${lib.dir}">

<include name="*.jar" />

</fileset>

</copy>

<copy todir="${dist.dir}/${webAppName}/WEB-INF/classes">

<fileset dir="${resources.dir}">

<include name="**/*.*" />

</fileset>

</copy>

<copy todir="${dist.dir}/${webAppName}/css">

<fileset dir="${webroot.dir}/css">

<include name="**/*.*" />

</fileset>

</copy>

<copy todir="${dist.dir}/${webAppName}/images">

<fileset dir="${webroot.dir}/images">

<include name="**/*.*" />

</fileset>

</copy>

<copy todir="${dist.dir}/${webAppName}/jsp">

<fileset dir="${webroot.dir}/jsp">

<include name="**/*.*" />

</fileset>

</copy>

<copy todir="${dist.dir}/${webAppName}">

<fileset dir="${webroot.dir}">

<include name="*.*" />

</fileset>

</copy>

<copy todir="${dist.dir}/${webAppName}/WEB-INF">

<fileset dir="${webroot.dir}/WEB-INF">

<include name="*.*" />

</fileset>

</copy>

</target>

<target name="buildwar" depends="compile">

<war warfile="${dist.dir}/${webAppName}.war">

<fileset dir="${dist.dir}/${webAppName}"/>

</war>

</target>

</project>

对照着Maven+Ant打包的流程图看这个build.xml文件，一点也不难看懂，就一个过程化的批处理脚本而己。

关键在于：

<path id="maven-ant-tasks.classpath" path="C:/ant/lib/maven-ant-tasks-2.1.3.jar" />

<typedef resource="org/apache/maven/artifact/ant/antlib.xml" uri="urn:maven-artifact-ant"

classpathref="maven-ant-tasks.classpath" />

<artifact:pom id="maven.project" file="pom.xml" />

<artifact:dependencies filesetId="deps.fileset.compile" useScope="compile">

<!--<pom file="pom.xml"/>-->

<pom refid="maven.project" />

</artifact:dependencies>

<path id="compile.classpath">

<fileset dir="${lib.dir}">

<include name="*.jar" />

</fileset>

</path>

<target name="download-libs" depends="clean">

<copy todir="${lib.dir}">

<fileset refid="deps.fileset.compile" />

<mapper type="flatten" />

</copy>

</target>

此处声明了：

1）我们在ant的build.xml文件中使用maven插件

2）我们的工程所用到的依赖库即所有的.jar文件在工程（myssh2）原有工程的pom.xml文件中已经声明过依赖关系了，build.xml文件只要使用它就可以了。

3）我们的ant在使用javac进行编译时所需的库在${lib.dir}，见build.properties即在c:\eclipsespace\myssh2\lib目录内。

4）c:\eclipsespace\myssh2\lib目录内所有的jar则是通过“download-libs”这个target得来的。

下面是build.xml文件被运行后的输出效果即在eclipse中打开build.xml文件后右键选RunAs->Ant Build的输出：

去我们的工程的dist目录下查看，就可以看到一个myssh2.war工程

把这个工程直接扔到tomcat的webapp目录下，运行tomcat后登录http://localhost:8080/myss2 后一切正常，结束本天的教程。

PS：

一般我不喜欢把一个.war包扔到tomcat下去，而是喜欢把符合war目录结构的这样的一个目录扔到tomcat的webapp目录下，直到这个工程成品了，即通过测试后再打成war包以便于tomcat或者是weblogic、WAS的布署，因此对于我来说在<target name="compile"depends="download-libs">这步完成后就够用了。