安装数据源 Java 库

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

目录

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

要求

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

  • 一个 WebView 容器以及 2.4 版或更高版本的 Servlet API。Apache Tomcat 是最常用的 servlet 容器之一，其中包括 Servlet API。请访问 http://tomcat.apache.org/download-55.cgi 下载 5.5 版本的二进制文件。您只需安装核心模块。您还需要 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，则可能需要升级）

Ant 构建说明

1. 修改 build 属性：

  1. 进入所选安装目录的 build-src 子目录。
  2. 使用文本编辑器打开 build.properties 文件并进行以下更改：
    • 修改 servlet-api.jar 属性，使其指向您的 servlet-api.jar 文件。例如，如果您将 Tomcat 安装到了 c: 驱动器的 tomcat_home 目录中，则可以按如下方式指定 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，请求相应权限及有关如何提交更改的说明。