在讨论安装和使用 Castor 的细节之前，有必要指出尝试 Castor 以及从 JAXB 转变到 Castor 的理由。

首先，Castor 几乎是 JAXB 的替代品。换句话说，可以轻易地将所有 JAXB 代码转变为 Castor（并不是完全取代，但是足以使刚刚接触 Castor 的程序员轻松完成任务）。

其次，Castor 在数据绑定领域提供了许多的功能，无需使用模式便可在 Java 和 XML 之间进行转换，提供一种比 JAXB 更易于使用的绑定模式，以及能够对关系数据库和 XML 文档进行编组（marshal）和解组（unmarshal）。

Castor 还提供了 JDO 功能。JDO 也就是 Java Data Objects，是驱动 Java-to-RDBMS 编组和解组的底层技术。尽管不再像前几年那么流行，JDO 仍然是一个不错的功能。此外，由于 JDO 也是一种 Sun 规范，因此不用编写模糊的 API。

回页首

下载 Castor

Castor 的安装过程很简单。首先，访问 Castor Web 站点（参见参考资料中的链接）并在左侧菜单中单击Download。选择 latest milestone release，然后向下滚动到Download sets。您可以下载 Castor JAR、DTD、doc、dependency 等所有内容，预打包的下载套件非常容易使用（参见图 1）。

图 1. Castor Web 站点的下载套件

在本文中，我们将使用版本 1.1.2.1。我选择 ZIP 格式的The Castor JARs, docs, DTDs, command line tools, and examples下载套件。您将获得一个可以展开的归档文件，其中包含许多 JAR 文件、文档和示例程序（参见图 2）。

图 2. 展开的 Castor 归档文件

回页首

正确放置所有文件

接下来，需要将 Castor 的所有文件安放在系统中的正确位置，使您的 Java 环境能够访问它们。

将 Java 库放在同一个位置

我强烈建议将所有第三方 Java 库放在一个常见位置。您可以将它们随意散放在系统中，但是这样做会带来严重后果，因为如下原因：

在大多数情况下很难找到需要的东西。

您将会花大量时间来确定使用的库版本，因为您会经常将多个版本放在系统的不同位置。

类路径将会变得很长而且难于理解。

我将我的所有库放在/usr/local/java/中，每个库放在自己的子目录中（各个目录通常带有一个版本号）。因此将 Castor 归档文件 — 经过扩展 — 移动到您常用的库位置。在本例中，Castor 的完整路径为：/usr/local/java/castor-1.1.2.1。

为 Castor JavaDoc 添加书签

在系统中设置 Java 库的另一个步骤是定位和链接到文档。您会经常这样做，而且大多数 Java 库都提供文档的本地副本（包括 JavaDoc），使用 HTML 格式。在 Castor 中，这个路径是 castor-1.1.2.1/doc/。因此在我的系统中，我为/usr/local/java/castor-1.1.2.1/doc/index.html添加了一个书签。图 3 显示了本地载入的 Castor 文档外观，版本为 1.1.2.1。

图 3. 本地载入的 Castor 文档

在本文中以及在您日常编程中都需要执行这些操作，原因有二：

文档是本地的。 在飞机上编写过程序吗？是不是没有网络链接？不能登录到 Starbucks WiFi 吧？本地文档除了能够更快速地访问之外，在这些情形中也发挥着重要作用。

本地文档总是适合您自己的需要。随着 Castor 的不断发展，您也许不会经常下载最新的发行版。使用在线文档就意味着使用最新版本的文档，这可能与您系统中的版本不匹配。当使用本地文档时，使用的文档总是和当前使用的库版本对应。因此，不会由于使用不恰当或者库版本中根本不存在的特性而引起混乱和挫折。

回页首

下载 Castor 依赖项

Castor 有许多依赖项：

Apache Ant

Jakarta Commons

JDBC 2.0 Standard Extensions

Log4J 登录实用程序

Apache Xerces XML 解析程序

这实际上是适用于大多数 Castor 操作的一个精简的集合。如果想从头构建 Castor、运行这些示例、使用这些测试，或者更深入地研究 Castor，还需要更多的依赖项。必须将这些依赖项放到类路径中，才能使用 Castor。

复杂的方法

要运行 Castor，比较麻烦的方法就是，首先访问 Castor 的下载页面并记下所需的每个依赖项的版本。然后跳转到每个依赖项的 Web 站点，找到该版本，下载并将其添加到类路径中。这种方法会花费较长的时间，但是更加易于控制。此外，如果您已经设置好并能正常运行大多数库，这仍然是一个可行的方法。

简单的方法

幸运的是，还有一种更好的方法。回到 Castor 的下载页面，找到稳定版本，并定位到另一个下载套件，这个下载套件叫做Full SVN snapshot: All sources, docs, and 3rd party libraries (big)。尽管标记为 “big”，但只有 10 MB（对于用 DSL 或者电缆上网的用户来说，这根本不算什么）。下载这个文件，并展开（如图 4 所示）。

