本页面介绍了如何使用或修改 Google 可视化 Java 库,以及如何为该项目的开放源代码贡献代码。
内容
要求
您必须具有以下组件才能使用 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 库具有以下依赖项。该库已针对列出的版本进行了测试;其他版本也许可以接受,但尚未经过测试。
源代码或下载内容中包含以下内容:
- icu4j 4.0.1 版。
- Jakarta commons lang 版本 2.4。
- Jakarta Commons 日志记录版本 1.1.1。
- Google 集合库 1.0 版。
- javacc 4.2 版。仅在您打算编译库时(例如在按下文所述修改库时),才需要执行此操作。
- opencsv 1.8 版。仅当您打算使用 CSV 数据源时,才需要执行此操作。
不包含在来源或下载内容中:
- 如需将
SqlDataSourceHelper
类与 mySQL 数据库配合使用,您还需要在运行时环境中使用mysql.jar
。如需了解详情和可下载的版本,请参阅:http://www.mysql.com/products/connector/j/。
按原样使用库
本部分介绍如何使用可视化 Java 库(如果您不需要对其进行修改)。此过程因构建系统而异:
如果使用的是 Maven,请在可视化库中设定以下依赖项:
- 组 ID:com.google.visualization
- 工件 ID:visualization-datasource
- 版本号:使用项目页面上列出的最新版本。
如果使用任何其他构建系统:
- 从项目页面下载库 ZIP 文件,然后解压缩文件,并按照构建系统的要求将其添加到项目中。
运行示例
JAR 示例文件与库 JAR 一起包含在可下载的 ZIP 文件中。如需了解如何运行示例,请参阅使用入门页面。
修改库
如果要修改库代码,则必须从开源托管网站下载源代码并构建它。在此之前,请阅读项目页面上“代码许可”部分所链接的许可信息,以了解您的用例是否允许。
以下是下载和构建该库的步骤:
- 使用 SVN 下载源代码,如开源项目页面上的源代码 > 结账标签页上所述。
- 构建代码。如果使用 Maven 进行构建,请使用源代码随附的 pom.xml 文件。如果使用 Apache Ant 进行构建,请按照接下来提供的说明操作(请注意,该代码已使用 Ant 1.7.0 版本进行测试;如果您使用的是 Ant 较低版本,则可能需要升级)
蚂蚁构建说明
1. 修改 build 属性:
- 转到所选安装目录的
build-src
子目录。 - 使用文本编辑器打开
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,请求权限以及如何提交更改说明。