创建基于 EL4Ant 系统的模块和项目

本文前提条件

本文内容是建立在下面的软件之上，这些软件分别是：

• 语言开发环境： Sun Java 5.0
• 语言集成开发环境： Eclipse 3.2 以上
• 语言构建系统： EL4Ant 0.9.3 GnuWin32 Notepad++

关于软件 EL4Ant 和 GnuWin32 的相关安装资料可以参照这里的技术资料 [ 1 ] 和 [ 2 ]。为了我们说明问题简单起见，需要修改和设定下面的环境变量，其中方括号内容需要作相应的修改：

``SET EL4ANT_HOME=[EL4Ant 软件的安装目录]<p><code>SET ANT_HOME=%EL4ANT_HOME%\ant</code><code>SET NPP_HOME=[Notepad++ 的安装目录]</code><code>SET PATH=%PATH%;%ANT_HOME%\bin;%NPP_HOME%</code></p>为了使得 EL4Ant 系统可以利用 Sun Java SDK 5.0 版本，我们需要修改一下软件 EL4Ant 的样板工程的配置文件 bootstrap.properties，该文件在系统终端中利用下面的命令或者其它文本编辑器被打开：

notepad++ %EL4ANT_HOME%\el4ant\project-template\etc\bootstrap.propertie然后在该文件中找到内容“buildsystem.javac.source”，把其值改为如下所示：

buildsystem.javac.source=1.5### 创建自己的 EL4Ant 工程及其模块

为了系统地阐述 EL4Ant 系统以及为今后集成 HiveMind 框架和 Spring 框架到 EL4Ant 系统等做好准备，本文的所有内容都是在一个称之为 infoq_cn 新工程下面，我们将在该工程下创建一个新的模块 helloworld 作为本文所有 Eclipse 项目的模块项目，简称模块。首先我们切换到 EL4Ant 系统的根目录，然后利用 EL4Ant 系统的工程模板 project-template，创建一个我们自己的新工程 infoq_cn。在实际工作中，你可以按照工程的需要创建若干个这样的工程，工程名称也可以根据现实的需要进行命名。接下来为了创建一系列Eclipse**** 项目，在工程目录 infoq_cn 下我们需要生成一个模块 helloworld。这种模块名称也是自己定义的，并且可以产生任意多个这样的模块。以上内容在系统终端下可以利用如下操作命令被完成：

``cd %EL4ANT_HOME%<p><code>cp -R el4ant\project-template infoq_cn</code><code>cd infoq_cn</code><code>mkdir helloworld</code></p>### 创建基于 EL4Ant 的 Eclipse 项目

在这里我们将继续说明，在 EL4Ant 系统中如何创建一个基于 Eclipse 集成开发工具的简单 Eclipse 项目。一般而言，创建这样的一个 Eclipse 项目大致有三个步骤：产生 Eclipse 项目的相关目录；修改工程的工程配置文件 project.xml；导入创建好的 Eclipse 项目到 Eclipse 集成开发环境。下面我们通过实例来说明这样方法。

因为我们在模块 helloworld 下可以创建很多相关的 Eclipse 项目，所以一般在实际软件开发中，把一些相关的 Eclipse 项目（比如该项目的测试 Eclipse 项目等）存放在某个目录（在一个模块目录下这样的目录，我们称之为Eclipse**** 项目组目录） 下，以便许多 Eclipse 项目更好地和有序地被管理和控制。先确定自己的 Eclipse 项目组目录的和 Eclipse 项目目录。比如我们想把所有模板 Eclipse 项目在一起管理，就会把所有模板项目生成在目录 helloworld/template 下。而 Eclipse 项目的根目录是在 Eclipse 项目组目录 helloworld/template 下的一个子目录 basic。要想产生这样的一个 Eclipse 项目，其执行命令如下：

mkdir helloworld\template\basic

