安装数据源 Java 库

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

目录

要求

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

依赖项

数据源 Java 库具有以下依赖项。该库已使用所列版本进行了测试;其他版本或许也能接受,但尚未经过测试。

来源或下载内容中包含:

来源或下载内容中未包含的内容:

按系统提供的库使用

本部分介绍了在无需修改可视化 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,请求相应权限及有关如何提交更改的说明。