在上篇博文中,笔者介绍了ant的下载与安装。本文将介绍如何使用ant创建一个简单的工程,作为ant的入门示例。

      在这里首先和大家分享一下笔者学习新技术的一点心得。每一项技术都会涉及到很多的知识点,这很容易对初学者造成较大的心理压力。如果刚开始把目标定得过高,写较复杂的程序的话,会有一个很大的坏处:因为是初学,基础知识掌握得并不牢固,也缺乏经验,犯错误的几率更大。那么此时这个不牢固的基础知识以及经验的匮乏,自然会给排错增加很大的困难,因为你有太多的不确定。这不但耽误时间,而且对自信心也是一个打击,至少会加剧自己的心理压力。然而,如果只是用它写一个较小的程序的话,实际上只会用到其中很小一部分的知识。这样出错后(这是不可避免的),不确定的地方也较少,排错也容易。因此,笔者的做法通常是先写出一个简单的程序,通过这个过程,先牢固掌握最基本的知识并开始积累经验。然后,再以此为基础,逐渐扩大编写程序的复杂度(这样跨度小)。这样出错后,由于先前的知识和经验的积累,以及较小的跨度,排错的难度自然大大降低。这样就可以减轻心理压力,逐渐树立自信,比较容易地逐步掌握越来越多的知识。因此,本文以及后续的博文都会贯彻同一条原则:从最简单的开始,逐渐增加复杂度。本文就先介绍如何编写一个简单的ant工程,以后mybatis的学习笔记,都用ant来组织工程。

      存放ant工程所有的文件需要一个目录,笔者在自己机器上的E:\DemoPrograms下新建一个目录AntDemo,用来创建本文的ant工程,其他所有的目录都以此目录为基准。在此目录下需要有三个子目录,它们是src、lib和classes,其作用分别如下:

  1. src:存放源代码文件和工程所需的配置文件;

  2. lib:工程用到的jar包;

  3. classes:编译后的.class文件被输出到此目录,工程所需的配置文件也会被复制到此目录下(在后面我们可以看到,实际上这个目录我们可以让ant帮我们创建)。

      本示例将创建一个User对象,并把它以JSON字符串的形式输出(有关JSON的知识,读者可参考)。程序非常简单,纯属示例。User类是一个简单的JAVA Bean,代码如下:

package com.abc.people;public class User {private int id;private String name;private int age;private String gender;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}public String getGender(){return gender;}public void setGender(String gender){this.gender = gender;}}

      依据此类的package声明,在src下创建子目录com\abc\people(包的层次与与目录层次一一对应),把User.java文件存放在此目录下。然后是创建User对象并转换为JSON字符串的程序,在这里是AntDemo类,代码如下:

package com.demo;import com.abc.people.User;import net.sf.json.JSONObject;public class AntDemo{public static void main(String[] args){User user = new User();user.setId(10);user.setName("General Patton");user.setAge(60);user.setGender("male");//创建一个JSONObject对象JSONObject json = JSONObject.fromObject(user);//以JSON字符串的形式打印System.out.println(json.toString());}}

      与User.java类似,我们根据AntDemo所在的包,在src目录下创建目录com\demo,用来存放AntDemo.java文件。本示例需要用到的jar包如下:commons-beanutils-1.8.3.jar,commons-collections-3.2.1.jar,commons-lang-2.6.jar,commons-logging-1.1.1.jar,ezmorph-1.0.6.jar,json-lib-2.4-jdk15.jar。自然,我们需要把这些jar包复制到lib目录下。

      接下来需要做的,就是创建ant工程的核心所在,编写生成文件。生成文件默认名为build.xml,一般存放在工程的顶级目录中,在本示例中就是在AntDemo下。生成文件包含一个project元素,它是顶级元素,代表一个工程。project元素至少一个target元素,而每个target元素又包含一个到多个task元素。执行ant,就是执行这些target元素;而执行每个target元素,就是依次执行它所包含的task元素。本工程的build.xml文件如下:

       打开命令行窗口,进入到E:\DemoPrograms\AntDemo目录下。若直接执行ant命令,ant将在当前目录下搜寻build.xml文件(这是默认情况),并根据project元素的default值,执行compile这个target。若想运行run这个target,则执行命令:ant run。这里我们来分析一下执行这个target的流程:在run这个target中,depends属性指定应先运行compile这个target;而compile又指定应先运行clean这个target。因此,整个流程是:先运行clean,把旧的classes目录删除,避免它包含的旧文件造成干扰;然后创建一个全新的classes目录;然后运行compile target,编译源程序并将.class文件输出到classes目录中;最后运行run target,执行编译好的程序。当然,在编译和执行程序的时候,ant都根据classpath和classpathref等的值,帮我们把相应的jar包和classes目录加载到了classpath中。执行过程如下图所示:

       如上图所示,ant将执行的大致步骤打印了出来。由此我们可以看出,ant首先找到生成文件,然后按照我们在生成文件中的定义,依次执行相应的target及其中的task。

      若想让ant打印出执行过程中的详细信息,可执行命令:ant -verbose run。如下图显示了执行clean target时的详细步骤:

      而下图则表明ant在调用本机的java编译器时,使用了-classpath参数,从而把我们的jar包加载进了classpath中。

      (点击下面的“附件下载”,可下载本文的ant工程。)

      


【MyBatis学习笔记】系列之预备篇二:ant入门示例