Java数据可视化实战：JFreeChart绘图包详解

本文还有配套的精品资源，点击获取

简介：JFreeChart是一款功能丰富的开源Java图表库，支持创建动态、交互式的2D图表，适用于Swing和JavaFX应用。本文详细介绍了JFreeChart的安装配置、核心图表类型（如折线图、柱状图、饼图、甘特图等）的创建流程，以及图表的自定义、导出和性能优化技巧。通过实践操作，开发者可以掌握如何将复杂数据转化为直观可视化的图表，并有效集成到Java项目中。

1. JFreeChart库简介与优势

JFreeChart 是一个功能强大且广泛使用的 Java 开源图表库，专为满足企业级数据可视化需求而设计。它支持多种图表类型，如折线图、柱状图、饼图、散点图等，能够灵活嵌入到 Swing 应用程序或通过 Java Web 技术输出为图片流。

其核心优势包括良好的跨平台兼容性、丰富的自定义选项以及清晰的 API 设计，使得开发者可以高效构建高交互性的可视化界面。相较于其他图表库如 JFXCharts 或基于 Web 的 ECharts，JFreeChart 更适合在纯 Java 环境中进行深度集成与定制开发，尤其适用于报表系统和桌面应用的数据呈现。

2. JFreeChart依赖配置与安装

2.1 开发环境准备

2.1.1 Java开发环境搭建

在开始使用 JFreeChart 前，首先需要确保 Java 开发环境已经正确搭建。Java 是 JFreeChart 的运行基础，建议使用 Java 1.8 或更高版本。以下是安装 Java 开发工具包（JDK）的基本步骤：

1. 下载 JDK ：访问 Oracle 官方网站或 Adoptium（前身为 AdoptOpenJDK）下载页面，选择适合操作系统的 JDK 版本。
2. 安装 JDK ：按照安装向导提示完成安装流程。
3. 配置环境变量 ：
   - 设置 JAVA_HOME 环境变量，指向 JDK 的安装目录。
   - 将 %JAVA_HOME%\bin 添加到 PATH 环境变量中。
4. 验证安装 ：打开命令行工具，输入以下命令：
   bash java -version javac -version
   若输出版本号，则表示安装成功。

2.1.2 IDE工具选择与配置（如Eclipse、IntelliJ IDEA）

集成开发环境（IDE）可以显著提升开发效率。Eclipse 和 IntelliJ IDEA 是两款流行的 Java IDE。

Eclipse 配置步骤：

1. 下载并安装 Eclipse IDE for Java Developers。
2. 启动 Eclipse，创建一个新的 Java 项目。
3. 右键项目 → Build Path → Configure Build Path。
4. 在 Libraries 标签页中，点击 “Add External JARs” 添加 JFreeChart 的 JAR 文件。

IntelliJ IDEA 配置步骤：

1. 下载并安装 IntelliJ IDEA Community 或 Ultimate 版本。
2. 创建新项目，选择 Java。
3. 进入 File → Project Structure → Libraries。
4. 点击 “+” 号，选择 Java，添加 JFreeChart 的 JAR 文件。

2.2 JFreeChart的依赖管理

2.2.1 Maven项目中引入JFreeChart

使用 Maven 可以更方便地管理项目依赖。JFreeChart 提供了 Maven 中央仓库的坐标，可以轻松将其引入项目中。

Maven 配置步骤：

1. 打开 pom.xml 文件。
2. 在 <dependencies> 节点中添加如下依赖：

<dependency>
    <groupId>org.jfree</groupId>
    <artifactId>jfreechart</artifactId>
    <version>1.5.3</version>
</dependency>

3. 保存文件，Maven 将自动下载并添加 JFreeChart 到项目中。

参数说明 ：
- <groupId> ：组织名称，这里是 org.jfree 。
- <artifactId> ：项目名，这里是 jfreechart 。
- <version> ：版本号，目前推荐使用 1.5.3 。

使用 Maven 的优势：

• 自动下载依赖及其传递依赖。
• 依赖版本统一管理，避免版本冲突。
• 便于构建和部署流程自动化。

2.2.2 手动添加JAR包的方式

对于未使用 Maven 的项目，可以通过手动方式添加 JFreeChart 的 JAR 包。

手动添加步骤：

1. 访问 JFreeChart 官方网站 或 GitHub 镜像下载最新版本的 JAR 文件。
2. 解压下载的 ZIP 文件，找到 jfreechart-1.5.3.jar 。
3. 将该 JAR 文件复制到项目 lib 目录下。
4. 在 IDE 中右键项目 → Build Path → Add External Archives，选择该 JAR 文件。

注意 ：手动添加时还需将 lib 文件夹中的 jcommon-1.0.24.jar 一并添加，否则会报类找不到的异常。

手动方式的适用场景：

• 项目未使用构建工具（如 Maven、Gradle）。
• 网络受限或需离线开发。
• 需要自定义修改 JFreeChart 源码。

2.3 JFreeChart核心包结构解析

2.3.1 org.jfree.chart包的主要类与接口

org.jfree.chart 是 JFreeChart 的核心包，包含用于创建图表的主要类和接口。

核心类与接口说明：

类/接口名	作用
JFreeChart	图表的主类，负责管理图表的整体结构
ChartFactory	提供创建常见图表的工厂方法
Plot	图表的绘图区域，是所有图表类型的基类
CategoryPlot	分类图表的绘图区域，如柱状图、饼图等
XYPlot	XY 坐标图表的绘图区域，如折线图、散点图等
Renderer	数据的绘制方式，控制图形的样式
Axis	坐标轴，分为 CategoryAxis 和 ValueAxis

示例代码：创建一个简单的折线图

import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartPanel;
import org.jfree.chart.JFreeChart;
import org.jfree.data.xy.XYSeries;
import org.jfree.data.xy.XYSeriesCollection;

import javax.swing.*;

public class LineChartExample extends JFrame {
    public LineChartExample(String title) {
        super(title);

        // 创建数据集
        XYSeries series = new XYSeries("数据");
        series.add(1, 1);
        series.add(2, 4);
        series.add(3, 9);
        series.add(4, 16);
        XYSeriesCollection dataset = new XYSeriesCollection(series);

        // 创建折线图
        JFreeChart chart = ChartFactory.createXYLineChart(
                "示例折线图",     // 图表标题
                "X轴",           // X轴标签
                "Y轴",           // Y轴标签
                dataset          // 数据集
        );

        // 设置图表面板
        ChartPanel panel = new ChartPanel(chart);
        panel.setPreferredSize(new java.awt.Dimension(560, 370));
        setContentPane(panel);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            LineChartExample example = new LineChartExample("JFreeChart 折线图示例");
            example.setSize(800, 600);
            example.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            example.setVisible(true);
        });
    }
}

代码分析 ：
1. 使用 XYSeries 构建一组 XY 数据。
2. 使用 XYSeriesCollection 将数据集封装。
3. 通过 ChartFactory.createXYLineChart 创建折线图对象。
4. 使用 ChartPanel 显示图表，并将其设置为 JFrame 的内容面板。

2.3.2 org.jfree.data包的数据模型设计

org.jfree.data 包提供了多种数据模型类，用于支撑不同类型的图表展示需求。

主要数据模型类：

类名	用途
DefaultCategoryDataset	分类数据集，适用于柱状图、饼图等
XYSeriesCollection	XY 坐标数据集，适用于折线图、散点图等
TimeSeriesCollection	时间序列数据集，适用于时间轴图表
DefaultXYZDataset	三维数据集，适用于三维图表

