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



相关文章

发表评论

Comment form

(*) 表示必填项

还没有评论。

跳到底部
返回顶部