文章目录
- 前言
- [一、JFreeChart 简介](#一、JFreeChart 简介)
- 二、环境准备
- [三、 创建第一个折线图](#三、 创建第一个折线图)
- 四、自定义图表样式
-
- [4.1 设置背景色](#4.1 设置背景色)
- [4.2 设置折线颜色](#4.2 设置折线颜色)
- [4.3 设置字体(解决中文乱码)](#4.3 设置字体(解决中文乱码))
- [4.4 设置横坐标的标签宽度和方向](#4.4 设置横坐标的标签宽度和方向)
- 五、导出图表
- 六、实战:动态生成日报图表
- 总结
前言
在数据可视化的世界中,图表是展示数据的强大工具。无论是折线图、柱状图还是饼图,它们都能帮助我们更直观地理解数据。在 Java 生态中,JFreeChart 是一个功能强大且灵活的图表库,广泛应用于各种 Java 应用程序中。本文将带你从零开始学习如何使用 JFreeChart 创建动态图表,并结合实际代码示例,让你快速掌握其核心功能。
一、JFreeChart 简介
JFreeChart 是一个开源的 Java 图表库,支持多种图表类型,包括:
-
折线图(Line Chart)
-
柱状图(Bar Chart)
-
饼图(Pie Chart)
-
散点图(Scatter Plot)
-
面积图(Area Chart)
它的主要特点包括:
-
易于使用:通过简单的 API 即可创建复杂的图表。
-
高度可定制:支持自定义颜色、字体、样式等。
-
支持导出:可以将图表导出为 PNG、JPEG、PDF 等格式。
二、环境准备
在开始之前,我们需要在项目中引入 JFreeChart 的依赖。如果你使用 Maven,可以在 pom.xml 中添加以下依赖:
xml
<dependency>
<groupId>org.jfree</groupId>
<artifactId>jfreechart</artifactId>
<version>1.5.3</version>
</dependency>
三、 创建第一个折线图
折线图是展示数据趋势的常用图表类型。以下是一个简单的示例,展示如何使用 JFreeChart 创建一个折线图。
java
import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartUtils;
import org.jfree.chart.JFreeChart;
import org.jfree.data.category.DefaultCategoryDataset;
import java.io.File;
import java.io.IOException;
public class LineChartExample {
public static void main(String[] args) {
// 创建数据集
DefaultCategoryDataset dataset = new DefaultCategoryDataset();
dataset.addValue(1, "Series1", "Category1");
dataset.addValue(4, "Series1", "Category2");
dataset.addValue(3, "Series1", "Category3");
dataset.addValue(5, "Series1", "Category4");
// 创建折线图
JFreeChart chart = ChartFactory.createLineChart(
"Sample Line Chart", // 图表标题
"Category", // X轴标签
"Value", // Y轴标签
dataset // 数据集
);
// 保存图表为图片
try {
ChartUtils.saveChartAsPNG(new File("line_chart.png"), chart, 600, 400);
System.out.println("Chart saved as line_chart.png");
} catch (IOException e) {
e.printStackTrace();
}
}
}
运行结果
运行上述代码后,会生成一个名为 line_chart.png 的图片文件,内容如下:
-
标题:Sample Line Chart
-
X 轴标签:Category
-
Y 轴标签:Value
-
数据点:(Category1, 1), (Category2, 4), (Category3, 3), (Category4, 5)
四、自定义图表样式
JFreeChart 提供了丰富的 API 来自定义图表样式。以下是一些常见的自定义操作:
4.1 设置背景色
java
import java.awt.Color;
// 设置图表背景色
chart.setBackgroundPaint(Color.WHITE);
// 设置绘图区域背景色
CategoryPlot plot = chart.getCategoryPlot();
plot.setBackgroundPaint(Color.LIGHT_GRAY);
4.2 设置折线颜色
java
import org.jfree.chart.renderer.category.LineAndShapeRenderer;
// 获取渲染器
LineAndShapeRenderer renderer = (LineAndShapeRenderer) plot.getRenderer();
// 设置折线颜色
renderer.setSeriesPaint(0, Color.RED); // 第一条折线为红色
renderer.setSeriesStroke(0, new BasicStroke(2.0f)); // 设置线条粗细
4.3 设置字体(解决中文乱码)
java
import org.jfree.chart.StandardChartTheme;
// 设置全局字体
StandardChartTheme chartTheme = new StandardChartTheme("CN");
chartTheme.setExtraLargeFont(new Font("宋体", Font.PLAIN, 20)); // 标题字体
chartTheme.setLargeFont(new Font("宋体", Font.PLAIN, 16)); // 图例字体
chartTheme.setRegularFont(new Font("宋体", Font.PLAIN, 14)); // 轴标签字体
ChartFactory.setChartTheme(chartTheme);
4.4 设置横坐标的标签宽度和方向
java
CategoryAxis categoryAxis = chart.getCategoryPlot().getDomainAxis();
categoryAxis.setMaximumCategoryLabelLines(2); // 允许每个标签最多两行
categoryAxis.setCategoryLabelPositions(CategoryLabelPositions.UP_45); // 旋转标签
categoryAxis.setLowerMargin(0.0); // 去掉边缘空白
categoryAxis.setUpperMargin(0.0); // 去掉边缘空白
五、导出图表
JFreeChart 支持将图表导出为多种格式,如 PNG、JPEG、PDF 等。以下是将图表保存为 PNG 文件的示例:
java
import org.jfree.chart.ChartUtils;
// 保存图表为 PNG 文件
ChartUtils.saveChartAsPNG(new File("chart.png"), chart, 800, 600);
六、实战:动态生成日报图表
以下是一个实战示例,展示如何动态生成日报中的折线图,并将其插入到 Word 文档中。
java
import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.data.PictureType;
import com.deepoove.poi.data.Pictures;
import org.jfree.chart.ChartFactory;
import org.jfree.chart.ChartUtils;
import org.jfree.chart.JFreeChart;
import org.jfree.data.category.DefaultCategoryDataset;
import java.io.File;
import java.io.FileInputStream;
import java.util.HashMap;
import java.util.Map;
public class DailyReportExample {
public static void main(String[] args) throws Exception {
// 创建数据集
DefaultCategoryDataset dataset = new DefaultCategoryDataset();
dataset.addValue(10, "监测站", "00:00");
dataset.addValue(20, "监测站", "06:00");
dataset.addValue(30, "监测站", "12:00");
dataset.addValue(40, "监测站", "18:00");
// 创建折线图
JFreeChart chart = ChartFactory.createLineChart(
"监测站总在线数", // 图表标题
"小时", // X轴标签
"数量", // Y轴标签
dataset // 数据集
);
// 保存图表为图片
String chartPath = "daily_chart.png";
ChartUtils.saveChartAsPNG(new File(chartPath), chart, 800, 600);
// 将图片插入到 Word 文档
Map<String, Object> dataMap = new HashMap<>();
dataMap.put("chart", Pictures.ofStream(new FileInputStream(chartPath), PictureType.PNG).create());
XWPFTemplate template = XWPFTemplate.compile("template.docx").render(dataMap);
template.writeToFile("output.docx");
}
}
总结
通过本文,你已经掌握了 JFreeChart 的基本用法,包括:
创建折线图、柱状图等常见图表。
自定义图表样式(背景色、折线颜色、字体等)。
将图表导出为图片或插入到 Word 文档中。
JFreeChart 是一个功能强大且灵活的图表库,适用于各种数据可视化需求。希望本文能帮助你快速上手 JFreeChart,并在实际项目中应用它!
参考资料:
JFreeChart 官方文档
JFreeChart GitHub 仓库
![](https://i-blog.csdnimg.cn/direct/ce0ee8f1f8f2458aae08123745eeedd5.jpeg)