数据模型类之间的关系图（使用 Mermaid 流程图）：

classDiagram
    class Dataset
    class CategoryDataset
    class XYDataset
    class XYZDataset
    class TimeSeriesCollection
    class DefaultCategoryDataset
    class XYSeriesCollection
    class DefaultXYZDataset

    Dataset <|-- CategoryDataset
    Dataset <|-- XYDataset
    Dataset <|-- XYZDataset

    CategoryDataset <|-- DefaultCategoryDataset
    XYDataset <|-- XYSeriesCollection
    XYZDataset <|-- DefaultXYZDataset

    TimeSeriesCollection --|> XYDataset

说明 ：
- Dataset 是所有数据集的顶层接口。
- CategoryDataset 和 XYDataset 是两个主要的子接口。
- TimeSeriesCollection 实现了 XYDataset ，专门用于时间序列数据。
- XYSeriesCollection 是 XY 数据集的常用实现。
- DefaultXYZDataset 支持三维数据，适用于高级图表。

2.4 验证安装与简单示例

2.4.1 编写第一个JFreeChart图表程序

为了验证 JFreeChart 是否成功集成到项目中，我们来编写一个最简单的柱状图程序。

示例代码：创建柱状图

import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartPanel;
import org.jfree.chart.JFreeChart;
import org.jfree.data.category.DefaultCategoryDataset;

import javax.swing.*;

public class BarChartExample extends JFrame {
    public BarChartExample(String title) {
        super(title);

        // 创建分类数据集
        DefaultCategoryDataset dataset = new DefaultCategoryDataset();
        dataset.addValue(1, "类别A", "项目1");
        dataset.addValue(4, "类别A", "项目2");
        dataset.addValue(3, "类别A", "项目3");
        dataset.addValue(5, "类别B", "项目1");
        dataset.addValue(2, "类别B", "项目2");
        dataset.addValue(7, "类别B", "项目3");

        // 创建柱状图
        JFreeChart chart = ChartFactory.createBarChart(
                "示例柱状图",         // 图表标题
                "项目",               // X轴标签
                "数值",               // Y轴标签
                dataset               // 数据集
        );

        // 设置图表面板
        ChartPanel panel = new ChartPanel(chart);
        panel.setPreferredSize(new java.awt.Dimension(560, 370));
        setContentPane(panel);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            BarChartExample example = new BarChartExample("JFreeChart 柱状图示例");
            example.setSize(800, 600);
            example.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            example.setVisible(true);
        });
    }
}

代码逻辑分析 ：
1. 使用 DefaultCategoryDataset 创建一个分类数据集。
2. 通过 ChartFactory.createBarChart 创建柱状图对象。
3. 使用 ChartPanel 显示图表。
4. 通过 JFrame 将图表窗口化展示。

2.4.2 图表显示的基本流程分析

JFreeChart 图表的创建和显示流程可以归纳为以下几个步骤：

1. 准备数据 ：根据图表类型选择合适的数据集类（如 DefaultCategoryDataset ）。
2. 创建图表对象 ：使用 ChartFactory 工厂方法创建 JFreeChart 实例。
3. 配置图表样式 ：可选，包括标题、坐标轴、颜色等。
4. 创建图表面板 ：使用 ChartPanel 承载图表。
5. 显示图表 ：将 ChartPanel 添加到 GUI 容器（如 JFrame ）中并显示。

图表显示流程图（使用 Mermaid 流程图）：

graph TD
    A[准备数据] --> B[创建图表对象]
    B --> C[配置图表样式]
    C --> D[创建图表面板]
    D --> E[显示图表]

流程说明 ：
- 从数据准备开始，逐步构建图表对象。
- 配置样式可以增强图表的可读性和美观性。
- 最后通过 GUI 组件展示给用户。

本章详细介绍了 JFreeChart 的依赖配置与安装过程，包括 Java 环境搭建、IDE 配置、Maven 与手动添加 JAR 包的方式，以及核心包结构与简单示例的实现。通过本章内容，开发者应能顺利将 JFreeChart 集成到 Java 项目中，并完成第一个图表程序的编写。

3. 数据准备与数据集类型

3.1 图表数据的重要性

数据驱动图表设计的核心理念

在数据可视化领域，图表的构建并非单纯依赖于图形库的渲染能力，更重要的是背后的数据结构和数据内容。JFreeChart 的设计理念强调数据驱动（Data-Driven Design），即图表的生成和表现形式应当由数据本身决定。这种理念要求开发者在设计图表前，必须先理解数据的结构、维度和分布特征。

JFreeChart 通过一系列数据集接口（如 CategoryDataset 、 TimeSeriesCollection 、 XYDataset ）抽象出数据的组织方式，使得图表可以灵活地适应不同的数据输入。数据驱动的设计不仅提升了代码的可维护性，也增强了图表的扩展性，使得在不同场景下复用图表逻辑成为可能。

常见数据来源与预处理方式

在实际项目中，图表数据可能来源于数据库、文件系统（如 CSV、Excel）、API 接口（如 RESTful 服务）或实时采集的传感器数据。无论数据来源如何，都需要进行预处理以适配 JFreeChart 所支持的数据集格式。

例如，从数据库中查询出的原始数据可能是一个包含时间戳和数值的二维表，开发者需要将其转换为 TimeSeriesCollection 数据集。如果数据中存在缺失值或异常值，还需要进行清洗处理，以避免图表渲染时出现错误。

数据预处理通常包括以下几个步骤：

1. 数据清洗 ：去除无效值、处理空值。
2. 数据格式转换 ：将原始数据转换为 JFreeChart 可识别的数据结构。
3. 数据聚合 ：对原始数据进行分组、求和、平均等处理。
4. 数据标准化 ：统一单位、归一化数值，便于图表比较。

通过这些预处理步骤，可以确保数据集的质量，从而提升图表的准确性和可读性。

3.2 JFreeChart 支持的数据集类型

3.2.1 CategoryDataset：分类数据集的构建与使用

CategoryDataset 是 JFreeChart 中用于表示分类数据的核心接口之一，广泛应用于柱状图、饼图等图表类型。它本质上是一个二维的数据表，行表示不同的数据系列（Series），列表示不同的分类（Category）。

下面是一个使用 DefaultCategoryDataset 构建分类数据集的示例：

import org.jfree.data.category.DefaultCategoryDataset;

public class CategoryDataExample {
    public static void main(String[] args) {
        DefaultCategoryDataset dataset = new DefaultCategoryDataset();

        // 添加数据：行键（系列）、列键（分类）、值
        dataset.addValue(150, "Sales", "Q1");
        dataset.addValue(200, "Sales", "Q2");
        dataset.addValue(250, "Sales", "Q3");
        dataset.addValue(300, "Sales", "Q4");

        dataset.addValue(100, "Expenses", "Q1");
        dataset.addValue(120, "Expenses", "Q2");
        dataset.addValue(140, "Expenses", "Q3");
        dataset.addValue(160, "Expenses", "Q4");

        // 输出数据集内容
        System.out.println(dataset);
    }
}

代码逻辑分析：

• 第 5 行：创建 DefaultCategoryDataset 实例，这是 CategoryDataset 的一个常用实现类。
• 第 8-15 行：使用 addValue() 方法添加数据。参数依次为：值、系列名、分类名。
• 第 18 行：输出数据集内容，用于调试。

参数说明：
- addValue(double value, Comparable rowKey, Comparable columnKey) ：
- value ：要添加的数值；
- rowKey ：表示数据系列的标识，通常用于图例；
- columnKey ：表示分类名称，用于 X 轴或图例分类。

