安装数据源 Java 库

本页面介绍了如何使用或修改 Google 可视化 Java 库，以及如何为该项目的开放源代码贡献代码。

内容

  1. 使用要求
  2. 依赖项
  3. 按原样使用库
  4. 运行示例
  5. 修改库
  6. 为开源项目做贡献

要求

您必须具有以下组件才能使用 Google 可视化 Java 库：

  • servlet 容器和 Servlet API 2.4 或更高版本。Apache Tomcat 是最常用的 servlet 容器之一，它包含 Servlet API。如需下载版本 5.5 的二进制文件，请参阅 http://tomcat.mozilla.org/download-55.cgi。您只需安装 Core 模块。 您还需要使用 Tomcat 完成教程部分：使用入门、使用外部数据存储以及定义功能和事件流。
  • Java 开发套件版本 6.0 或更高版本。

    注意：您也可以使用 JDK 5.0 版。不过，您必须从库中替换接口方法的每个方法中移除 @Override。这是因 JDK 6.0 版中的 @Override 注解行为发生变化所致。

依赖项

数据源 Java 库具有以下依赖项。该库已针对列出的版本进行了测试；其他版本也许可以接受，但尚未经过测试。

源代码或下载内容中包含以下内容：

不包含在来源或下载内容中：

  • 如需将 SqlDataSourceHelper 类与 mySQL 数据库配合使用，您还需要在运行时环境中使用 mysql.jar。如需了解详情和可下载的版本，请参阅：http://www.mysql.com/products/connector/j/。

按原样使用库

本部分介绍如何使用可视化 Java 库（如果您不需要对其进行修改）。此过程因构建系统而异：

如果使用的是 Maven，请在可视化库中设定以下依赖项：

  • 组 ID：com.google.visualization
  • 工件 ID：visualization-datasource
  • 版本号：使用项目页面上列出的最新版本。

如果使用任何其他构建系统：

  • 从项目页面下载库 ZIP 文件，然后解压缩文件，并按照构建系统的要求将其添加到项目中。

运行示例

JAR 示例文件与库 JAR 一起包含在可下载的 ZIP 文件中。如需了解如何运行示例，请参阅使用入门页面。

修改库

如果要修改库代码，则必须从开源托管网站下载源代码并构建它。在此之前，请阅读项目页面上“代码许可”部分所链接的许可信息，以了解您的用例是否允许。

以下是下载和构建该库的步骤：

  1. 使用 SVN 下载源代码，如开源项目页面上的源代码 > 结账标签页上所述。
  2. 构建代码。如果使用 Maven 进行构建，请使用源代码随附的 pom.xml 文件。如果使用 Apache Ant 进行构建，请按照接下来提供的说明操作（请注意，该代码已使用 Ant 1.7.0 版本进行测试；如果您使用的是 Ant 较低版本，则可能需要升级）

蚂蚁构建说明

1. 修改 build 属性：

  1. 转到所选安装目录的 build-src 子目录。
  2. 使用文本编辑器打开 build.properties 文件并进行以下更改：
    • 修改 servlet-api.jar 属性，使其指向您的 servlet-api.jar 文件。例如，如果您将 Tomcat 安装到 tomcat_home 目录中的 c: 盘中，则应按如下方式指定 servlet-api.jar 属性：
      servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar

      注意：在文件路径中使用正斜杠而不是反斜杠，即使使用 Windows 也是如此

    • 如需使用上述依赖项的副本，请修改同一 build.properties 文件中的路径。

2. 构建该库：

浏览文件中的 build-src 子目录，然后输入以下内容之一：

  • ant datasource - 构建数据源库
  • ant example - 构建示例
  • ant - 构建数据源和示例
  • ant test - 构建并运行数据源库测试。 在修改库时非常有用。

为开源项目做贡献

如果您要为开源项目贡献更改，则必须获得该项目的提交权限。请发送电子邮件至 google-visualization-api@googlegroups.com，请求权限以及如何提交更改说明。