在Domino应用程序中集成Google的Web API服务

在Domino应用程序中集成Google的Web API服务2010-07-21 IBM Sui-Man Chan面对 Google 当前和不断扩充的 30 多亿个 Web 页面的索引，它之所以会成为在Internet 上执行工业强度的搜索的最佳工具之一就不难理解了。除了其 Web 页面的数量之外，搜索结果的质量之高也归功于其专有的搜索算法，该算法建立在相关性和流行性的基础上。最近的报告表明，Google 每天以 88 种不同的语言响应 2 亿个搜索请求（平均每秒响应 2,300 个请求！）。而根据 SearchEngineWatch.com 的调查，Google 处理了基于 Web 的所有查询中的百分之七十五。

显而易见，许多 Web 用户很熟悉 Google 及其搜索特性。不那么为人所知的事实是，您可以使用 Google 的 Web API 服务，将 Google 的搜索功能整合进自己的 Domino 应用程序中（正如我们将在下一节说明的那样，您可以免费下载这个 API）。本文讲述如何向 Domino 应用程序添加 Google 的搜索功能。我们将简要介绍 Google API 以及它们是如何工作的。然后我们将研究一个示例应用程序，它将 Google 搜索功能与 Domino 应用程序集成在一起。我们最后将提供一些如何扩充和定制这个简单例子的思路，从而结束本文的讨论。（本文中出现的所有例子都包含在一个 Domino 数据库中，您可以从 Sandbox下载该数据库。）

本文假设您是对编写 Domino 代理很熟悉的有经验的 Notes 应用程序开发人员。虽然高级 Java 经验不是理解我们的例子所必需的，但是强烈建议您了解一些 Java 的基础知识。

Google API

要使用 Google 的 API，请从 Google 的 Web API 下载页面下载 Google Web API 开发者工具箱（Googleapi.zip），并创建一个免费的 Google 帐户以获得一个许可密钥。该密钥允许您每天最多执行 1,000 次搜索（您必须在发出搜索请求时在查询中包括此密钥。这是通过编程方式完成的，因此用户不必在每次执行查询时都键入该密钥）。该开发者工具箱附带了文档和例子，使您对 Google 的自动化搜索如何工作有一个基本的了解。

在下载 Googleapi.zip 之后，请将它解压缩到 c:Googleapi目录中。然后您就可以通过在MS-DOS 命令提示符下键入以下命令来快速调用该 Web API： java -cp Googleapi.jar com.Google.soap.search.GoogleAPIDemo <key> search Lotus Domino > result.html ，其中 < key > 是您的注册密钥，“Lotus Domino”是您想要搜索的项，result.html 是您想要将搜索结果写到其中的文件的名称。例如，下面的例子：

清单 1. 搜索结果

...
Start Index = 1
End Index = 10
Estimated Total Results Number = 663000
...

显示了估计的 663,000 项查询结果中的前 10 项结果。

不过，如果您在Google Web 站点上试验相同的查询，可能会获得不同的结果。例如，在Google上针对“Lotus Domino”的相同查询将产生估计的 596,000 项结果。（Google API 支持团队已证实，该 Web API 和 Google 站点本身使用相同的搜索引擎和索引页面，搜索结果方面的细微差别可能是由 Google 所维护的许多数据中心造成的。）

快速浏览一下 Googleapi 目录中的 GoogleAPIDemo.java：

清单 2. 摘自 GoogleAPIDemo.java 的代码片断

...
GoogleSearch s = new GoogleSearch（）;
...
GoogleSearchResult r = s.doSearch（）;
...

您可以发现 doSearch（）方法在设置许可密钥和搜索字符串属性之后调用了 Google 搜索。