数据结构图（Mermaid）：

graph TD
    A[CategoryDataset] --> B[DefaultCategoryDataset]
    B --> C{二维数据结构}
    C --> D[行键: Series]
    C --> E[列键: Category]
    D --> F[Sales]
    D --> G[Expenses]
    E --> H[Q1]
    E --> I[Q2]
    E --> J[Q3]
    E --> K[Q4]

3.2.2 TimeSeriesCollection：时间序列数据的组织方式

当需要展示随时间变化的趋势数据时， TimeSeriesCollection 是 JFreeChart 提供的时间序列数据集实现。它通常用于折线图、面积图等时间序列图表。

下面是一个创建时间序列数据集的示例：

import org.jfree.data.time.Day;
import org.jfree.data.time.TimeSeries;
import org.jfree.data.time.TimeSeriesCollection;

import java.util.Calendar;
import java.util.Date;

public class TimeSeriesExample {
    public static void main(String[] args) {
        // 创建时间序列
        TimeSeries series = new TimeSeries("Daily Sales", Day.class);

        // 添加数据
        Calendar calendar = Calendar.getInstance();
        for (int i = 0; i < 7; i++) {
            calendar.add(Calendar.DAY_OF_YEAR, 1);
            Date date = calendar.getTime();
            double value = Math.random() * 100; // 模拟销售数据
            series.add(new Day(date), value);
        }

        // 创建数据集并添加序列
        TimeSeriesCollection dataset = new TimeSeriesCollection();
        dataset.addSeries(series);

        // 输出数据集内容
        System.out.println(dataset);
    }
}

代码逻辑分析：

• 第 8 行：创建 TimeSeries 对象，指定名称和时间粒度（这里是按天）。
• 第 11-16 行：使用 Calendar 模拟一周的数据，生成随机数值，并添加到时间序列中。
• 第 19 行：创建 TimeSeriesCollection 数据集，并将时间序列加入其中。
• 第 22 行：输出数据集内容，用于调试。

参数说明：
- TimeSeries(String name, Class<? extends RegularTimePeriod> timePeriodClass) ：
- name ：时间序列名称，用于图例；
- timePeriodClass ：时间单位类，如 Day.class 、 Month.class 等。
- add(RegularTimePeriod period, double value) ：
- period ：时间点对象；
- value ：该时间点的数值。

数据结构表格：

时间点	销售额（示例）
2025-04-01	67.3
2025-04-02	45.8
2025-04-03	82.1
2025-04-04	33.9
2025-04-05	91.5
2025-04-06	54.2
2025-04-07	76.4

3.3 自定义数据集的实现

3.3.1 实现 XYDataset 接口创建自定义数据结构

对于更复杂的图表类型（如散点图、气泡图），JFreeChart 提供了 XYDataset 接口来支持二维坐标数据。如果标准的数据集实现无法满足需求，开发者可以通过实现 XYDataset 接口来自定义数据结构。

下面是一个自定义 XY 数据集的示例：

import org.jfree.data.xy.XYDataset;
import org.jfree.data.general.DatasetChangeListener;
import org.jfree.data.general.DatasetChangeEvent;

import java.util.ArrayList;
import java.util.List;

public class CustomXYDataset implements XYDataset {

    private List<Series> seriesList = new ArrayList<>();

    public void addSeries(String name, List<XYPoint> points) {
        seriesList.add(new Series(name, points));
    }

    @Override
    public int getSeriesCount() {
        return seriesList.size();
    }

    @Override
    public Comparable<?> getSeriesKey(int series) {
        return seriesList.get(series).name;
    }

    @Override
    public int getItemCount(int series) {
        return seriesList.get(series).points.size();
    }

    @Override
    public double getXValue(int series, int item) {
        return seriesList.get(series).points.get(item).x;
    }

    @Override
    public double getYValue(int series, int item) {
        return seriesList.get(series).points.get(item).y;
    }

    // 以下为未实现的接口方法（简化示例）
    @Override public void addChangeListener(DatasetChangeListener listener) {}
    @Override public void removeChangeListener(DatasetChangeListener listener) {}
    @Override public boolean equals(Object obj) { return false; }
    @Override public int hashCode() { return 0; }

    private static class XYPoint {
        double x, y;
        XYPoint(double x, double y) {
            this.x = x;
            this.y = y;
        }
    }

    private static class Series {
        String name;
        List<XYPoint> points;

        Series(String name, List<XYPoint> points) {
            this.name = name;
            this.points = points;
        }
    }
}

代码逻辑分析：

• 第 9 行：定义 CustomXYDataset 类并实现 XYDataset 接口。
• 第 12 行：定义 seriesList 存储多个数据系列。
• 第 14-16 行：提供 addSeries() 方法，允许添加自定义数据系列。
• 第 18-30 行：实现 XYDataset 接口的关键方法，包括获取系列数、系列名、数据点数量、X/Y 值等。
• 第 46 行：定义 XYPoint 内部类表示一个点。
• 第 51 行：定义 Series 内部类表示一个数据系列。

参数说明：
- getSeriesCount() ：返回数据集中包含的系列总数。
- getSeriesKey(int series) ：返回指定索引处的系列名称。
- getItemCount(int series) ：返回该系列的数据点数量。
- getXValue(int series, int item) ：获取指定系列和数据点的 X 值。
- getYValue(int series, int item) ：获取指定系列和数据点的 Y 值。

3.3.2 使用 DefaultXYZDataset 处理三维数据

除了二维数据，JFreeChart 还支持三维数据的展示，例如气泡图、三维柱状图等。 DefaultXYZDataset 是专门用于处理三维数据（X、Y、Z）的类。

示例代码如下：

import org.jfree.data.xy.DefaultXYZDataset;

public class XYZDataExample {
    public static void main(String[] args) {
        DefaultXYZDataset dataset = new DefaultXYZDataset();

        // 准备三维数据
        double[][] seriesData = {
            {1.0, 2.0, 3.0}, // X, Y, Z
            {2.0, 4.0, 5.0},
            {3.0, 6.0, 7.0}
        };

        dataset.addSeries("Series1", seriesData);

        // 输出数据
        System.out.println("Series Count: " + dataset.getSeriesCount());
        System.out.println("Item Count: " + dataset.getItemCount(0));
    }
}

代码逻辑分析：

• 第 5 行：创建 DefaultXYZDataset 实例。
• 第 8-11 行：定义一个二维数组表示三维数据，每一行代表一个数据点的 X、Y、Z 值。
• 第 13 行：调用 addSeries() 添加数据系列。
• 第 16-17 行：输出系列数和数据点数。

参数说明：
- addSeries(Comparable key, double[][] data) ：
- key ：系列名称；
- data ：三维数据数组，每个子数组表示一个点的 X、Y、Z 值。

3.4 数据与图表绑定的机制

3.4.1 如何将数据集绑定到图表对象

JFreeChart 的图表对象（如 JFreeChart ）与数据集之间是通过 Plot 对象进行绑定的。不同的图表类型对应不同的 Plot 实现类，例如：

• CategoryPlot 用于柱状图、饼图；
• XYPlot 用于折线图、散点图；
• PiePlot 用于饼图。

绑定过程通常如下：

1. 创建数据集（如 DefaultCategoryDataset ）；
2. 创建对应的 Plot 对象；
3. 将数据集设置到 Plot ；
4. 将 Plot 添加到 JFreeChart 对象中。

示例代码如下：

import org.jfree.chart.ChartFactory;
import org.jfree.chart.JFreeChart;
import org.jfree.data.category.DefaultCategoryDataset;

