生成一个简单的Java项目

生成一个简单的Java项目
简介
现在我们已经清楚了 Ant 生成文件的格式，并了解了如何定义属性和依赖关系以及如何运行 Ant，下面可以开始为一个基本的 Java 项目构建一个生成环境了。这将包括学习用于编译源代码和组合 JAR 文件的 Ant 任务。
编译源代码
由于 Ant 的主要目标是生成 Java 应用程序，它能够内在地、出色地支持调用 javac 编译器以及其他 Java 相关任务就毫不奇怪了。下面是编译 Java 代码的任务的编写方式：

<javac srcdir="src"/>

这个标签寻找 src 目录中以 .java 为扩展名的所有文件，并对它们调用 javac 编译器，从而在相同的目录中生成类文件。当然，将类文件放在一个单独的目录结构中通常会更清晰；可以通过添加 destdir 属性来让 Ant 做到这点。其他有用的属性包括：
classpath：等价于 javac 的 -classpath 选项。
debug="true"：指示编译器应该带调试信息编译源文件。
javac 任务的一个重要特点在于，它仅编译那些它认为需要编译的源文件。如果某个类文件已经存在，并且对应的源文件自从该类文件生成以来还没有改变过，那么该源文件就不会被重新编译。javac 任务的输出显示了实际被编译的源文件的数目。编写一个 clean 目标来从目标目录移除生成的任何类文件是个很好的习惯。如果想要确保所有源文件都已编译，就可以使用这个任务。这种行为刻画了 Ant 的许多任务的特点：如果某个任务能够确定所请求的操作不需要执行，那么该操作就会被跳过。
像 Ant 一样，javac 编译器本身也是用 Java 语言实现的。这对 Ant 中的 javac 任务的使用来说非常有利，因为它通常调用 Ant 运行所在的相同 Java 虚拟机（JVM）中的编译器类。在每次需要编译 Java 代码时，其他生成工具通常需要运行一个新的 javac 进程，从而需要一个新的 JVM 实例。但是在使用 Ant 的情况下，只需要单个 JVM 实例，它既用于运行 Ant 本身，也用于执行所有必需的编译任务（以及其他相关任务，比如处理 JAR 文件）。这是一种高效得多的资源使用方式，能够极大地缩短项目生成时间。
编译器选项
正如我们从前一小节看到的，Ant 的 javac 任务的默认行为是调用运行 Ant 本身的任何 JVM 的标准编译器。然而，有时您可能想要单独地调用编译器 —— 例如当你希望指定编译器的某些内存选项，或者需要使用一种不同级别的编译器的时候。为实现这个目的，只需将 javac 的 fork 属性设置为 true，比如像下面这样：

<javac srcdir="src" fork="true"/>

如果想要指定一个不同的 javac 可执行文件，并向它传递一个最大内存设置，您可以像下面这样做：

<javac srcdir="src" fork="true" executable="d:\sdk141\bin\javac"
memoryMaximumSize="128m"/>

甚至可以将 Ant 配置为使用某种不同的编译器。受支持的编译器包括开放源代码的 Jikes 编译器和来自 GNU 编译器集（GNU Compiler Collection，GCC）的 GCI 编译器。（请参阅参考资料以了解关于这两种编译器的更多信息。）可以通过两种方式指定这些编译器：可以设置 build.compiler 属性，这将应用于使用 javac 任务的所有场合；或根据需要设置每个javac 任务中的 compiler 属性。
javac 任务还支持其他许多选项。请参考 Ant 手册以了解更多细节（请参阅参考资料）。
创建 JAR 文件
在编译 Java 源文件之后，结果类文件通常被打包到一个 JAR 文件中，这个文件类似 zip 归档文件。每个 JAR 文件都包含一个清单文件，它可以指定该 JAR 文件的属性。
下面是 Ant 中 jar 任务的一个简单使用例子：

<jar destfile="package.jar" basedir="classes"/>

这将创建一个名为 package.jar 的 JAR 文件，并把 classes 目录中的所有文件添加到其中（JAR 文件能够包含任意类型的文件，而不只是类文件）。此处没有指定清单文件，因此 Ant 将提供一个基本的清单文件。
manifest 属性允许指定一个用作该 JAR 文件的清单的文件。清单文件的内容还可以使用 manifest 任务在生成文件中指定。这个任务能够像文件系统写入一个清单文件，或者能够实际嵌套在 jar 之内，以便一次性地创建清单文件和 JAR 文件。 例如：

<jar destfile="package.jar" basedir="classes">
  <manifest>
    <attribute name="Built-By" value="${user.name}"/>
    <attribute name="Main-class" value="package.Main"/>
  </manifest>
</jar>