2008 年 4 月
全新 Google Data API Java 客户端 Eclipse 插件:只需几秒钟即可创建项目
作为本文的补充,您可以借助 Eclipse 插件最大限度地减少设置 Google 数据依赖项所涉及的开销。此外,它还会创建样板代码,以与您感兴趣的 API 进行交互。这样,您就可以轻松开始使用 Google Data API 进行开发了。
简介
Eclipse 非常方便(而且完全免费!)在许多 Java 程序员心目中都有着独特的地位。因此,您可能想将它与 Java 客户端库配合使用以构建与其中一个 Google 数据 API 配合使用的杀手级 Java 应用,这一点不足为奇。
设置 Eclipse
如果您尚未安装 Eclipse,那么您会错失机会。Eclipse 可提供建议修复、查找缺失的导入和自动补全方法,因此可以大大简化 Java 开发。访问 Eclipse.org 下载页面,获取适用于您的操作系统的安装程序。要运行 Eclipse,必须安装 JRE,您可以从 Eclipse 下载页面链接到该 JRE。安装 Eclipse 之后,您需要创建一个工作区。这些示例使用 /usr/local/eclipse/workspace
。
安装所需的库
Eclipse 提供了许多开箱即用的 Java 功能,因此应该非常简单。首先,从项目下载页面中获取最新版本的 Java 客户端库。请注意,这里有两个单独的下载内容:一个用于示例,另一个用于源代码。下载示例 ZIP 文件,其中包含您创建自己的程序所需的 Java 客户端库的已编译 JAR 文件。如果您想了解客户端库本身的工作原理,可以下载源代码 zip 进行查看,但这超出了本文讨论的范围。下载示例 ZIP 文件后,请将该文件解压缩到一个方便的目录,以便您找到这些文件。这些示例使用的是 /usr/local/eclipse
。这意味着,该项目的 JAR 文件现在应该可以在 /usr/local/eclipse/gdata/java/lib
下访问。
现在您已安装客户端库,接下来要做的是下载一些外部依赖项,以便我们将其包含在项目构建路径中。INSTALL-samples.txt
文件包含您需要的 jar 列表以及下载它们的位置。当前列表为:
文件名 | 位置 |
---|---|
mail.jar | Sun 的 JavaMail API |
激活.jar | Sun 的 JavaBeans 激活框架 |
servlet-api.jar 中 | Apache Tomcat |
在此示例中,下载了这些 JAR 文件并将其复制到 /usr/local/eclipse/gdata/third_party
。
哇!现在,您应该已经掌握开始开发使用某一 Google 数据 API 的 Java 应用所需的全部信息。请继续阅读!
创建新应用
第一步是打开 Eclipse,从“File”菜单中选择“New > Java Project”。
![Eclipse 新项目窗口](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata1.png?authuser=0000&hl=bg)
现在点击“下一步”,然后选择“库”标签页。通过点击“Add External JAR”(添加外部 JAR),添加您下载的所有相关 JAR 文件。
![添加依赖项 JAR](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata2.png?authuser=0000&hl=bg)
您还需要从 Java 客户端库添加 JAR 文件。这些文件位于您提取客户端库的 java/lib
子目录中。您必须包含以下 JAR 文件:SPAN-client、SPAN-client-meta、SPAN-core 和 SPAN-media。
![添加 GData JAR](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata3.png?authuser=0000&hl=bg)
现在,选择您要使用的 API。本示例使用 Google 文档列表 API。这需要添加适当的 JAR 文件:SPAN-docs 和 SPAN-docs-meta。
![添加 DocList JAR](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata4.png?authuser=0000&hl=bg)
最后,您可以点击“Finish”(完成)并创建新项目。
![新创建的项目](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata5.png?authuser=0000&hl=bg)
如需创建简单的测试应用,请从“File”菜单中选择“New > Class”,并使用主方法创建新类。
![创建类](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata6.png?authuser=0000&hl=bg)
现在,我将粘贴适用于 Documents List API 的开发者指南中的一些代码。
![出错的示例代码](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata7.png?authuser=0000&hl=bg)
在添加适当的 import 语句之前,您将看到大量错误。Eclipse 让操作变得简单,您只需点击左侧的错误标记,即可获取有助于添加导入内容的实用菜单。
![快速修复菜单](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata8.png?authuser=0000&hl=bg)
清除这些导入之后,您还必须处理我们的代码可能会引发的异常。该示例使用非常基本的异常处理程序将整个示例代码括起来。
![有效的示例代码](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata9.png?authuser=0000&hl=bg)
现在,假设您将用户名和密码替换为您创建的有效测试帐号,那么从“Run”菜单中选择“Run”后,您应该会看到该测试帐号拥有的文档列表。
![程序输出](https://developers.google.cn/static/gdata/articles/support/eclipse_gdata/eclipse_gdata10.png?authuser=0000&hl=bg)
太棒了!
总结
现在,您已经拥有一个可正常运行的 Eclipse 实例和所有必需的 JAR 文件,可以开始构建一个使用其中一个 Google 数据 API 的超棒 Java 应用程序。
接下来该怎么做?以下几项链接可能会对您有所帮助:
- Google 数据 API Java 客户端 Eclipse 插件
- code.google.com 上的 Google 数据协议文档
- Google 数据 Java 客户端库项目
- Java 客户端库入门指南
- JavaDoc 文档
Java 是 Sun Microsystems, Inc. 在美国和其他国家/地区的商标。