public class ChartBindingExample {
    public static void main(String[] args) {
        // 步骤1：创建数据集
        DefaultCategoryDataset dataset = new DefaultCategoryDataset();
        dataset.addValue(100, "A", "Category1");
        dataset.addValue(200, "A", "Category2");

        // 步骤2：创建图表（内部自动创建 Plot 并绑定数据集）
        JFreeChart chart = ChartFactory.createBarChart(
            "Sample Bar Chart",   // 图表标题
            "Category",           // X 轴标签
            "Value",              // Y 轴标签
            dataset               // 数据集
        );

        // 步骤3：获取 Plot 并可进一步配置
        CategoryPlot plot = (CategoryPlot) chart.getPlot();
        plot.setDomainGridlinesVisible(true);
        plot.setRangeGridlinesVisible(true);
    }
}

代码逻辑分析：

• 第 10 行：创建 DefaultCategoryDataset 并添加数据；
• 第 14 行：使用 ChartFactory 创建柱状图，内部自动绑定数据集；
• 第 18 行：获取 Plot 对象并设置网格线可见。

3.4.2 数据更新与图表刷新的同步机制

在动态数据展示场景中，数据集可能会频繁更新，JFreeChart 提供了事件监听机制来保证图表与数据的同步。

具体机制如下：

1. 数据集实现 Dataset 接口并支持注册监听器；
2. 图表的 Plot 注册监听器以监听数据变化；
3. 当数据集发生变更时，触发 DatasetChangeEvent ；
4. 图表接收到事件后重新渲染。

开发者可以通过以下方式手动触发数据更新：

dataset.fireDatasetChanged(); // 手动通知图表数据已更新

该方法会触发所有监听器，包括图表的 Plot ，从而强制图表刷新。

本章从数据驱动设计理念出发，详细介绍了 JFreeChart 支持的常见数据集类型及其使用方式，并展示了如何实现自定义数据结构，以及数据集与图表之间的绑定机制。这些内容为后续章节中图表的构建与交互实现打下了坚实基础。

4. 折线图设计与实现

折线图是一种用于展示数据变化趋势的图表类型，广泛应用于金融分析、业务趋势监控、时间序列数据可视化等多个领域。JFreeChart 提供了丰富的 API 来支持折线图的创建、样式定制与交互功能实现。本章将从折线图的基本构成开始，逐步深入讲解如何使用 JFreeChart 创建和定制折线图，并探讨其在实际业务中的典型应用场景。

4.1 折线图的基本构成

4.1.1 横纵坐标轴的设置

折线图的核心结构由 X 轴（横轴）和 Y 轴（纵轴）组成，用于表示数据点的两个维度。在 JFreeChart 中，可以通过 XYPlot 对象获取并设置坐标轴。

JFreeChart chart = ChartFactory.createXYLineChart(
    "示例折线图",       // 图表标题
    "X 轴",             // X 轴标签
    "Y 轴",             // Y 轴标签
    dataset            // 数据集
);

XYPlot plot = chart.getXYPlot();

// 设置 X 轴
ValueAxis xAxis = new NumberAxis("X 轴");
xAxis.setRange(0, 10);  // 设置 X 轴范围
plot.setDomainAxis(xAxis);

// 设置 Y 轴
ValueAxis yAxis = new NumberAxis("Y 轴");
yAxis.setRange(0, 100); // 设置 Y 轴范围
plot.setRangeAxis(yAxis);

代码解析：

• ChartFactory.createXYLineChart() ：创建一个 XY 折线图。
• chart.getXYPlot() ：获取图表的 XYPlot 对象，用于进一步配置坐标轴。
• NumberAxis ：用于表示数值型坐标轴，支持设置标签、范围等。
• setRange() ：设置坐标轴的显示范围。

参数说明：
- dataset ：必须是 XYDataset 类型的数据集，通常使用 XYSeriesCollection 。
- xAxis 和 yAxis 可以自定义为其他类型，如 DateAxis （日期轴）、 LogAxis （对数轴）等。

4.1.2 数据点与连接线的样式控制

JFreeChart 提供了 XYLineAndShapeRenderer 类来控制折线图中数据点和连接线的样式。通过该类，可以设置线条颜色、粗细、数据点形状、填充样式等。

XYLineAndShapeRenderer renderer = new XYLineAndShapeRenderer();

// 设置线条是否可见
renderer.setSeriesLinesVisible(0, true);

// 设置线条颜色
renderer.setSeriesPaint(0, Color.BLUE);

// 设置线条粗细
renderer.setSeriesStroke(0, new BasicStroke(2.0f));

// 设置数据点形状
renderer.setSeriesShape(0, new Ellipse2D.Double(-3, -3, 6, 6));

// 设置数据点是否填充
renderer.setSeriesFillPaint(0, Color.RED);

plot.setRenderer(renderer);

代码解析：

• setSeriesLinesVisible() ：控制是否显示连接线。
• setSeriesPaint() ：设置线条颜色。
• setSeriesStroke() ：设置线条粗细，使用 BasicStroke 类。
• setSeriesShape() ：设置数据点的形状，支持 Shape 接口的实现类。
• setSeriesFillPaint() ：设置数据点的填充颜色。

参数说明：
- 参数 0 表示第一个数据系列，适用于多系列图表。
- 可以通过 setSeriesShapesFilled() 控制是否填充数据点。

4.2 使用JFreeChart绘制折线图

4.2.1 创建XYLineAndShapeRenderer渲染器

在 JFreeChart 中， XYLineAndShapeRenderer 是用于 XY 折线图的主要渲染器。它可以分别控制线条、形状、颜色等属性。

XYLineAndShapeRenderer renderer = new XYLineAndShapeRenderer();

// 设置线条样式
renderer.setSeriesLinesVisible(0, true);
renderer.setSeriesStroke(0, new BasicStroke(2.0f));

// 设置数据点样式
renderer.setSeriesShapesVisible(0, true);
renderer.setSeriesShape(0, new Rectangle2D.Double(-4, -4, 8, 8));
renderer.setSeriesFillPaint(0, Color.GREEN);

plot.setRenderer(renderer);

代码逻辑分析：

• setSeriesLinesVisible(0, true) ：启用第一个系列的线条。
• setSeriesStroke() ：设置线条粗细。
• setSeriesShapesVisible() ：启用数据点形状。
• setSeriesShape() ：设置数据点形状为矩形。
• setSeriesFillPaint() ：设置数据点填充颜色为绿色。

扩展建议：
- 可以通过 setBasePaint() 设置所有系列的默认颜色。
- 使用 setDrawOutlines(true) 可以绘制数据点的边框。

4.2.2 设置折线图的颜色、形状与标签

除了线条和数据点的样式外，还可以通过 XYItemRenderer 设置数据点标签的显示。

XYItemRenderer renderer = plot.getRenderer();

// 显示数据点标签
renderer.setBaseItemLabelsVisible(true);

// 设置标签生成器
renderer.setBaseItemLabelGenerator(new StandardXYItemLabelGenerator());

// 设置标签位置（在数据点上方）
renderer.setBasePositiveItemLabelPosition(new ItemLabelPosition(ItemLabelAnchor.OUTSIDE12, TextAnchor.BOTTOM_CENTER));

代码逻辑分析：

• setBaseItemLabelsVisible(true) ：启用所有系列的数据点标签。
• setBaseItemLabelGenerator() ：设置标签生成器，通常使用 StandardXYItemLabelGenerator 。
• setBasePositiveItemLabelPosition() ：设置标签显示位置，支持多个锚点位置。

