Question

如果你是使用 Eclipse 作为 Java 开发环境（现在很多开发人员都在使用它（ ^[1] ）），和本书其他部分对这一工具的使用（我们原来用它为 Ant 构建处理增加 Hibernate 相关的功能）相比，在 Eclipse 中可以更加充分地使用 Hibernate Tools。

应该怎么做

在深入讨论以前，先需要保证你使用的 Eclipse 的版本足够新。目前 Hibernate Tools 的发行版本至少需要 Eclipse 3.3 和 WTP 2.0。所以，如果你的版本不够新，没有理由不借这个机会更新一下。

在 Eclipse 中安装 Hibernate Tools 最简单的方法就是通过 Eclipse 普通的网站更新机制。首先需要告诉 Eclipse 到哪找 Hibernate Tools，在"Software Update"菜单中选择"Find and Install"菜单项，如图 11-1 所示。

图　11-1　Eclipse 的更新功能

我们现在需要安装全新的一个插件，而不是更新现有的插件，所以在接下来的窗口中应该选择"Search for new features to install"，再点击"Next"。

Eclipse 自己不会自动知道 Hibernate Tools 更新网站，所以我们需要告诉它到哪去找。点击"New Remote Site"，如图 11-2 所示。

图　11-2　在 Eclipse 中从一个新的更新网站来安装插件

输入一些描述性的文字（如"Hibernate Tools"），以作为新的更新网站的名称。Eclipse 现在需要我们指定更新网站的 URL，如稍后的图 11-4 所示。我们必需在网上搜索一下，才能找到正确的更新 URL。

切换到 Web 浏览器，打开 Hibernate 网站 http://hibernate.org，在页面左边的导航菜单中点击"Hibernate Tools"（或者，你也可以直接打开 http://tools.hibernate.org 这个目录链接）。在打开页面以后，可以看看有关这一工具的介绍，以及各种文档链接。我们在第一次研究怎么把这个工具安装到 Eclipse 中时，还花了些时间，最后才发现我们错过了一直要找的东西：在 Tools 页面上原本就有一个更新网站链接。将这个链接的 URL 复制到剪切板，如图 11-3 所示（在链接上用鼠标右键点击或按住 Ctrl 键点击，就可以打开上下文关联菜单）。

图　11-3　获取 Hibernate Tools 更新的网站 URL

如果你仔细观察，可能会注意到这个页面上 Hibernate Tools 的版本要比我们这本书使用的版本（3.2.0 Beta9a）还新。不错，你现在应该明白像 Hibernate 这样大型开源项目变化得太快了，写本关于它的书有多么难！在编写本书时，Hibernate Tools 的稳定版本才刚推出，Maven 库中还未提供对这个版本的支持，所以我们现在先不用管本书原来使用的 Hibernate Tools。无论如何，新版本的变化都不会影响其他章节的示例，只是 Eclipse 的当前最新版本（编写本书时的版本是 3.3，也称为 Europa）需要配合使用 Hibernate Tools 的最新版本，这样才可以支持本章将要演示的一些功能。

将更新网站的 URL 复制粘贴到 Eclipse 的"New Update Site"窗口中，如图 11-4 所示。点击"OK"按钮，以确认保存这个新的网站 URL。

图　11-4　在 Eclipse 中配置一个新的更新网站

从图 11-5 中可以看到，Eclipse 合理地假设你想使用刚才配置的更新网站（勾选了 Hibernate Tools），所以，这时只要点击"Finish"按钮，Eclipse 就会自动连接更新网站，检查从那可以安装的插件。

接着会弹出一个窗口（如图 11-6 所示），这个窗口比较简单，它的出现就表明胜利在望了。所有我们需要做的就是勾选 Hibernate Tools 节点旁边的复选框，现在就安装，对吗？

图　11-5　新的更新网站已经准备好使用 图　11-6　正在安装 Hibernate Tools：我们需要再接再厉

很不走运，当我们选中 Hibernate Tools 节点旁边的复选框时，遇到了麻烦。这个窗口顶部显示了一条错误消息，"Next"按钮也变成了灰色，不让我们继续使用了。

出了什么问题

Eclipse 不让我们继续安装，是因为 SeamTools 功能（组成 Hibernate Tools 工具集的 10 个插件之一）需要安装其他插件（org.eclipse.datatools.connectivity.feature），而且这些插件还不能默认安装。非常不幸，我们只得后退几步。点击"Cancel"按钮，再从本节开始介绍的"Find and Install"菜单选项开始。再一次选择"Search for new features to install"，点击"Next"。这次要选中 Europa Discovery Site 节点，如图 11-7 所示，再点击"Finish"按钮。

图　11-7　选中 Eclipse Discovery Site

从接下来出现的下载镜像列表中选择一个与你的位置合适的选项，点击"OK"按钮（如果你配置 Eclipse 自动选择下载镜像，则不会出现这一步）。这一次你将看到两组插件：Europa Discovery Site 和 Hibernate Tools。再次选择 Hibernate Tools 这组插件来安装。和以前一样，窗口顶部还是会出现错误提示，但是这次我们有机会可以修复这个问题。一种办法就是选择整个"Europa Discovery Site"插件组，但是这样的下载量将大大超过我们实际的需要，会让 Eclipse 的配置变得过于庞大。

