2008 年 4 月
新 Google Data API Java 客户端 Eclipse 插件：在几秒钟内创建项目
为了补充本文，我们提供了一个 Eclipse 插件，可最大限度地减少设置 Google 数据依赖项所涉及的开销。它还会创建样板代码，以便与您感兴趣的 API 进行交互。这提供了一种简单的方式来开始使用 Google Data API 进行开发。
简介
Eclipse 是一款非常实用（而且免费！）在许多 Java 程序员心中有着特殊地位的 IDE。因此，您可能希望将它与 Java 客户端库搭配使用，以开发出可与某个 Google Data API 搭配使用的出色 Java 应用，这也就不足为奇了。
设置 Eclipse
如果您尚未安装 Eclipse，那真是太可惜了。Eclipse 能够建议修复、查找缺失的导入和自动补全方法，因此可以大大简化 Java 开发。前往 Eclipse.org 下载页面，获取适用于您操作系统的安装程序。如需运行 Eclipse，您必须安装 JRE，该 JRE 可从 Eclipse 下载页面中找到。安装 Eclipse 后，您需要创建一个工作区。这些示例使用 /usr/local/eclipse/workspace。
安装必需的库
Eclipse 提供了许多开箱即用的 Java 功能，因此这应该很容易。首先，从项目下载页面获取最新版本的 Java 客户端库。请注意，下载内容分为两部分：一部分是示例，另一部分是源代码。下载示例 ZIP 文件，因为其中包含创建您自己的程序所需的 Java 客户端库的已编译 JAR 文件。如果您想了解客户端库本身的工作方式，可以下载源代码 zip 文件并查看，但这不在本文的讨论范围内。下载示例 zip 文件后，将其解压缩到方便您查找文件的目录。这些示例使用 /usr/local/eclipse。这意味着，现在应该可以在 /usr/local/eclipse/gdata/java/lib 下访问项目的 JAR 文件。
现在，您已安装客户端库，接下来需要下载一些外部依赖项，以便将它们包含在项目 build 路径中。INSTALL-samples.txt 文件包含您需要使用的 jar 列表以及下载这些 jar 的位置。最新列表如下：
| 文件名 | 位置 |
|---|---|
| mail.jar | Sun 的 JavaMail API |
| activation.jar | Sun 的 JavaBeans Activation Framework |
| servlet-api.jar | Apache Tomcat |
在此示例中，这些 JAR 文件已下载并复制到 /usr/local/eclipse/gdata/third_party。
呼！现在，您应该已具备开始开发使用某个 Google Data API 的 Java 应用所需的所有条件。继续阅读！
创建新应用
第一步是打开 Eclipse，然后从“File”菜单中选择“New > Java Project”。
现在，点击“下一步”，然后选择“库”标签页。点击“添加外部 JAR”，添加您下载的所有依赖 JAR 文件。
您还需要添加 Java 客户端库中的 JAR 文件。它们位于您提取客户端库的目录的 java/lib 子目录中。您始终必须包含以下 JAR 文件：gdata-client、gdata-client-meta、gdata-core 和 gdata-media。
现在，选择您要使用的 API。此示例使用 Google Documents List API。这需要添加相应的 JAR 文件：gdata-docs 和 gdata-docs-meta。
最后，您可以点击“完成”并创建新项目。
如需制作一个简单的测试应用，请从“文件”菜单中选择“新建 > 类”，以创建一个包含 main 方法的新类。
现在，我将粘贴一些来自 Documents List API 开发者指南的代码。
在添加相应的 import 语句之前，您会看到很多错误。在 Eclipse 中，您可以轻松完成此操作，只需点击左侧的错误标记，即可获得一个实用菜单，让您添加导入。
清理完导入后，您还必须处理代码可能抛出的异常。此示例选择使用非常基本的异常处理程序来封装整个示例代码。
现在，假设您将用户名和密码替换为您创建的有效测试账号，当您从“运行”菜单中选择“运行”时，应该能够看到该测试账号所拥有的文档列表。
太棒了！
总结
现在，您已经拥有一个可正常运行的 Eclipse 实例，并且所有必需的 JAR 文件都已就位，您很快就能构建出一个出色的 Java 应用，该应用可与某个 Google Data API 搭配使用。
接下来该怎么做？以下是一些可能对您有用的链接：
- Google Data API Java 客户端 Eclipse 插件
- code.google.com 上的 Google Data 协议文档
- Google Data Java 客户端库项目
- Java 客户端库使用入门指南
- JavaDoc 文档
Java 是 Sun Microsystems, Inc. 在美国和其他国家/地区的商标。