参数说明：
- ItemLabelAnchor ：标签锚点位置，如 OUTSIDE12 表示上方。
- TextAnchor ：标签文本对齐方式，如 BOTTOM_CENTER 。

4.3 折线图的交互与美化

4.3.1 添加工具提示与点击事件

JFreeChart 支持为图表添加鼠标悬停提示和点击事件监听器，提升用户体验。

// 启用工具提示
chartPanel.setToolTipText("折线图");

// 添加鼠标监听器
chartPanel.addMouseListener(new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e) {
        // 获取点击位置的坐标
        Point2D point = chartPanel.translateScreenToJava2D(e.getPoint());
        XYPlot plot = (XYPlot) chart.getPlot();
        XYDataset dataset = plot.getDataset();
        int seriesIndex = 0;

        // 获取最接近点击点的数据项
        double x = plot.getDomainAxis().java2DToValue(point.getX(), chartPanel.getChartRenderingInfo().getPlotInfo(), RectangleEdge.BOTTOM);
        double y = plot.getRangeAxis().java2DToValue(point.getY(), chartPanel.getChartRenderingInfo().getPlotInfo(), RectangleEdge.LEFT);

        int itemIndex = findNearestItem(dataset, seriesIndex, x);
        System.out.println("点击数据点: (" + dataset.getX(seriesIndex, itemIndex) + ", " + dataset.getY(seriesIndex, itemIndex) + ")");
    }

    private int findNearestItem(XYDataset dataset, int series, double xValue) {
        int nearest = 0;
        double minDiff = Math.abs(dataset.getX(series, 0).doubleValue() - xValue);
        for (int i = 1; i < dataset.getItemCount(series); i++) {
            double diff = Math.abs(dataset.getX(series, i).doubleValue() - xValue);
            if (diff < minDiff) {
                minDiff = diff;
                nearest = i;
            }
        }
        return nearest;
    }
});

代码逻辑分析：

• chartPanel.setToolTipText() ：设置鼠标悬停时的提示信息。
• mouseClicked() ：捕获鼠标点击事件。
• translateScreenToJava2D() ：将屏幕坐标转换为 Java2D 坐标。
• findNearestItem() ：查找最接近点击位置的数据点索引。

扩展建议：
- 可以结合 ChartMouseListener 实现更复杂的交互。
- 使用 JOptionPane.showMessageDialog() 显示详细数据。

4.3.2 动态刷新折线图数据

在实际应用中，数据可能会动态变化，需要支持图表的实时刷新。

XYSeries series = dataset.getSeries(0);
series.add(new XYSeriesKey("动态点"), new double[]{System.currentTimeMillis() / 1000, Math.random() * 100});
chartPanel.repaint();

代码逻辑分析：

• series.add() ：向数据集中添加新的数据点。
• repaint() ：触发图表重绘，更新显示。

优化建议：
- 使用定时器 Timer 实现周期性刷新。
- 配合 SwingWorker 避免阻塞主线程。

4.4 折线图的典型应用场景

4.4.1 时间序列趋势分析

时间序列数据是折线图最常见的应用场景之一，例如股票价格走势、网站访问量变化等。

TimeSeries series = new TimeSeries("每日访问量", Day.class);
series.add(new Day(1, 1, 2025), 120);
series.add(new Day(2, 1, 2025), 150);
series.add(new Day(3, 1, 2025), 170);

TimeSeriesCollection dataset = new TimeSeriesCollection();
dataset.addSeries(series);

JFreeChart chart = ChartFactory.createTimeSeriesChart(
    "每日访问量趋势",
    "日期",
    "访问量",
    dataset
);

代码逻辑分析：

• TimeSeries ：专门用于时间序列数据。
• Day.class ：表示按天为单位的时间点。
• createTimeSeriesChart() ：创建时间序列折线图。

参数说明：
- Day 可以替换为 Hour 、 Month 等表示不同时间粒度。

4.4.2 数据变化率的可视化展示

折线图也可以用于展示数据变化率，例如温度变化、增长率等。

XYSeries series = new XYSeries("温度变化");
series.add(0, 20);
series.add(1, 22);
series.add(2, 25);
series.add(3, 23);

XYSeriesCollection dataset = new XYSeriesCollection(series);
JFreeChart chart = ChartFactory.createXYLineChart("温度变化趋势", "小时", "温度(℃)", dataset);

代码逻辑分析：

• XYSeries ：表示温度随时间变化的序列。
• createXYLineChart() ：创建 XY 折线图。

应用场景：
- 工业监控系统中的温度、压力变化。
- 学术研究中的实验数据可视化。

图表结构与流程说明

折线图构建流程图（mermaid）

graph TD
    A[准备数据集] --> B[创建图表对象]
    B --> C[设置坐标轴]
    C --> D[配置渲染器]
    D --> E[添加交互事件]
    E --> F[显示图表]

常见数据集类型表格对比

数据集类型	适用场景	是否支持时间序列	是否支持多系列
XYSeriesCollection	通用 XY 折线图	❌	✅
TimeSeriesCollection	时间序列折线图	✅	✅
DefaultXYZDataset	三维数据可视化	❌	✅

本章通过详细的代码示例与结构化分析，深入介绍了 JFreeChart 中折线图的创建、样式控制、交互功能与典型应用场景。下一章将继续讲解柱状图的设计与实现，进一步拓展 JFreeChart 的可视化能力。

5. 柱状图设计与实现

5.1 柱状图的类型与用途

5.1.1 垂直柱状图与水平柱状图的区别

柱状图是一种常见的数据可视化图表类型，主要用于比较不同类别的数据值。根据柱子的方向，可以将柱状图分为 垂直柱状图 （Vertical Bar Chart）和 水平柱状图 （Horizontal Bar Chart）。

• 垂直柱状图 ：柱子沿着Y轴方向延伸，适合展示类别名称较短的数据集，例如月份、季度、产品类型等。其优势在于视觉重心稳定，便于对比数据的高低。
• 水平柱状图 ：柱子沿X轴方向延伸，适用于类别名称较长的情况，例如公司名称、项目名称等，能够避免标签重叠问题，提升可读性。

在JFreeChart中，这两种图表类型可以通过调整 CategoryPlot 的方向来实现。

5.1.2 分组柱状图与堆叠柱状图的适用场景

根据柱状图中数据的组织方式，可以分为 分组柱状图 （Grouped Bar Chart）和 堆叠柱状图 （Stacked Bar Chart）：

图表类型	描述	适用场景
分组柱状图	同一分类下多个数据组并列显示	对比多个数据集在相同类别下的表现
堆叠柱状图	多个数据组在同一柱子中堆叠显示	展示不同数据组对整体的贡献比例

例如，在销售分析中，分组柱状图可用于比较不同产品在各月的销售额，而堆叠柱状图则可用于查看各产品在总销售额中的占比。

5.1.3 不同类型柱状图的实现对比

在JFreeChart中，创建不同类型的柱状图主要依赖于 BarRenderer 的配置。例如：

// 创建垂直柱状图
JFreeChart chart = ChartFactory.createBarChart(
    "销售分析", "月份", "销售额", dataset, PlotOrientation.VERTICAL, true, true, false
);

// 创建水平柱状图
JFreeChart chart = ChartFactory.createBarChart(
    "销售分析", "月份", "销售额", dataset, PlotOrientation.HORIZONTAL, true, true, false
);

逻辑分析：
- ChartFactory.createBarChart() 是创建柱状图的核心方法。
- 第四个参数 PlotOrientation.VERTICAL 控制柱子方向， VERTICAL 为垂直柱状图， HORIZONTAL 为水平柱状图。
- dataset 为数据集对象，通常是 DefaultCategoryDataset 。

