通向架构师的道路（第二十三天）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">这步完成后就够用了。