maven整合ant教程

一、前言

我们在 【J2EE架构师】22、万能框架spring(四)spring整合struts2实例  中都用到了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">这步完成后就够用了。

转自：http://www.fengfly.com/plus/view-210407-1.html