5.1.4 图表类型选择的建议

在实际应用中，图表类型的选择应结合数据特征和展示目标：

• 当类别名称较长或需要展示时间跨度较长的数据时，优先考虑 水平柱状图 ；
• 需要比较多个数据集在相同类别下的表现时，使用 分组柱状图 ；
• 需要突出整体构成关系时，使用 堆叠柱状图 ；
• 若数据类别较少且数据值差异明显， 垂直柱状图 是最直观的选择。

5.1.5 JFreeChart中的柱状图类型支持

JFreeChart 提供了丰富的柱状图类型支持，开发者可通过以下类和方法进行扩展：

• BarChart3D ：3D柱状图；
• StackedBarChart ：堆叠柱状图；
• GroupedStackedBarRenderer ：组合堆叠柱状图；
• 自定义 BarRenderer 实现高级样式控制。

这些扩展机制为开发者提供了极大的灵活性。

5.1.6 小结

通过本节内容，我们了解了柱状图的不同类型及其适用场景，并掌握了如何在JFreeChart中创建和配置不同类型的柱状图。下一节将深入探讨如何使用JFreeChart创建柱状图的具体实现步骤。

5.2 使用JFreeChart创建柱状图

5.2.1 构建CategoryPlot与BarRenderer

在JFreeChart中，柱状图的构建核心在于 CategoryPlot 和 BarRenderer 两个类。

• CategoryPlot 是柱状图的绘图区域，负责管理数据集、轴和渲染器；
• BarRenderer 用于控制柱子的样式、颜色、标签等渲染行为。

以下是一个创建柱状图的基本流程示例：

// 1. 准备数据集
DefaultCategoryDataset dataset = new DefaultCategoryDataset();
dataset.addValue(120, "产品A", "一月");
dataset.addValue(200, "产品A", "二月");
dataset.addValue(150, "产品B", "一月");
dataset.addValue(180, "产品B", "二月");

// 2. 创建柱状图
JFreeChart chart = ChartFactory.createBarChart(
    "月度销售情况", "月份", "销售额", dataset, PlotOrientation.VERTICAL, true, true, false
);

// 3. 获取CategoryPlot对象
CategoryPlot plot = chart.getCategoryPlot();

// 4. 获取并配置BarRenderer
BarRenderer renderer = (BarRenderer) plot.getRenderer();
renderer.setSeriesPaint(0, Color.BLUE);
renderer.setSeriesPaint(1, Color.ORANGE);

逻辑分析：
- dataset.addValue(value, seriesName, category) ：添加数据， seriesName 为数据系列名， category 为分类名。
- ChartFactory.createBarChart() ：创建柱状图对象。
- chart.getCategoryPlot() ：获取绘图区域。
- plot.getRenderer() ：获取渲染器并进行样式设置。
- renderer.setSeriesPaint(index, color) ：设置不同数据系列的颜色。

5.2.2 设置柱状图的填充样式与标签显示

JFreeChart提供了丰富的样式配置选项，可以对柱子的填充颜色、边框、标签等进行个性化设置。

设置柱子颜色与边框

// 设置柱子边框颜色和粗细
renderer.setSeriesOutlinePaint(0, Color.BLACK);
renderer.setSeriesOutlineStroke(0, new BasicStroke(2.0f));

// 设置柱子的填充样式为渐变色
GradientPaint gp = new GradientPaint(0.0f, 0.0f, Color.RED, 0.0f, 0.0f, Color.PINK, false);
renderer.setSeriesPaint(0, gp);

参数说明：
- setSeriesOutlinePaint() ：设置柱子的边框颜色；
- setSeriesOutlineStroke() ：设置边框线宽；
- GradientPaint ：创建渐变色填充，前两个参数为坐标，后两个为颜色，最后布尔值表示是否为循环渐变。

显示数据标签

// 显示柱子顶部的数值标签
ItemLabelPosition position = new ItemLabelPosition(ItemLabelAnchor.OUTSIDE12, TextAnchor.BOTTOM_CENTER);
renderer.setSeriesItemLabelPaint(0, Color.BLACK);
renderer.setSeriesPositiveItemLabelPosition(0, position);
renderer.setItemLabelsVisible(true);

逻辑说明：
- ItemLabelPosition ：定义标签位置， OUTSIDE12 表示柱子顶部；
- setItemLabelsVisible(true) ：启用标签显示。

5.2.3 配置坐标轴样式

坐标轴的样式可以通过 CategoryAxis 和 ValueAxis 进行调整：

// 获取X轴和Y轴
CategoryAxis xAxis = plot.getDomainAxis();
ValueAxis yAxis = plot.getRangeAxis();

// 设置X轴标签角度
xAxis.setCategoryLabelPositions(CategoryLabelPositions.UP_45);

// 设置Y轴刻度范围
yAxis.setRange(0, 250);

代码解读：
- setCategoryLabelPositions(CategoryLabelPositions.UP_45) ：将X轴标签倾斜45度，避免重叠；
- setRange(0, 250) ：设置Y轴的显示范围为0到250。

5.2.4 示例：完整柱状图绘制流程

graph TD
    A[准备数据集] --> B[创建柱状图对象]
    B --> C[获取CategoryPlot]
    C --> D[获取并配置BarRenderer]
    D --> E[设置柱子颜色与样式]
    D --> F[设置标签显示]
    C --> G[配置坐标轴]
    B --> H[显示图表]

流程图说明：
- 从数据集准备开始，逐步配置图表的各个组件，最终渲染出完整的柱状图。

5.2.5 多系列柱状图的构建技巧

在构建分组柱状图时，可以使用多个系列的数据，并通过渲染器进行分组控制：

// 添加多个系列
dataset.addValue(120, "系列1", "分类A");
dataset.addValue(180, "系列2", "分类A");
dataset.addValue(90, "系列1", "分类B");
dataset.addValue(150, "系列2", "分类B");

// 设置分组间距
BarRenderer barRenderer = (BarRenderer) plot.getRenderer();
barRenderer.setItemMargin(0.2); // 设置柱子之间的间距

说明：
- setItemMargin(0.2) ：控制柱子之间的间距，0表示无间距，1表示最大间距。

5.2.6 小结

本节详细介绍了如何使用JFreeChart创建柱状图，包括 CategoryPlot 和 BarRenderer 的构建与配置，并通过代码示例展示了如何设置柱子样式、标签、坐标轴等元素。此外，还提供了多系列柱状图的实现方式和流程图说明。下一节将继续深入探讨柱状图的样式自定义策略。

6. 饼图设计与实现

6.1 饼图的基本概念与适用场景

6.1.1 展示比例分布的核心功能

饼图（Pie Chart）是一种以圆形分割的方式，将整体数据划分为若干扇区，每个扇区的面积大小代表其所占比例的图表形式。它特别适用于展示分类数据的相对比例关系，例如市场份额分布、人口构成比例、预算分配等。饼图的直观性使其成为商业报告、数据分析和演示文稿中的常用图表类型。

在JFreeChart中，饼图主要通过 PiePlot 类实现。其核心思想是将数据封装为 DefaultPieDataset 对象，并通过图表引擎生成对应的扇形区域。饼图的优势在于视觉清晰、易于理解，但也有局限性，比如不适用于过多分类（通常建议不超过7个）或数据变化频繁的场景。

6.1.2 注意事项与数据合理性要求

使用饼图时需要注意以下几点：

