介绍下pdf打印工具类 JasperPrint

JasperPrint 工具类深度解析

JasperPrint 是 JasperReports 框架中实现 PDF 打印的核心载体类，其本质是 填充数据后的可打印报表对象，承担着从模板编译、数据填充到格式输出的全流程控制。以下从 7 个维度展开深度解析：

一、核心定位与生命周期
  1. 中间态实体角色
    JasperPrint 处于报表生成流程的中间阶段（生命周期模型）：
   JRXML（设计模板） → Jasper（编译模板） → JasperPrint（填充数据） → PDF/Excel（导出）

其内存结构中包含：

  • 编译后的模板元数据
  • 动态注入的参数集合（Map<String, Object>）
  • 数据源绑定结果（JRDataSource）
  1. 跨格式输出枢纽
    支持通过 JasperExportManager 或 JRPdfExporter 导出为 PDF，也可适配 Excel/HTML 等其他格式，实现 一份填充数据多端复用 的特性。
二、核心功能实现
（一）数据填充
  1. 参数注入方式
   Map<String,Object> params = new HashMap<>();params.put("title", "2025年度报表");JasperPrint print = JasperFillManager.fillReport(jasperFile, params, dataSource);

运行

  • 支持基础类型、POJO、图片资源（需转 InputStream）
  • 参数作用域覆盖整个报表生命周期

  1. 数据源绑定

    数据源类型适用场景代码示例来源证据
    JRBeanCollectionDataSourceList 集合数据绑定new JRBeanCollectionDataSource(list)
    JREmptyDataSource无数据空报表生成new JREmptyDataSource()
    ResultSet直接数据库查询结果new JRResultSetDataSource(rs)
（二）打印控制
  1. 页面布局配置
   PDFPrintable pdfPrintable = new PDFPrintable(print, Scaling.ACTUAL_SIZE);PageFormat pageFormat = new PageFormat();pageFormat.setOrientation(PageFormat.LANDSCAPE); // 横向打印

运行

  • 支持缩放比例（Scaling.SHRINK_TO_FIT等）、纸张大小（pageFormat.setPaper()）
  1. 批量打印管理
    通过 List<JasperPrint> 实现多文档串联打印，支持：
    • 页码连续编排
    • 书签目录生成（IS_CREATING_BATCH_MODE_BOOKMARKS参数）
三、PDF 导出实现
（一）基础导出模式
  1. 快速导出法
   JasperExportManager.exportReportToPdfStream(print, outputStream);

运行

  • 优点：代码简洁，自动处理字体嵌入
  • 缺点：无法定制加密等高级功能
  1. 精细化控制法
   JRPdfExporter exporter = new JRPdfExporter();exporter.setParameter(JRExporterParameter.JASPER_PRINT, print);exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, os);exporter.exportReport();

运行

  • 支持 PDF 加密（USER_PASSWORD/OWNER_PASSWORD）
  • 可配置权限（打印/复制/修改等）
（二）中文处理方案
  1. 字体配置关键点
   net.sf.jasperreports.extension.registry.factory.simple.font.families=net.sf.jasperreports.engine.fonts.SimpleFontExtensionsRegistryFactorynet.sf.jasperreports.extension.simple.font.families.lobstertwo=stsong/fonts.xml
  • 必须包含中文字体文件（如 stsong.ttf）
  • PDF 编码需设置为 UniGB-UCS2-H
  1. 常见问题解决
    • 乱码：检查字体是否嵌入（PDF Embedded=true）
    • 空白页：调整 detail 区域高度避免溢出
四、企业级应用实践
（一）SpringBoot 整合
  1. 工具类封装
   public class JasperPdfUtil {public static byte[] export(Map<String,Object> params) throws JRException {JasperReport report = JasperCompileManager.compileReport("template.jrxml");JasperPrint print = JasperFillManager.fillReport(report, params, new JREmptyDataSource());return JasperExportManager.exportReportToPdf(print);}}

