分类： Oracle
2008-04-23 17:33:34
JFreeChart 可从 下载。单个下载文件包含几个用于 JFreeChart 的 JAR 文件。将下载的文件解压缩到所选目录下后，任何使用 JFreeChart 的应用程序的类路径至少需要指向 jfreechart-1.0.5.jar 和 jcommon-1.0.9.jar 文件。可以通过将这些 JAR 文件添加到您喜欢的 IDE 的项目中来处理此问题。为了在 IDE 的外部构建和运行，Java SE 6 允许在类路径中使用通配符指定 JAR，因此 JFreeChart 库目录中的 JAR 都可以包括在类路径中的一个 *.jar 表达式中。除了解压缩分发文件并将您的应用程序的类路径指向相应的 JFreeChart JAR 文件之外，不需要任何重要的安装工作。
图 4 显示了构建和运行本文中的大多数代码示例所需的相关 JAR 文件。列出了前面提到的两个 JFreeChart JAR，以及 iText（用于生成 PDF）、Batik（用于生成 SVG）和 Oracle JDBC（用于对 Oracle 数据库进行 Java 访问）的 JAR。即使您没使用 JDeveloper，图 4 还是会在一个单独的位置显示您将需要置于类路径中以构建和运行本文中讨论的大多数工具的相关性。
| 图4：要添加到JDeveloper项目（或类路径中的其他位置）的JAR |
生成 JFreeChart Javadoc API 文档
JFreeChart 压缩的分发文件还包括一个 build.xml 文件，该文件对于生成基于 JFreeChart Javadoc 的文档尤为有用。要生成 JFreeChart 文档，请在提供的 Ant build.xml 文件上运行“javadoc”目标（在“ant”子目录中运行“ant javadoc”）。假定您已经安装了 Ant，该将在 JFreeChart 文件的解压缩目录中生成一个“javadoc”子目录，并将生成的 Javadoc 文件放在该目录中。JFreeChart Web 站点也在线提供 JFreeChart 的 Javadoc 文档。
JFreeChart 附带了许多程序包、类和接口，但您只需了解其中很少一部分就可以开始使用 JFreeChart。本节简要介绍一些主要的类和接口，它们是使用 JFreeChart 的基础并将在本文的示例中使用。
JFreeChart 库中最重要的类之一是它本身，名为 JFreeChart。该类提供一种 Java 二维图表的表示。利用该类上的方法，开发人员可以控制生成的图表的各个方面，并可以创建表示图表的抽象窗口工具包 (AWT) BufferedImage。您只需非常少的额外工作即可直接使用 JFreeChart 创建几种简单的图表类型，但 JFreeChart 却可以提供对代表（如允许对所生成的图表进行更多控制的 Plot）的访问。
ChartFactory 类用于创建不同类型的图表。该类的每种静态方法都根据其生成的图表类型命名，无论调用何种类型的图表，每种方法都返回一个通用的 JFreeChart 类实例。扫描该类的 Javadoc 文档可以加深了解，也是确定 JFreeChart 提供的现成的基本图表类型的最简单方法之一。
与 ChartFactory 类相似，ChartUtilities 类也具有大量静态方法。该类提供的大多数方法都可以将图表转换为一种图像格式或基本的 HTML 图像映射。
检查 ChartFactory 图表创建方法表明这些方法中的每一种都接受某种类型的数据集扩展的接口（注意类名称中的数据集）作为参数。针对数据集接口生成的 Javadoc 文档显示了它是由几个子接口扩展的，由更多具体类实现的。
用于各种类型图表的数据集子接口通常是显而易见的，因为图表类型的名称通常出现在接口名称中。例如，PieDataset 用于饼形图，XYDataset 用于许多 x,y 类型图表。CategoryDataset 用于直线图和面积图，其他扩展数据集接口的子接口用于其他图表类型。
数据集子接口是为要在图表中表示的 ChartFactory 类提供数据的机制。创建适当数据集子接口的具体实现，对其进行填充并传递到 ChartFactory 的xiangy create***Chart 方法，其中 *** 是相关的图表类型。
不要将 JFreeChart 提供的数据集接口与 JDBC 4 提供的数据集接口混淆。JFreeChart 提供的数据集接口无需从数据库填充，也不必以任何方式与数据库相关。相反，JFreeChart 数据集接口及其子接口是为使用数据填充 JFreeChart 图表而设计的。
