Swarm 安装与开发环境配置 如果你正在研究多智能体系统（Multi-Agent Systems，MAS），如果恰巧你有一点 Java 程序设计基础，如果更巧的是你对用 Swarm for Java 开发 MAS 抱有浓厚的兴趣，那么请跟随我一起来搭建一个 JDK+JCreator+Swarm 的轻量级 MAS 开发环境吧。不过我们默认你已经安装好 JDK 和 JCreator没装好的话请自行查找相关资料并安装。关于 JDK，我用的是JDK1.5，不过 JDK6 早已经发布了；关于 JCreator，我用的同样是古董级的 3.5 版本，无他，习惯而已。补充：环境变量配置JAVA_HOME: D:Javajdk1.7.0（新建）PATH: %JAVA_HOME%bin;（放到已有的 PATH 路径的最前面）CLASSPATH: .;%JAVA_HOME%libdt.jar;%JAVA_HOME%libtools.jar;（新建，前面有.不能省略）对于 Swarm 就不多做介绍了，下面直奔主题，follow me。1 Swarm 下载 Swarm 的官方主页（http:/www.swarm.org/）提供了其下载地址http:/ftp.swarm.org/。下载页面的目录如图 1 所示。图 1 Swarm 下载主页要下载 Java 版本的 Swarm，请按照图 2 提示的路径找到 Swarm-2.2-java.tar.gz 或 Swarm-2.2-java.zip 压缩包。这是截止到我写此文时已发布的版本。图 2 Swarm for Java 下载页这里，我推荐另一个下载地址 http:/eco83.econ.unito.it/dottorato/。该地址提供了搭建 Swarm for Java 开发环境所需要的所有组件除了JCreator。打开下载链接，界面如图 3 所示。图 3 Swarm CD 下载主页找到 Swarm-2.2-Tutorial-CD，点进去之后有两个选项：可以下载比较大的.iso 集成包，其中包含了 JDK 和 eclipse 等搭建 Java 开发环境所需要的软件或工具；也可以打开第二个文件夹，选择自己所需要的组件下载。图 4 Swarm CD 下载页我们打开第二个文件夹，找到并下载 StartJavaSwarm.bat、Swarm-2.2-java.tar.gz、jheatbugs-2001-03-28.tar.gz 、jmousetrap-2001-09-13.tar.gz。其中后两个是 Swarm 示例程序。此外，doc-swarm 有诸多参考资料、手册，可以选择性下载。图 5 Swarm CD 可选的组件2 Swarm 安装现在我们来在 JDK 基础上构建 Swarm 运行环境。解压上述已下载的压缩包，其包含的子目录如下：Swarm-2.2-java/bin/include/lib/share/图 6 Swarm 开发包的子目录然后在你自己的硬盘中开辟一个专用空间，建立一个文件夹，用于存放 Swarm 的各个组件以及你自己开发的 Swarm 程序文件。将上述文件全部复制到指定目录下。本人构建的工作目录如下：D:/JIDE/Swarm/bin/include/lib/share/work/StartJavaSwarm.bat/Swarm2.2_Java_API.chm图 7 Swarm 工作目录其中，/work/目录是个人程序/ 项目源代码存放的场所。Swarm2.2_Java_API.chm 是从 Swarm 主页上下载的 API 文档。为了能够在我们的开发环境中启动 Swarm，需要修改StartJavaSwarm.bat 文件。打开 StartJavaSwarm.bat。 StartJavaSwarm.bat123456789101112echo offset SWARMHOME=C:/Swarm-2.2-javaset JAVA_HOME=C:/j2sdk1.4.2_08set SWARMDIR=%SWARMHOME%set PATH=%PATH%;.;%SWARMHOME%/bin;%JAVA_HOME%/binset LTDL_LIBRARY_PATH=%SWARMHOME%/libset LD_LIBRARY_PATH=%SWARMHOME%/libset CLASSPATH=%SWARMHOME%/share/swarm/kawa.jar;%SWARMHOME%/share/swarm/swarm.jar;%CLASSPATH%echo SWARMHOME=%SWARMHOME%echo JAVA_HOME=%JAVA_HOME%echo JavaSwarm Variables initializatedCMD /K图 8 原始 StartJavaSwarm.bat 文件我们来修改以上文件。这里先给出修改后的结果，再逐行解释。StartJavaSwarm.bat123echo offset SWARMHOME=D:/JIDE/Swarmset JAVA_HOME=C:/Program Files/Java/jdk1.5.04567891011121314set SWARMDIR=%SWARMHOME%set PATH=%PATH%;.;%SWARMHOME%/binset LTDL_LIBRARY_PATH=%SWARMHOME%/libset LD_LIBRARY_PATH=%SWARMHOME%/libset CLASSPATH=%SWARMHOME%/share/swarm/kawa.jar;%SWARMHOME%/share/swarm/swarm.jar;%CLASSPATH%echo SWARMHOME=%SWARMHOME%echo JAVA_HOME=%JAVA_HOME%echo JavaSwarm Variables initializatedjava %1exitCMD /K图 9 修改后的 StartJavaSwarm.bat 文件新文件第 2 行修改了 SWARMHOME 环境变量，它的值是开发环境所在目录。第 3 行修改成 JAVA_HOME 环境变量所在目录。第 4 行不需要修改。第 5 行稍微解释一下。由于本人的 Windows 操作系统中的环境变量PATH 已被设置为包含 %JAVA_HOME%/bin，故这里将其删去。一般情况下这一行可不作修改。第 611 行都不需要修改。第 12、13 行为新添加的两行，这是为了方便在 JCreator 中直接运行最终的 Swarm 程序。命令“java %1” 用于运行.class 文件，“%1”是传递给java 命令的参数，代表当前的.class 文件，在下文中将详细解释。3 使得 JCreator 能够编译 Java for Swarm 源文件这一步的主要工作是在 JCreator 中配置类路径，以使 JCreator 能够顺利编译 Swarm 程序源文件。我用的是 JCreator 3.5 Pro 汉化版，这一版本已经伴随我多年了，中途当然也出轨过，试图更新到 4.5 版（目前最新版已到了 5.0 了）。不过用来用去，还是 3.5 的用着最舒服。老婆还是原配的好啊。打开 JCreator，依次选择 “配置”“选项” ，打开选项卡，如图 10 所示。图 10 JCreator 配置找到并点击“JDK 配置文件” ，在右边视图中选中“JDK 版本 1.5.0”选项（有可能你的配置是 JDK 6 版本），如图 11 所示。图 11 JCreator 选项界面 点击“编辑”，出现“JDK 配置文件”视图。图 12 JCreator 的 JDK 配置文件界面 在“类”的配置中，选择 “添加”“添加存档 ”。图 13 添加类存档 将 D:/JIDE/Swarm/share/swarm 下的两个.jar 文件 kawa.jar 和swarm.jar 添加到类路径中。图 14 选择所需的.jar 文件 这样就可以在 JCreator 中编译 swarm 源程序了。我们打开一个示例程序试试。将下载的示例程序 jmousetrap 解压并复制到/work/目录下。打开StartMousetrap.java 并编译。成功编译后，这时你会发现，想在 JCreator 中通过 F5 直接运行StartMousetrap.class 是不能成功的，因为 Swarm 项目文件的运行依赖于 StartJavaSwarm.bat 中的设置。因此，通常应该先双击运行StartJavaSwarm.bat，然后在命令行中以 “java *”的形式运行 Swarm 程序。如果你足够懒的话，你应该会很希望像运行普通的 Java 程序一样，一键运行 Swarm 项目程序。下面提供在 JCreator 中的解决方案。4 使得 JCreator 能够执行 Swarm 应用程序JCreator 提供了自定义工具，可以为开发过程中常用的辅助工具建立快捷方式到工具栏中，从而在需要时可以很方便地打开。添加工具的方式如下：依次点“配置 ”“选项”，选择“工具” 。图 15 配置辅助工具 点击“新建”，这里列出了可以作为工具的应用程序类型。我们要为StartJavaSwarm.bat 添加工具，需要选择 “程序”。图 16 新建程序 选择工作目录下的 StartJavaSwarm.bat 文件，打开。图 17 StartJavaSwarm.bat 接下来我们需要配置 StartJavaSwarm.bat 的参数。还是在 “选项”界面，点开左边树形栏目的“工具” ，找到刚才创建的 StartJavaSwarm（名称可以自行更改），右边界面给出了该工具的配置。如图 18 所示，在参数一栏中输入：$CurClass。这里的$CurClass是 java.exe 的命令行参数，代表当前的类文件，也就是你的 JCreator 界面当期显示的 Java 文件编译生成的.class 文件。还记得前面 StartJavaSwarm.bat 文件第 12 行的“java %1” 吗？$CurClass的值被传递给%1，经过 java 命令后程序开始运行。图 18 配置参数现在，我们可以在 JCreator 界面上一键运行 Swarm 了。如下图所示，在 JCreator 的工具栏上的第一把工具就是 StartJavaSwarm 了。它告诉我们，你可以用 ctrl+1 的方式快捷运行该工具。如果你的 JCreator 界面没有显示工具栏，请右击任务栏的空白处，将“工具”一项的前面勾上。图 19 创建好工具后的界面 好了，测试一下吧。打开示例程序 jmousetrap 中 main 方法所在的文件StartMousetrap.java，编译，然后按 ctrl+1。图 20 Swarm 运行测试很酷吧！