J2EE环境筹建(四)Ant的安装和使用

J2EE环境搭建(四)Ant的安装和使用

今天看了下J2EE,基本是对着课本的代码敲一下和运行一下理解一下,其中遇到了一个问题:在使用JavaBean对象时,直接声明了一个Java类的实例,代码如下:

<%@ page contentType="text/html; charset=GBK" language="java" errorPage="" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<title>Java Bean</title>
</head>
<body>
<!-- 创建lee.Person的实例,该实例的实例名为p1 -->
<jsp:useBean id="p1" class="lee.Person" scope="page"/>
<!-- 设置p1的name属性值 -->
<jsp:setProperty name="p1" property="name" value="Jimmy Lee"/>
<!-- 设置p1的age属性值 -->
<jsp:setProperty name="p1" property="age" value="21"/>
<!-- 输出p1的name属性值 -->
<jsp:getProperty name="p1" property="name"/><br/>
<!-- 输出p1的age属性值 -->
<jsp:getProperty name="p1" property="age"/>
</body>
</html>
代码很简单,主要就是jsp:useBean,jsp:setProperty和jsp:getProperty等三个动作指令的使用。

该脚本使用了Java Class "lee.Person",代码如下:

package lee;

public class Person
{
	private String name;
	private int age;
	
	//无参数的构造器
	public Person()
	{
	}
	//初始化全部属性的构造器
	public Person(String name , int age)
	{
		this.name = name;
		this.age = age;
	}
	
	//name属性的setter和getter方法
	public void setName(String name)
	{
		this.name = name;
	}
	public String getName()
	{
		return this.name;
	}
	
	//age属性的setter和getter方法
	public void setAge(int age)
	{
		this.age = age;
	}
	public int getAge()
	{
		return this.age;
	}
}
直接在服务器上Run却一直报错:

J2EE环境筹建(四)Ant的安装和使用
原因在于lee.Person这个类没有具体的定义。在这里该应用的WEB-INF目录中并没有classes这个文件夹,也就是说没有Person.java编译后的二进制文件存在。

由于没有使用IDE,所以这里要使用Ant工具来生成Java文件的class后缀文件。


Ant是一种基于Java的生成工具,通过使用XML文件来编写生成文件,因此该工具可以适应多种平台。

这里我使用的是Ant 1.8.1版本。

下载完成后首先是配置环境变量:

(1)JAVA_HOME:该环境变量指向JDK的安装路径,基本上是不用理的(除非你刚学Java)。

(2)ANT_HOME:该环境变量就是Ant的安装路径,例如:

F:\J2EE\apache-ant-1.8.1
(3)PATH:为了在命令行中方便地使用Ant工具,最好配置好这个变量,也就是将%ANT_HOME%/bin路径(关键是该路径下的ant.bat)添加到PATH中,例如:

F:\software\J2EE\apache-ant-1.8.1\bin

配置好环境变量后,打开cmd,输入命令ant或者ant.bat,如果输出build.xml does not exist!之类的信息则说明Ant安装成功。


那么Ant怎么用呢,首先是建立build.xml文件,该文件定义了各个生成任务,该文件中根元素是<project.../>,每个项目下可以定义多个生成目标,每个目标以一个<target.../>元素来定义。关于build.xml文件的内容网上教程很多,书本的理论介绍也很多,我就不多说了,主要说说怎么用(尽管非常简单)。

先给出对应JavaBean对象测试项目的build.xml的内容:

