ant入门示例——mybatis学习笔记之预备篇(二)

  1. 云栖社区>
  2. 博客>
  3. 正文

ant入门示例——mybatis学习笔记之预备篇(二)

余二五 2017-11-23 13:14:00 浏览591
展开阅读全文

       在上篇博文《ant的下载与安装——mybatis学习笔记之预备篇(一)》中,笔者介绍了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的知识,读者可参考http://www.json.org)。程序非常简单,纯属示例。User类是一个简单的JAVA Bean,代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
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类,代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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文件如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--project元素。name属性指定工程的名称,default属性
指定ant默认执行的target,即不指定要执行的target时,ant
执行的target。basedir指定本工程的基准目录,这里指定为
当前目录。-->
<project name="AntDemo" default="compile" basedir=".">
<!--property元素,定义了两个元素,供后面以${元素名}的形式引用。-->
<property name="targetdir" value="classes"/>
<property name="srcdir" value="src"/>
<!--定义一个path元素,指定id属性,供后面引用-->
<path id="library">
<!--定义一个fileset元素,用于指定需要用到的文件。dir属性指定哪个目录下的文件。-->
<fileset dir="lib">
<!--指定包含lib目录下的所有jar包-->
<include name="*.jar"/>
</fileset>
</path>
<!--定义一个target元素,name属性为必须,用于标识此target。description属性用于描述此target,无太大意义。depends属性指定执行此target,所依赖的其他target。这里指定为了运行compile这个target,需首先执行clean,copy-resources这两个target。-->
<target name="compile" description="Compiles the Task" depends="clean">
<!--javac是ant的核心任务(task),用于编译JAVA源程序。srcdir属性指定源程序所在的目录,${srcdir}表明引用上面定义的名为srcdir的property元素的值。destdir指定编译后生成的.class文件的输出目录。同样地,这里使用了${targetdir}的形式引用了上面定义的名为targetdir的property元素的值。classpathref表明引用上面定义的id为library的path元素。在这里,即可把它包含的.jar包加载到classpath中,而不需要像笔者以前那样自己手动运行setclasspath命令。-->
<javac srcdir="${srcdir}" destdir="${targetdir}"
classpathref="library" includeantruntime="no"/>
</target>
<!--定义一个名为clean的target。-->
<target name="clean">
<!--delete是ant的一个核心任务,用于删除目录或文
件。这里用来删除classes目录。即先把以前创建的classes目录删除,免得旧文件造成干扰-->
<delete dir="${targetdir}"/>
<!--mkdir也是一核心任务,用于创建目录。这里用来
新创建classes目录-->
<mkdir dir="${targetdir}"/>
</target>
<target name="copy-resources">
<!--copy也是ant的一个核心任务,用于复制目录或文
件。todir指定复制的目标目录。本示例未使用此任务-->
<copy todir="${targetdir}">
<!--fileset元素指定要复制的文件集,dir属性指定复制的源目录,exclude元素指定排除此目录下的所有java源文件,即复制除这些文件之外的所有文件-->
<fileset dir="${srcdir}">
<exclude name="**/*.java"/>
</fileset>
</copy>
</target>
<!--depends属性指定运行此target应先运行名为compile的target-->
<target name="run" depends="compile">
<!--java是ant的核心任务,用于执行某个java类。classname属性用于指定要运行的类,这里要用到类的全名fork设为true表明使用另外的JVM来运行我们的JAVA类,而不是使用运行ant的那个JVM。classpathref与上面的javac里的一样-->
<java fork="true" classname="com.demo.AntDemo" classpathref="library">
<!--将classes目录加载到classpath中-->
<classpath path="${targetdir}"/>
</java>
</target>
</project>

       打开命令行窗口,进入到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中。执行过程如下图所示:

151212871.png

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

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

152413526.png

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

152455676.png

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










本文转自 NashMaster2011 51CTO博客,原文链接:http://blog.51cto.com/legend2011/898736,如需转载请自行联系原作者

网友评论

登录后评论
0/500
评论
余二五
+ 关注