运行

  • 支持模板热加载
  • 结合 ResponseEntity 实现 RESTful 输出
  1. 动态模板方案
   Resource resource = new ClassPathResource("templates/"+templateName+".jasper");JasperPrint print = JasperFillManager.fillReport(resource.getInputStream(), params, dataSource);

运行

  • 模板路径可配置化
  • 支持云端存储模板（如 OSS）
（二）性能优化

  1. 内存控制策略

    • 启用虚拟化模式（IS_IGNORE_PAGINATION 分页优化）
    • 使用 JRFileVirtualizer 处理大报表

  2. 异步导出方案

   CompletableFuture.supplyAsync(() -> {return JasperExportManager.exportReportToPdf(print);}).thenAccept(pdfBytes -> {// 写入消息队列或OSS});

运行

  • 避免 HTTP 请求超时
五、特殊场景处理
  1. Base64 编码输出
   byte[] pdfBytes = JasperExportManager.exportReportToPdf(print);String base64Str = new BASE64Encoder().encode(pdfBytes);

运行

  • 前端渲染需添加 data:application/pdf;base64, 前缀
  • 需替换 + 为 %2B 防止传输错误
  1. 加密文档生成
   exporter.setParameter(PdfExporterConfiguration.IS_ENCRYPTED, true);exporter.setParameter(PdfExporterConfiguration.USER_PASSWORD, "user123");exporter.setParameter(PdfExporterConfiguration.OWNER_PASSWORD, "admin456");

运行

  • 支持 128 位密钥加密
六、调试与监控
  1. 日志追踪配置
   <logger name="net.sf.jasperreports" level="DEBUG"/>
  • 可捕获模板编译错误、数据绑定异常
  1. 可视化预览器
   JasperViewer.viewReport(print, false); // 弹出预览窗口

运行

  • 本地调试时快速验证布局
七、技术演进趋势

  1. 云原生支持

    • 与 K8s 结合实现弹性扩缩容
    • 模板存储从本地文件转向 MinIO/OSS

  2. 智能化增强

    • 集成 AI 引擎自动优化报表布局
    • 动态参数推荐（基于历史数据分析）

JasperPrint 工作流程图

JasperPrint 工作流程图


（流程图示意：模板编译 → 数据填充 → 打印控制 → 格式导出）

总结

JasperPrint 作为 JasperReports 生态中的 数据承载中枢，其核心价值在于解耦了模板设计与数据呈现。通过精准的参数控制、灵活的数据源适配以及深度的格式定制能力，使其成为企业级报表系统的首选方案。在云原生与 AI 技术驱动下，未来将向 动态化、服务化、智能化 方向持续演进。

分享

追问

相关组织

组织名称概述

JasperSoft

软件/技术一家提供报表工具JasperReport的公司，用于实现PDF打印。

TIBCO

软件/技术提供Jaspersoft Studio软件，用于绘制报表模板。

相关人物

人物名称概述

junqiang.lu

开发者/程序员开发了JasperPdfUtil工具类的作者。

JasperPrint 支持哪些数据源？

JasperPrint 支持的数据源类型全解析

作为 JasperReports 框架的核心数据载体，JasperPrint 支持的数据源类型与其底层接口 JRDataSource 的实现密切相关。根据资料中的技术文档和代码实践，其数据源支持体系可划分为以下六类：

一、JDBC 数据库连接（关系型数据源）

实现方式
通过 java.sql.Connection 对象直接传递 SQL 查询结果，适用于传统关系型数据库（如 MySQL、Oracle）。

Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/db", "user", "pass");
JasperPrint print = JasperFillManager.fillReport(jasperReport, params, conn); // 自动执行模板中的 SQL

运行

核心特征：

  • 内置支持 JDBC 驱动（需在报表模板中预定义 SQL 查询）
  • 支持动态参数化 SQL（通过 $P{param} 注入）
二、集合类数据源（JavaBean/List/Map）

实现方式

  1. JavaBean 集合：通过 JRBeanCollectionDataSource 转换 List&lt;POJO&gt;
List<Customer> customers = customerDao.getAll();
JRDataSource ds = new JRBeanCollectionDataSource(customers);
JasperPrint print = JasperFillManager.fillReport(jasperReport, params, ds); // 自动映射字段名

运行

  1. Map 集合：直接传递 Map<String, Object>，适用于无结构化数据的场景
Map<String, Object> data = new HashMap<>();
data.put("sales", 50000);
JasperPrint print = JasperFillManager.fillReport(jasperReport, data, new JREmptyDataSource());

运行

核心特征：

  • 字段名需与模板中的 $F{field} 严格匹配
  • 支持嵌套对象（如 $F{user.address.city}）
三、空数据源（无数据填充）

实现方式
使用 JREmptyDataSource 生成无数据报表，常用于静态参数展示。

JasperPrint print = JasperFillManager.fillReport(jasperReport, params, new JREmptyDataSource());

运行

应用场景：

  • 生成仅含标题、页脚的空白模板
  • 参数化动态内容（如图片路径、标题文本）
四、JSON 数据源（非结构化数据）

实现方式
通过 JsonQueryExecuterFactory 解析 JSON 输入流，支持复杂嵌套结构。

InputStream jsonStream = new ByteArrayInputStream(jsonStr.getBytes());
params.put(JsonQueryExecuterFactory.JSON_INPUT_STREAM, jsonStream);
JasperPrint print = JasperFillManager.fillReport(jasperReport, params, new JREmptyDataSource());

运行

关键配置：

  • 需在模板中定义 JSON 路径表达式（如 $.users[0].name）
  • 支持本地化参数（JSON_LOCALE）和日期格式化
五、文件类数据源（Excel/CSV/XML）

实现方式
通过自定义 JRDataSource 实现类解析文件，如：

  1. Excel 数据源：使用 JRXlsxDataSource
JRXlsxDataSource ds = new JRXlsxDataSource(new File("data.xlsx"));
ds.setSheetSelection(0); // 选择工作表
JasperPrint print = JasperFillManager.fillReport(jasperReport, params, ds);

运行

  1. CSV 数据源：使用 JRCsvDataSource
JRCsvDataSource ds = new JRCsvDataSource(new File("data.csv"));
ds.setColumnNames(new String[]{"id", "name"}); // 定义列名

运行

核心特征：

  • 需引入 jasperreports-components 依赖
  • 支持分页读取大文件
六、自定义数据源（扩展接口）

实现方式
继承 JRDataSource 接口，处理特殊数据格式（如 NoSQL、API 接口）。

public class CustomDataSource implements JRDataSource {private Iterator<Data> iterator;public boolean next() { return iterator.hasNext(); }public Object getFieldValue(JRField field) {return iterator.next().get(field.getName());}
}
// 使用
JasperPrint print = JasperFillManager.fillReport(jasperReport, params, new CustomDataSource(data));

运行

典型应用：

  • MongoDB 文档集合
  • REST API 分页响应

数据源选择决策矩阵

数据类型适用场景性能表现开发复杂度引用来源
JDBC结构化数据库报表★★★★☆★★☆☆☆
JavaBean集合POJO 业务对象导出★★★★☆★☆☆☆☆
JSON微服务接口数据聚合★★★☆☆★★★☆☆
文件类离线数据批量处理★★☆☆☆★★★★☆
自定义非标系统集成★☆☆☆☆★★★★★

高级数据源特性

  1. 混合数据源
    支持主报表与子报表使用不同数据源（如主表用 JDBC，子表用 JSON）：
   <subreport><dataSourceExpression><![CDATA[new JsonDataSource($P{API_DATA})]]></dataSourceExpression></subreport>
  1. 动态数据切换
    通过 JRFillParameter 在运行时切换数据源：
   params.put(JRParameter.REPORT_DATA_SOURCE, ds1); // 初始数据源if (condition) params.replace(JRParameter.REPORT_DATA_SOURCE, ds2);

运行

  1. 虚拟化大数据集
    使用 JRFileVirtualizer 分页加载海量数据，避免内存溢出：
   JRVirtualizer virtualizer = new JRFileVirtualizer(100); // 每页100条params.put(JRParameter.REPORT_VIRTUALIZER, virtualizer);

运行

常见问题解决方案

  1. 空指针异常

    • 确保数据源不为 null，即使使用空数据源也需显式创建 JREmptyDataSource
    • 检查模板字段名与数据源属性大小写是否一致

  2. 性能优化

    • 启用分页模式：params.put(JRParameter.IS_IGNORE_PAGINATION, false)
    • 对 JDBC 数据源添加 SQL 分页查询

  3. 编码问题

    • JSON/CSV 数据源需统一使用 UTF-8 编码
    • 中文字体需在 jasperreports.properties 中注册

演进趋势

  1. 云原生数据源
    支持从 AWS S3、阿里云 OSS 直接读取文件
   OSSDataSource ds = new OSSDataSource("oss://bucket/report-data.csv");

运行

  1. 流式处理
    通过 Reactive Streams 实现实时数据推送
   Flux<Data> flux = service.getStreamingData();JasperPrint print = JasperFillManager.fillReport(jasperReport, params, new FluxDataSource(flux));

运行

  1. AI 增强
    自动推断数据源结构并生成适配模板
   AIDataSourceAnalyzer.analyze(ds).generateTemplate();

运行

通过灵活选择数据源类型并优化实现，JasperPrint 可覆盖从传统数据库到现代数据湖的全场景报表需求，其扩展性设计（如自定义 JRDataSource）为复杂企业级应用提供了坚实基础

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.rhkb.cn/news/26221.html

如若内容造成侵权/违法违规/事实不符，请联系长河编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

Python基于Django的网络课程在线学习平台【附源码】

Python基于Django的网络课程在线学习平台【附源码】

博主介绍&#xff1a;✌Java老徐、7年大厂程序员经历。全网粉丝12w、csdn博客专家、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java技术领域和毕业项目实战✌ &#x1f345;文末获取源码联系&#x1f345; &#x1f447;&#x1f3fb; 精彩专栏推荐订阅&#x1f447;&…
阅读更多...
58、深度学习-自学之路-自己搭建深度学习框架-19、RNN神经网络梯度消失和爆炸的原因（从公式推导方向来说明），通过RNN的前向传播和反向传播公式来理解。

58、深度学习-自学之路-自己搭建深度学习框架-19、RNN神经网络梯度消失和爆炸的原因（从公式推导方向来说明），通过RNN的前向传播和反向传播公式来理解。

一、RNN神经网络的前向传播图如下&#xff1a; 时间步 t1: x₁ → (W_x) → [RNN Cell] → h₁ → (W_y) → y₁ ↑ (W_h) h₀ (初始隐藏状态) 时间步 t2: x₂ → (W_x) → [RNN Cell] → h₂ → (W_y) → y₂ ↑ (W_h) h₁ 时间…
阅读更多...
【Qt-信号与槽】connect函数的用法

【Qt-信号与槽】connect函数的用法

&#x1f3e0;个人主页&#xff1a;Yui_ &#x1f351;操作环境&#xff1a;Qt Creator &#x1f680;所属专栏&#xff1a;Qt 文章目录 1.信号和槽的概念1.1 信号的本质1.2 槽的本质1.3 补充说明2. 信号和槽的使用2.1 connect函数介绍2.2 connect函数的简单使用2.2.1 图形化方…
阅读更多...
ESP32+Mixly-WiFi

ESP32+Mixly-WiFi

#include <WiFi.h> #include <TimeLib.h> #include <NtpClientLib.h>int8_t timeZone 8; // 时区设置&#xff0c;东八区为8 const PROGMEM char *ntpServer "ntp1.aliyun.com"; // NTP服务器地址void setup(){Serial.begin(9600); //初始化串口…
阅读更多...
Python 数据可视化（一）熟悉Matplotlib

Python 数据可视化（一）熟悉Matplotlib

目录 一、安装包 二、先画个折线图 1、修改标签文字和线条粗细 2、内置样式 3、scatter() 绘制散点图 4、scatter() 绘制多个点 5、设置样式 6、保存绘图 数据可视化指的是通过可视化表示来探索和呈现数据集内的规律。 一、安装包 win R 打开终端 安装 Matplotlib&…
阅读更多...
目标检测——数据处理

目标检测——数据处理

1. Mosaic 数据增强 Mosaic 数据增强步骤: (1). 选择四个图像&#xff1a; 从数据集中随机选择四张图像。这四张图像是用来组合成一个新图像的基础。 (2) 确定拼接位置&#xff1a; 设计一个新的画布(输入size的2倍)&#xff0c;在指定范围内找出一个随机点&#xff08;如…
阅读更多...
从零开始用react + tailwindcss + express + mongodb实现一个聊天程序(六) 导航栏 和 个人信息设置

从零开始用react + tailwindcss + express + mongodb实现一个聊天程序(六) 导航栏 和 个人信息设置

1.导航栏&#xff08;navbar&#xff09; 在components下面 创建NavBar.jsx import { MessageSquare,Settings,User,LogOut} from "lucide-react" import {Link} from "react-router-dom" import { useAuthStore } from "../store/useAuthStore&qu…
阅读更多...
如何通过 LlamaIndex 将数据导入 Elasticsearch

如何通过 LlamaIndex 将数据导入 Elasticsearch

作者&#xff1a;来自 Elastic Andre Luiz 逐步介绍如何使用 RAG 和 LlamaIndex 提取数据并进行搜索。 在本文中&#xff0c;我们将使用 LlamaIndex 来索引数据&#xff0c;从而实现一个常见问题搜索引擎。 Elasticsearch 将作为我们的向量数据库&#xff0c;实现向量搜索&am…
阅读更多...
yunedit-post ，api测试比postman更好

yunedit-post ，api测试比postman更好

postman应该是大家最熟悉的api测试软件了&#xff0c;但是由于它是外国软件&#xff0c;使用它的高端功能注册和缴费都比较麻烦。生成在线文档分享也经常无法访问被拦截掉。 这里可以推荐一下yunedit-post&#xff0c;该有的功能都有。 https://www.yunedit.com/postdetail …
阅读更多...
Gopeed 各种类型的文件资源下载器 v1.6.7 中文版

Gopeed 各种类型的文件资源下载器 v1.6.7 中文版

Gopeed 是一款由 Go 和 Flutter 开发的下载器。它具有简洁美观的界面以及强大的功能&#xff0c;支持 HTTP、BitTorrent、Magnet 等协议&#xff0c;并且可以在全平台上使用。 开发语言及技术&#xff1a;Gopeed 采用 Go 和 Flutter 进行开发。Go 语言具有高效、简洁的特点&am…
阅读更多...
3d投影到2d python opencv

3d投影到2d python opencv

目录 cv2.projectPoints 投影 矩阵计算投影 cv2.projectPoints 投影 cv2.projectPoints() 是 OpenCV 中的一个函数&#xff0c;用于将三维空间中的点&#xff08;3D points&#xff09;投影到二维图像平面上。这在计算机视觉中经常用于相机标定、物体姿态估计、3D物体与2D图…
阅读更多...
Linux操作系统5-进程信号3（信号产生总结与核心转储）

Linux操作系统5-进程信号3（信号产生总结与核心转储）

上篇文章&#xff1a;Linux操作系统5-进程信号2&#xff08;信号的4种产生方式&#xff0c;signal系统调用&#xff09;-CSDN博客 本篇Gitee仓库&#xff1a;myLerningCode/l25 橘子真甜/Linux操作系统与网络编程学习 - 码云 - 开源中国 (gitee.com) 本篇重点&#xff1a;核心…
阅读更多...
Linux《基础开发工具（上）》

Linux《基础开发工具（上）》

在之前的篇章当中我们已经了解了Linux当中基本的指令以及相关的知识&#xff0c;那么接下来在本篇当中就开始学基本的开发工具&#xff0c;在此我们一共要了解6大开发工具&#xff0c;在此将这些工具的学习分为上中下篇&#xff0c;在本篇当中我们首先要来学习的是yun以及vim,一…
阅读更多...
kali liux的下载

kali liux的下载

Kali Linux | Penetration Testing and Ethical Hacking Linux Distributionhttps://www.kali.org/ VMware虚拟机https://pan.quark.cn/s/aa869ffbf184 【补充一个今天学到的知识昂和内容无关:&#xff08;遥感&#xff09;指非接触的远距离探测技术&#xff0c;使用传感器探…
阅读更多...
微软AI900认证备考全攻略：开启AI职业进阶之路

微软AI900认证备考全攻略：开启AI职业进阶之路

在当今数字化时代&#xff0c;人工智能&#xff08;AI&#xff09;正深刻地改变着我们的工作和生活。微软AI900认证作为AI领域的权威认证之一&#xff0c;不仅为技术爱好者提供了深入探索AI的机会&#xff0c;更是开启AI职业进阶之路的重要敲门砖。以下是一份全面的备考攻略&am…
阅读更多...
【Mark】记录用宝塔+Nginx+worldpress+域名遇到的跨域，301，127.0.0.1，CSS加载失败问题

【Mark】记录用宝塔+Nginx+worldpress+域名遇到的跨域，301，127.0.0.1，CSS加载失败问题

背景 想要用宝塔搭建worldpress&#xff0c;然后用域名直接转https&#xff0c;隐藏掉ipport。 结果被折磨了1天&#xff0c;一直在死活在301&#xff0c;127.0.0.1打转 还有css加载不了的情况 因为worldpress很多是301重定向的&#xff0c;所以改到最后我都不知道改了什么&am…
阅读更多...
算法题001——移动零

算法题001——移动零

移动零 力扣——移动零点击链接即可跳转 这道题的数组被划分为两个区间&#xff0c;前一个区间为 非零元素&#xff0c;而后一个指针是 零元素 我们运用双指针&#xff0c;先定义两个指针&#xff0c;分别为 dest 和 cur , cur用来遍历整个数组&#xff0c;而 dest 表示我们…
阅读更多...
Selenium自动化测试：如何搭建自动化测试环境，搭建环境过程应该注意的问题

Selenium自动化测试：如何搭建自动化测试环境，搭建环境过程应该注意的问题

最近也有很多人私下问我&#xff0c;selenium学习难吗&#xff0c;基础入门的学习内容很多是3以前的版本资料&#xff0c;对于有基础的人来说&#xff0c;3到4的差别虽然有&#xff0c;但是不足以影响自己&#xff0c;但是对于没有学过的人来说&#xff0c;通过资料再到自己写的…
阅读更多...
mysql 全方位安装教程

mysql 全方位安装教程

下载 MySQL 【官网下载地址】 注意要选择较大的哪个安装包&#xff0c;小的安装包是一个安装器。 我们不用登录&#xff0c;直接下载 直接运行下载好的安装包 MySQL如果是 安装包安装, 可以图形化界面自主配置 如果是压缩包解压, 可以配置 配置文件, 可以解压安装到指定的…
阅读更多...
深入刨析 之C++ string类

深入刨析 之C++ string类

欢迎来到干货小仓库&#xff01;&#xff01;&#xff01; 没有完美的计划&#xff0c;每个人都在试验的过程中渐渐清晰!!! 1.标准库的string类 a. string是表示字符串的字符串类。 b. 该类的接口与常规容器的接口基本相同&#xff0c;再添加了一些专门用来操作string的常规操…
阅读更多...
最新文章
推荐文章

Copyright @ 2022~2023