图 4. Full SVN 截图（已展开）

现在可以进入lib/目录了，其中包含大量的 JAR 文件。这些正是 Castor 所需的库。

存放更多库的位置

创建一个新目录 — 在最初的 Castor 安装目录中或者与之同级的目录 — 然后将刚才下载的所有 JAR 文件移动到这个目录中。例如：

[bmclaugh:~] cd /usr/local/java

[bmclaugh:/usr/local/java] ls

castor-1.1.2.1 xalan-j_2_7_0

[bmclaugh:/usr/local/java] cd castor-1.1.2.1/

[bmclaugh:/usr/local/java/castor-1.1.2.1] ls

CHANGELOG castor-1.1.2.1.jar

castor-1.1.2.1-anttasks.jar doc

castor-1.1.2.1-codegen.jar jdbc-se2.0.jar

castor-1.1.2.1-ddlgen.jar jta1.0.1.jar

castor-1.1.2.1-jdo.jar schema

castor-1.1.2.1-xml.jar

[bmclaugh:/usr/local/java/castor-1.1.2.1] mkdir lib

[bmclaugh:/usr/local/java/castor-1.1.2.1] cd lib

[bmclaugh:/usr/local/java/castor-1.1.2.1/lib] cp ~/downloads/castor-1.1.2.1/lib/*.jar .

[bmclaugh:/usr/local/java/castor-1.1.2.1/lib]

此处，我在 Castor 文件夹中创建了一个lib/目录，将所有的 JAR 文件移到其中，供 Castor 使用。

回页首

设置类路径

现在需要设置类路径中的所有东西。我在 Mac OS X 配置中使用一个.profile文件处理所有这些问题。您也许想将您的 profile 也设置为这样，或者在 Windows 中设置一个系统环境变量。在任何情况下，都需要将如下 JAR 文件添加到类路径：

castor-1.1.2.1.jar（在 Castor 主目录中）

castor-1.1.2.1-xml.jar（在 Castor 主目录中）

xerces-J-1.4.0.jar（放在与 Castor 依赖项库相同的位置）

commons-logging-1.1.jar（放在与 Castor 依赖项库相同的位置）

作为参考，以下是我的.profile，从中可以看到我是如何设置的：

export JAVA_BASE=/usr/local/javaexport JAVA_HOME=/Library/Java/Homeexport XERCES_HOME=$JAVA_BASE/xerces-2_6_2export XALAN_HOME=$JAVA_BASE/xalan-j_2_7_0export CASTOR_HOME=$JAVA_BASE/castor-1.1.2.1export EDITOR=viexport CASTOR_CLASSES=$CASTOR_HOME/castor-1.1.2.1.jar:

$CASTOR_HOME/castor-1.1.2.1-xml.jar:

$CASTOR_HOME/lib/xerces-J_1.4.0.jar:

$CASTOR_HOME/lib/commons-logging-1.1.jarexport CVS_RSH=sshexport PS1="[`whoami`:\w] "export CLASSPATH=$XALAN_HOME/xalan.jar:$XALAN_HOME/xml-apis.jar: $XALAN_HOME/xercesImpl.jar: ~/lib/mclaughlin-xml.jar:$CASTOR_CLASSES:.

请确保将所有这些文件都放到了类路径中，接下来将做一个快速测试。

回页首

测试安装

首先构建一个非常简单的类，然后构建一个实用程序将其在 XML 和 Java 之间来回转换。这里并不会演示 Castor 的所有功能，而只是一个非常基本的测试。清单 1 显示了我将使用的一个 CD 类。输入这些源代码并保存为CD.java（或者从参考资料下载这些代码）。

清单 1. CD 类（用于测试）

package ibm.xml.castor;

import java.util.ArrayList;

import java.util.List;

/** A class to represent CDs */

public class CD implements java.io.Serializable {

/** The name of the CD */

private String name = null;

/** The artist of the CD */

private String artist = null;

/** Track listings */

private List tracks = null;

/** Required no-args constructor */

public CD() {

super();

}

/** Create a new CD */

public CD(String name, String artist) {

super();

this.name = name;

this.artist = artist;

}

public void setName(String name) {

this.name = name;

}

public String getName() {

return name;

}

public void setArtist(String artist) {

this.artist = artist;

}

public String getArtist() {

return artist;

}

public void setTracks(List tracks) {

this.tracks = tracks;

}

public List getTracks() {

return tracks;

}

public void addTrack(String trackName) {

if (tracks == null) {

tracks = new ArrayList();

}

tracks.add(trackName);

}

}

现在需要一个类处理编组。如清单 2 所示。