Question

可能有些令人意外，在运行 Hibernate 之前需要做几件与 Hibernate 本身无关的事。首先，你必须搭建一个开发环境，以供示例代码可以运行。也可以为你可能构建的任何实际项目奠定坚实的基础，这将是令人高兴的意外收获。

如果在你的 Java 项目中，还没有使用 Ant 去管理构建（build）、测试（test）、运行（run）以及打包（package）的工作，现在就是开始使用 Ant 的好时机。本书的示例都是 Ant 驱动的，所以，你得安装一个能用的 Ant 才能运行示例代码，并验证在系统中对代码做出的修改，这才是最佳的学习方式。

首先，获得 Ant 的二进制发布版本，并安装它。

为何在意

我们选择使用 Apache Ant 来处理示例有几个原因。Ant 很方便，而且功能强大，它已经成为基于 Java 开发的标准构建工具，而且是免费、跨平台的工具。如果使用 Ant，我们的示例将可以在任何 Java 环境中一样地正常运行；也就是说，本书的任何读者都不会因为运行示例而遇到麻烦。这也意味着，我们可以少花一点力气就能够做很多很酷的事情，尤其是几个 Hibernate 工具特意支持 Ant 之后，更是如此。我们会教你如何利用这些工具（值得注意的是，最近更复杂的 Java 项目经常使用的是 Maven（ ^[1] ），它增加了很多其他的项目管理功能。所以我必须从二者中挑选一个，本着尽可能简单和实用的原则，我就决定继续使用 Ant 来管理这些示例）。如果你目前正在使用 Maven 作为代码构建工具，你会注意到我们使用 Maven 的 Ant 任务（Task）来管理 Ant 构建的依赖关系。虽然 Maven 的发展势头强劲，但 Ant 仍然是目前 Java 开发中使用最广泛的构建工具。每一章的示例代码文件夹中也包含一个 Maven 的 pom.xml 文件，可以用 Maven 进行编译。在许多情况下，使用 Maven Hibernate3 插件，Maven 构建文件提供的功能与 Ant 的 build.xml 文件一样。第 12 章介绍了如何用完整的 Maven 来构建和部署 Hibernate 应用程序的方法，但本书大部分示例仍旧使用 Ant 作为构建工具，同时使用 Maven Ant Task 来查找和下载需要的各种库文件，包括库文件之间互相信赖的文件。

为了能够使用这些功能，需要做的第一件事就是先安装 Ant，让它可以正常运行起来。

注意：我以前觉得奇怪，可以用 Make，为什么还要用 Ant？现在，我已经明白用 Ant 来管理 Java 的代码构建有多么美妙，没有 Ant 还真的不行。

应该怎么做

Ant 的二进制发布包可以在 http://ant.apache.org/bindownload.cgi 下载。滚动网页，找到 Ant 的当前最新版本，然后下载适合的压缩文件格式。选择一个适合存放的位置保存文件，然后解压。压缩文件展开的目录就是 ANT_HOME。假如你把压缩文件解压到目录/usr/local/apache-ant-1.7.0，你可能会想创建一个符号链接（symbolic link）以方便使用，同时当你升级到新版本时，也可以免去更新环境配置的麻烦：

/usr/local%ln-s apache-ant-1.7.0 ant

安装好 Ant 之后，需要做一些设置才能让它正常工作。你得将 Ant 的 bin 目录（在这个例子中，就是/usr/local/ant/bin）添加到命令路径中。还需要设置环境变量 ANT_HOME，将其设定为安装 Ant 的最顶级目录（在这个例子中，就是/usr/local/ant）。至于如何在不同的操作系统中执行以上这些处理步骤，如果需要的话，可以参阅 Ant 的手册（http://ant.apache.org/manual/）。

[1] http://maven.apache.org/.