mkdir helloworld\template\basic\java注意所有下面的命令都是在目录 %EL4ANT_HOME%\infoq_cn 下被执行。你还看到上面命令中创建了一个 java 目录，这是 EL4Ant 的 Eclipse 项目的 Java 源代码默认目录。而 EL4Ant 不用我们关心 Eclipse 项目的 Java 代码的编译目录和第三方软件包目录。接下来我们要告诉 EL4Ant 系统，我们的 Eclipse 项目在哪里、Eclipse 项目的相互关系如何和 Eclipse 项目需要什么样第三方软件包等等。打开 El4Ant 工程 infoq_cn 的最重要工程配置文件 project.xml，其命令如下：

notepad++ project.xml在你打开了该文件以后，我们把下面的代码加入到该文件的标记 ant:project 内。其中标记 module 的 path 是 Eclipse 项目的根目录；标记 module 的 name 是你可以自己定义有意义的名称，要是不定义就是 path 内容，但是不包含 path 的“/”，比如 module 的属性 path 的值是 “helloworld/template/basic”，该 module 的属性 name 的值就是“helloworldtemplatebasic”；属性 runtime.class 的值是你即将创建的包括包名在内的 Java 类。属性 runtime.runnable 的值是 true 说明这个的类 Main 是可执行的。

<module path="helloworld/template/basic" name="template.basic">
   <attribute name="runtime.runnable" value="true">
   <attribute name="runtime.class" value="com.hhtong.helloworld.Main">
</module>

在该工程配置文件中，你还可以定义项目需要哪些软件包和哪些相关的 Eclipse 项目，这样可以十分明确了解所有 Eclipse 项目之间的相互关系。在把 Eclipse 项目导入到 Eclipse 开发工具之前，我们必须执行下面的命令，以达到创建一个 Eclipse 项目的相关配置文件。现在我们可以进入 Eclipse 集成开发工具。关于如何把 EL4Ant 的 Eclipse 项目导入到 Eclipse 开发工具方法请看这里 [ 1 ]。

ant -f bootstrap.xml在你导入了 Eclipse 项目 template.basic 之后，就可以进行该项目的代码开发和程序运行：

• 创建 Java Package，其名称为：com.hhtong.helloworld
• 创建包 com.hhtong.helloworld 的 Java 类，其名称为：Main
• 编辑 Java 文件 Main.java 成为一个简单的 Java 应用软件
• 在系统终端执行下面的命令，或者通过 Eclipse 工具执行该文件

ant jars start.module.eu.helloworld.app### EL4Ant 工程及其模块和 Eclipse 项目相互关系

上面我们完成了从 EL4Ant 工程一直到该工程的 Eclipse 项目创建的整个过程。为了能够让你更为全面的理解它们之间的相互关系，这里给出了下面三个表。在【表一】中的所有目录都是在 EL4Ant 根目录下的子目录，这些目录可以分为两大类：一类是工具目录，另一类是 EL4Ant 工程目录。在我们的实例中，每个 EL4Ant 工程分别是【表二】的左右表格。【表三】是我们针对工程 infoq_cn 而给出的，其中 Eclipse 项目 template/hivemind 和 hivemind/calculator 是下一次需要说明的 Eclipse 项目。从这些表可以清晰地看到所有工程、模块和 Eclipse 项目的情况和相互关系，便于我们软件管理人员进行软件工程的管理和控制，也给我们软件开发人员对于整个工程有个完整的了解。

【表一】

【表二】

【表三】

后记

下次我们有机会再探讨如何集成 Google Guice 框架到的 EL4Ant 系统中。

从软件开发的角度来看，软件工程的管理和控制实际上是如何把一个现实软件工程如何分割成若干个开发工具的项目比如 Eclipse 项目或者 NetBeans 项目。为了实现这一目标，EL4Ant 系统给与了我们很好的基本架构。如何把不同的框架或者软件包集成在一起，并且有效地在一起工作（具体地说被一个 Eclipse 项目或者 NetBeans 项目所利用）是一个很复杂的工作。

作者简介：骆古道，网名 Cnruby，八十年代初毕业于西北工业大学数理力学系，1988 年公派留学德国，从事组合最优化理论研究，从九十年代初期起一直致力于计算机领域软件开发、设计和管理等方面工作，其个人博客为道喜技术日记。