<?xml version="1.0" encoding="GBK"?>
<!-- 定义生成文件的project根元素,默认的target为空 -->
<project name="web" basedir="." default="">
	<!-- 定义三个简单属性 -->
	<property name="src" value="src"/>
	<property name="classes" value="classes"/>
	<!-- 定义一组文件和目录集 -->
	<path id="classpath">
		<fileset dir="lib">
			<include name="*.jar"/>
		</fileset>
		<pathelement path="${classes}"/>
	</path>
	<!-- 定义compile target,用于编译Java源文件 -->
	<target name="compile" description="编译Java源文件">
		<!-- 先删除classes属性所代表的文件夹 -->
		<delete dir="${classes}"/>
		<!-- 创建classes属性所代表的文件夹 -->
		<mkdir dir="${classes}"/>
		<!-- 编译Java文件,编译后的class文件放到classes属性所代表的文件夹内 -->
		<javac destdir="${classes}" debug="true" includeantruntime="yes"
			deprecation="false" optimize="false" failonerror="true">
			<!-- 指定需要编译的Java文件所在的位置 -->
			<src path="${src}"/>
			<!-- 指定编译Java文件所需要第三方类库所在的位置 -->
			<classpath refid="classpath"/>
		</javac>
	</target>
</project>

在这里做的任务只有compile,也就是编译Java源文件。注意以上build.xml文件中定义了dir = "lib",所以该文件夹必须存在,否则编译将会失败,因此首先在WEB-INF目录下新建一个lib文件夹。

有两种方法实现编译:

1.直接使用ant compile命令

首先打开cmd,定位到项目中的WEB-INF文件夹(建议将项目复制到某个盘的根目录下,这样比较方便定位),然后输入ant compile命令,如下:

J2EE环境筹建(四)Ant的安装和使用


可以看到在classes目录中生成了一个lee文件夹(也就是Person类所在的包),在lee目录下有一个Person.class的文件,完成。


2.使用ant命令或者ant -file build.xml命令

首先修改build.xml文件,主要修改如下:

<project name="web" basedir="." default="compile">

也就是将default改为compile。因为default指定了该build文件中默认执行的任务,如果指定为空,那么输入ant后者ant -file命令将没有任何生成任务执行。


然后定位到项目的WEB-INF目录下,输入ant命令,或者ant -f build.xml命令,或者ant -file build.xml命令,就会看到编译成功的信息(如果先做了方法一,先删除classe文件夹),并且看到classes/lee/Person.class目录的生成。

简单说说ant的工作原理,在开发者输入ant或者ant build.xml命令后,ant将在当前定位的目录下搜索build.xml文件,如果找到了将以该文件作为生成文件并执行默认的target任务,否则将弹出build.xml does not exist!的错误提示信息(也就是上面所说的ant安装成功的反馈信息)。

如果要指定ant的生成文件,可以使用ant -f name.xml或者ant -file name.xml命令,该命令指定了name.xml文件作为ant的生成文件(从当前目录一直向上搜索到根目录)。在选定生成文件后,ant将执行其中default元素指定的任务,如果为空则不执行任何动作。


当然也可以指定ant命令来执行我们指定的任务,例如编译,运行,打包成jar文件等。

简单列举下ant执行target时使用的命令

ant help:输出该生成文件的帮助信息。

ant compile:编译Java源文件。

ant run:运行编译后生成的Java类。

ant build:将classes下的所有class文件打包成jar文件,并放在dest目录下。

ant clean:删除classes和dest两个目录。

当然首先要在build.xml中指定这些任务执行的细节,如果build.xml文件或指定的生成文件不存在,那么ant将无法工作。因此在这里写build.xml文件是关键所在。


回到开始的问题,将WEB-INF复制到原来的项目中,再Run就没问题了:

J2EE环境筹建(四)Ant的安装和使用

这里有一个奇怪的问题,必须要将该项目直接复制到webapps目录下,不能复制到webapps中的某个子目录下(例如webapps/Demos/JavaBean),否则会运行出错,出错信息和上面一样:

J2EE环境筹建(四)Ant的安装和使用

个人认为是程序首先在webapps/JavaBean目录下的WEB-INF目录下寻找classes/lee/Person.class文件,但是由于JavaBean目录为webapps/2.7/JavaBean,所以找不到对应的class文件,因此报错。