• 分类数量控制 ：饼图扇区过多会导致图形混乱，建议分类数量控制在5~7个以内。
• 数据一致性 ：所有分类数据应为正数，避免负值或零值干扰比例计算。
• 突出重点数据 ：可通过“爆炸”某一个扇区来突出重点数据，增强视觉焦点。
• 避免误导性 ：不建议使用三维饼图，因为其角度变化可能误导用户对比例的判断。

因此，在设计饼图前应确保数据的合理性和图表结构的清晰度。

6.2 使用JFreeChart绘制饼图

6.2.1 创建PiePlot与设置渲染器

在JFreeChart中，创建饼图的基本流程包括：准备数据集、构建图表对象、设置渲染器和展示图表。以下是创建一个简单饼图的完整示例代码：

import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartPanel;
import org.jfree.chart.JFreeChart;
import org.jfree.chart.plot.PiePlot;
import org.jfree.data.general.DefaultPieDataset;
import javax.swing.*;

public class PieChartDemo extends JFrame {

    public PieChartDemo(String title) {
        super(title);
        // 步骤一：准备数据集
        DefaultPieDataset dataset = new DefaultPieDataset();
        dataset.setValue("Android", 40);
        dataset.setValue("iOS", 30);
        dataset.setValue("Windows", 20);
        dataset.setValue("Others", 10);

        // 步骤二：创建饼图对象
        JFreeChart chart = ChartFactory.createPieChart(
                "Mobile OS Market Share",  // 图表标题
                dataset,                   // 数据集
                true,                      // 是否显示图例
                true,                      // 是否生成工具提示
                false                      // 是否生成URL
        );

        // 步骤三：获取PiePlot并进行样式设置
        PiePlot plot = (PiePlot) chart.getPlot();
        plot.setSectionOutlinesVisible(false); // 关闭扇区边框
        plot.setLabelBackgroundPaint(null);    // 透明标签背景
        plot.setNoDataMessage("No Data Available"); // 无数据提示

        // 步骤四：将图表嵌入JPanel中
        ChartPanel chartPanel = new ChartPanel(chart);
        chartPanel.setPreferredSize(new java.awt.Dimension(560, 370));
        setContentPane(chartPanel);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            PieChartDemo demo = new PieChartDemo("Pie Chart Demo");
            demo.setSize(600, 400);
            demo.setLocationRelativeTo(null);
            demo.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            demo.setVisible(true);
        });
    }
}

代码逻辑分析：

• 数据准备 ： DefaultPieDataset 用于封装饼图所需的数据，每个键值对代表一个扇区。
• 图表创建 ：通过 ChartFactory.createPieChart() 方法创建饼图对象，参数控制图例、工具提示等。
• 图表样式调整 ：通过 PiePlot 对象可以调整扇区边框、标签背景、无数据提示等。
• 展示图表 ：将图表嵌入到 ChartPanel 中，并作为JFrame的内容展示。

6.2.2 饼图扇区颜色与标签配置

默认情况下，JFreeChart会为每个扇区自动分配颜色。但开发者可以通过以下方式自定义颜色：

plot.setSectionPaint("Android", Color.GREEN);
plot.setSectionPaint("iOS", Color.BLUE);

此外，标签格式也可以通过 setLabelFormat() 方法自定义：

plot.setLabelFormat("{0} ({1}, {2})"); // {0}=键名，{1}=值，{2}=百分比

还可以控制标签是否显示、字体大小、位置等：

plot.setLabelFont(new Font("SansSerif", Font.PLAIN, 12));
plot.setLabelVisible(true);

6.3 饼图的高级定制

6.3.1 显示百分比与绝对值的格式控制

在饼图中，默认显示的百分比是四舍五入保留两位小数的。可以通过 setPercentFormat() 方法更改格式：

import java.text.DecimalFormat;

plot.setPercentFormat(new DecimalFormat("0.0%")); // 显示一位小数百分比

若希望显示绝对值，可以结合标签格式控制：

plot.setLabelFormat("{0}: {1} units ({2})"); // 显示键名、值、百分比

6.3.2 设置爆炸扇区与图例显示方式

可以通过设置某个扇区“爆炸”来突出显示重点数据：

plot.setExplodePercent("iOS", 0.1); // iOS扇区向外爆炸10%

图例（Legend）的显示方式也可以进行自定义：

chart.getLegend().setFrame(BlockBorder.NONE); // 移除图例边框
chart.getLegend().setItemFont(new Font("Arial", Font.BOLD, 14)); // 设置图例字体

此外，还可以控制图例的位置和可见性：

chart.getLegend().setVisible(false); // 隐藏图例
chart.getLegend().setPosition(RectangleEdge.BOTTOM); // 将图例放在底部

6.4 饼图的交互与数据更新

6.4.1 鼠标悬停提示与点击响应

JFreeChart支持鼠标悬停提示（ToolTip），默认已启用。可以通过以下方式自定义提示内容：

plot.setToolTipGenerator((dataset, section) -> {
    String key = dataset.getKey(section).toString();
    Number value = dataset.getValue(section);
    return key + ": " + value + " units";
});

点击事件响应则需要注册 ChartMouseListener ：

chartPanel.addChartMouseListener(new ChartMouseListener() {
    @Override
    public void chartMouseClicked(ChartMouseEvent event) {
        Object entity = event.getEntity();
        if (entity instanceof PieSectionEntity) {
            PieSectionEntity pieEntity = (PieSectionEntity) entity;
            String sectionKey = pieEntity.getSectionKey().toString();
            JOptionPane.showMessageDialog(null, "You clicked on: " + sectionKey);
        }
    }

    @Override
    public void chartMouseMoved(ChartMouseEvent event) {
        // 可以用于动态高亮等
    }
});

6.4.2 动态更新饼图数据源

动态更新数据是JFreeChart的一大亮点。以下是一个简单的数据更新示例：

DefaultPieDataset dataset = new DefaultPieDataset();
dataset.setValue("A", 10);
dataset.setValue("B", 20);

// 在某个操作后更新数据
dataset.setValue("A", 30);
dataset.setValue("C", 15);

由于 DefaultPieDataset 支持事件监听机制，一旦数据发生变化，图表会自动刷新显示。

表格：饼图关键类与方法对照表

类/接口	功能说明
DefaultPieDataset	饼图数据容器，用于封装键值对数据
PiePlot	饼图绘图对象，控制样式与渲染行为
ChartFactory.createPieChart	快速创建饼图的方法
setExplodePercent()	设置扇区爆炸效果
setPercentFormat()	控制百分比显示格式
setToolTipGenerator()	自定义提示信息生成器
ChartMouseListener	监听图表点击与鼠标事件

Mermaid 流程图：饼图绘制流程

graph TD
    A[准备数据集] --> B[创建图表对象]
    B --> C[获取PiePlot对象]
    C --> D[设置样式与渲染器]
    D --> E[添加图表到面板]
    E --> F[展示图表]

通过上述内容，开发者可以全面掌握使用JFreeChart创建、定制与交互饼图的方法，从而在Java项目中实现丰富的数据可视化效果。

7. 图表组件自定义与交互功能实现

7.1 图表组件的样式定制

7.1.1 设置图表标题、子标题与字体样式

在JFreeChart中，图表的标题和子标题可以通过 TextTitle 类进行设置。开发者可以自定义字体、颜色以及对齐方式，从而提升图表的视觉效果。

JFreeChart chart = ChartFactory.createLineChart(
    "默认标题",  // 初始标题
    "X轴", 
    "Y轴", 
    dataset
);

// 设置主标题
TextTitle title = new TextTitle("销售趋势分析");
title.setFont(new Font("微软雅黑", Font.BOLD, 20));
title.setPaint(Color.BLUE);
chart.setTitle(title);