所以，我们得规划出需要从 Europa Discovery Site 节点下载的最少的一组插件。保持 Hibernate Tools 插件节点为选中状态，展开 Europa Discovery Site 插件组节点，但是不选中任何东西。虽然可以手工查找和选择 Hibernate Tools 报告需要的插件，但这会导致大量繁琐地摸索、尝试、解决错误，才能确切地明白哪些插件的组合才能让我们需要的东西正常工作（我们试验时，曾经找到过第一个错误中提及的提供数据工具连接功能的插件，不过，我们发现这个插件也有它自己要依赖的其他插件，看来这个插件还不是我们必需的惟一插件）。就在我们摩拳擦掌，准备详细写写如何精确选择需要下载的插件时，我们注意到界面右边的"Select Required"按钮，其实可以用它来自动选择需要的所有插件。不过，我们的实验表明，只有当你第一次打开相应网站（将从这个网站下载你需要的插件）旁边的“打开”三角形节点时，"Select Required"按钮才会起作用。直到我们展开"Europa Discovery site"这个节点以前，它什么也不会做。在展开这个节点以后，点击"Select Required"按钮会自动选择解决依赖错误所需要的插件。既然现在你已经选中了 Hibernate Tools 节点，Europa Discovery site 节点也展开了，那就点击一下"Select Required"按钮吧。最后结果应该类似于图 11-8 所示，不过，要下载安装的插件的确切个数将依赖于原来你可能已经安装过的插件。

图　11-8　选中需要的所有插件

这次不会再有任何错误消息妨碍我们安装 Hibernate Tools 了！点击"Next"按钮，就开始安装这组插件，接受在下一个对话框中的许可协议，并再次点击"Next"。之后会再弹出一个对话框，向你显示一组可以选择安装的可选功能。因为我们只需要 Hibernate Tools 就足够了，所以在 Optional Features（可选功能）对话框中直接点击"Next"按钮以便继续安装我们需要的插件。默认的安装位置（具体位置随 Eclipse 安装位置的不同而不同）差不多总是不错的，除非有特殊原因才需要设置到其他位置，点击 Installation（安装）对话框的"Finish"按钮，继续完成插件的安装。

在下载更新期间，Update Manager（更新管理器）将一直持续运行。最后，将弹出一个 Feature Verification（功能确认）对话框。对于正在安装的每个功能，这个对话框将报告每个功能是否具有 Eclipse 项目授权的机构颁发的加密签名。一些插件具有这样的签名，而另一些（像 Hibernate Tools 本身）则没有有效的签名。第三方 Eclipse 插件通常都是这样的。Eclipse 只是对这种情况进行警告，希望确认你愿意安装其他网站的插件。因为我信任提供要下载的插件的网站，所以全部都确认继续安装。如果你也像我这样（基本上，如果你想使用 Hibernate Tools，就得信任提供这些插件的网站），就只需要点击"Install"按钮，以继续安装某个插件（如果你不想对每个插件进行确认，可以点击"Install All"按钮，以批量接受所有插件）。Update Manager（更新管理器）会继续安装。在安装完所有插件后，它会建议你重新启动 Eclipse。为了确保安全，点击"Yes"按钮，等待 Eclipse 重新启动。

现在做什么

很明显，与过去相比，Eclipse 现在对 Hibernate 提供了更多的支持。Hibernate 配置文件的图标现在包含了一个小的 Hibernate 标志，双击这个图标或映射文件，会打开一个特殊的编辑器，在这个编辑器中创建和更新 Hibernate 映射文件会更方便，而不用直接处理底层的 XML（图 11-9）。

图　11-9　Hibernate 配置文件编辑器

注意：这样就不用像在源代码视图下，得频繁查阅参考文档才可以编辑了！

当然，如果你觉得直接处理 XML 更高效，可以点击编辑器底部的"Source"（源代码）选项页，仍然可以查看 XML。在源代码视图中编辑时，你会发现它已经为编辑各种 Hibernate 相关元素以及取值提供了辅助完成（completion assistance）的功能，如图 11-10 所示。这并不是 XML 编辑器普通的元素名称自动完成功能，普通自动完成只是通过分析 XML DTD 实现的，而 DTD 缺乏对属性名称的足够描述，只能规定些文本规则。

图　11-10　Hibernate 配置文件编辑器中的属性名称自动完成功能

你可以使用普通的 Eclipse 自动完成组合键（ControlSpace）来打开相应的弹出窗口。

映射文档编辑器如图 11-11 所示。这两个编辑器看起来功能强大也很有用；值得花些时间来搞明白它们的工作原理和功能。对于在 Eclipse 中使用 Hibernate 来说，它们本身也是很有价值的工具。

图　11-11　Hibernate 映射编辑器

为了探索用 Hibernate Tools 还可以做些什么其他事，首先要在项目中激活它。如果你是从一个新项目开始的，可以选择先创建一个新的 Hibernate 配置文件。如果你是从一个现有的 Hibernate 项目开始的（本章我们就是这样做的），你可以跳过这一步，只需要创建一个新的 Hibernate 控制台（console）就可以了。

[1] http://www.oreillynet.com/onjava/blog/2004/06/ive_been_eclipsed.html.