// 添加子标题
TextTitle subtitle = new TextTitle("数据来源：公司销售记录");
subtitle.setFont(new Font("宋体", Font.PLAIN, 12));
subtitle.setPaint(Color.GRAY);
chart.addSubtitle(subtitle);

• setFont() ：设置字体，包括字体名称、样式和大小。
• setPaint() ：设置文本颜色。
• addSubtitle() ：添加子标题。

7.1.2 自定义坐标轴与图例的显示方式

坐标轴和图例是图表的重要组成部分。JFreeChart允许开发者对坐标轴的标签、刻度、颜色等进行自定义。

CategoryPlot plot = chart.getCategoryPlot();
ValueAxis axis = plot.getRangeAxis();

// 设置Y轴标签字体
axis.setLabelFont(new Font("Arial", Font.BOLD, 14));
axis.setLabelPaint(Color.RED);

// 设置X轴刻度线颜色
CategoryAxis domainAxis = plot.getDomainAxis();
domainAxis.setTickLabelFont(new Font("Arial", Font.PLAIN, 12));
domainAxis.setTickLabelPaint(Color.DARK_GRAY);

// 图例设置
LegendItemCollection legendItems = new LegendItemCollection();
legendItems.add(new LegendItem("销售数据", Color.BLUE));
chart.getLegend().setLegendItems(legendItems);

• setLabelFont() ：设置坐标轴标签字体。
• setTickLabelPaint() ：设置坐标轴刻度标签颜色。
• LegendItemCollection ：用于自定义图例项。

7.2 图表颜色与主题管理

7.2.1 使用StandardChartTheme设置主题

JFreeChart提供了 StandardChartTheme 类，可以快速为图表应用统一的主题风格，包括背景色、网格线、字体等。

StandardChartTheme theme = new StandardChartTheme("自定义主题");
theme.setExtraLargeFont(new Font("微软雅黑", Font.BOLD, 20));
theme.setLargeFont(new Font("微软雅黑", Font.BOLD, 16));
theme.setRegularFont(new Font("微软雅黑", Font.PLAIN, 12));
theme.setPlotBackgroundPaint(Color.WHITE);
theme.setPlotOutlinePaint(Color.BLACK);
theme.setLabelLinkPaint(Color.BLUE);
theme.apply(chart);

• setExtraLargeFont() ：设置大标题字体。
• setPlotBackgroundPaint() ：设置绘图区背景颜色。
• setLabelLinkPaint() ：设置图例标签连接线颜色。

7.2.2 自定义颜色调色板与渐变效果

通过 PaintScale 接口和 GradientPaint 可以实现图表的颜色渐变效果。

XYPlot xyPlot = (XYPlot) chart.getPlot();
XYItemRenderer renderer = xyPlot.getRenderer();

// 设置渐变色
GradientPaint gp = new GradientPaint(
    0.0f, 0.0f, Color.BLUE,
    0.0f, 0.0f, Color.CYAN
);
renderer.setSeriesPaint(0, gp);

• GradientPaint ：实现颜色渐变。
• setSeriesPaint() ：为数据系列设置填充颜色。

方法名	功能描述
setSeriesPaint()	设置图表系列的颜色
setPlotBackgroundPaint()	设置绘图区背景色

7.3 图表交互功能实现

7.3.1 添加缩放与平移功能

JFreeChart支持通过鼠标进行图表的缩放和平移操作，适用于大型数据集展示。

ChartPanel chartPanel = new ChartPanel(chart);
chartPanel.setMouseWheelEnabled(true);
chartPanel.setDomainZoomable(true);
chartPanel.setRangeZoomable(true);

• setDomainZoomable(true) ：启用X轴方向的缩放。
• setRangeZoomable(true) ：启用Y轴方向的缩放。
• setMouseWheelEnabled(true) ：启用鼠标滚轮缩放。

7.3.2 图表事件监听器的注册与处理

可以通过添加 ChartMouseListener 来响应用户的鼠标事件，例如点击、悬停等。

chartPanel.addChartMouseListener(new ChartMouseListener() {
    @Override
    public void chartMouseClicked(ChartMouseEvent event) {
        ChartEntity entity = event.getEntity();
        if (entity != null && entity instanceof CategoryItemEntity) {
            CategoryItemEntity item = (CategoryItemEntity) entity;
            System.out.println("点击了数据项：" + item.getSeriesKey() + " - " + item.getCategory());
        }
    }

    @Override
    public void chartMouseMoved(ChartMouseEvent event) {
        // 鼠标移动时的逻辑
    }
});

• chartMouseClicked() ：响应图表点击事件。
• ChartEntity ：获取点击的具体图表元素（如柱子、点等）。

7.4 图表的导出与性能优化

7.4.1 导出为PNG、JPEG和PDF格式

JFreeChart支持将图表导出为多种图像格式，适用于报告生成和网页展示。

try {
    // 导出为PNG
    ChartUtils.writeChartAsPNG(new File("chart.png"), chart, 800, 600);
    // 导出为JPEG
    ChartUtils.writeChartAsJPEG(new File("chart.jpg"), chart, 800, 600);
    // 导出为PDF（需iText库支持）
    PdfWriter writer = PdfWriter.getInstance(new Document(), new FileOutputStream("chart.pdf"));
    writer.open();
    PdfContentByte contentByte = writer.getDirectContent();
    PdfTemplate template = contentByte.createTemplate(800, 600);
    Graphics2D g2d = template.createGraphics(800, 600, new DefaultFontMapper());
    chart.draw(g2d, new Rectangle2D.Double(0, 0, 800, 600), null);
    g2d.dispose();
    contentByte.addTemplate(template, 0, 0);
} catch (Exception e) {
    e.printStackTrace();
}

• ChartUtils.writeChartAsPNG() ：导出为PNG图像。
• ChartUtils.writeChartAsJPEG() ：导出为JPEG图像。
• PDF导出需依赖 iText 库。

7.4.2 内存优化与图表渲染效率提升

对于大数据量的图表，可以通过以下方式进行优化：

• 数据采样 ：对于超大数据集，使用采样策略减少绘制点数。
• 禁用抗锯齿 ：降低渲染质量以提高性能。

chart.getRenderingHints().clear();
chart.getRenderingHints().put(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_OFF);

• KEY_ANTIALIASING ：关闭抗锯齿以提升绘制速度。

优化策略	说明
数据采样	降低绘制数据量
关闭抗锯齿	提高渲染速度
图表重用	复用图表对象避免频繁创建

graph TD
    A[开始图表优化] --> B{是否大数据量?}
    B -->|是| C[启用数据采样]
    B -->|否| D[保持原数据]
    A --> E[设置渲染参数]
    E --> F[关闭抗锯齿]
    E --> G[调整内存缓存]
    C --> H[生成图表]
    D --> H
    F --> H

本章通过自定义图表组件、设置主题样式、实现交互功能以及导出图表，帮助开发者打造更加专业和高效的可视化应用。

本文还有配套的精品资源，点击获取

简介：JFreeChart是一款功能丰富的开源Java图表库，支持创建动态、交互式的2D图表，适用于Swing和JavaFX应用。本文详细介绍了JFreeChart的安装配置、核心图表类型（如折线图、柱状图、饼图、甘特图等）的创建流程，以及图表的自定义、导出和性能优化技巧。通过实践操作，开发者可以掌握如何将复杂数据转化为直观可视化的图表，并有效集成到Java项目中。

本文还有配套的精品资源，点击获取