历史版本23 :简单程序数据集 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

实际应用中,用户可能需要通过程序来获取数据。FineReport 支持程序数据集,用户自定义程序数据源后,可在数据集处添加「程序」数据集使用。

本文将会通过一个简单示例,讲解如何定义和使用程序数据集。示例将通过 Java 程序,获取到 FRDdemo 数据连接下「销量」表的数据,用来制作报表。

1.2 实现原理

FineReport 是通过 AbstractTableData 抽象类来读取数据源的,所有的数据来源都继承实现其抽象方法。因此用户只要实现了 AbstractTableData 抽象类,就可以用自定义类型的数据源,FineReport 报表引擎就能够读取定义的数据源作为报表数据源使用。

自定义 Java 代码思路为:

1) 定义数据表结构

2)实现构建函数,在构建函数中准备数据

3)实现 AbstractTableData 抽象类

2. 示例编辑

下面实现自定义数据源,作为程序数据集使用。数据如下表所示:

Name
Score
Alex15
Helly22
Bobby99

2.1 定义程序数据源

定义一个类,继承 AbstractTableData,并实现里面的方法,在代码中准备了数据。详细代码参见:

注:远程设计时情况下,自定义程序数据集中定义的数据字段必须是可序列化的,不然数据集预览会报错。

https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/data/ArrayTableDataDemo.java

2.2 编译 class 文件

将 ArrayTableDataDemo.java 编译生成 ArrayTableDataDemo.class 类。

编译 class 文件前先要引入 FineReport 的 jar 包文件,具体可参考 编译Java程序 内容。

将 java 文件和生成的 class 文件拷贝到报表工程目录下。由于该文件属于 com.fr.data 包,因此需将 ArrayTableData.class 和 ArrayTableData.java 放在%FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data 目录下,此时该程序数据源便定义好了。

注:远程设计时,本地设计器和远程服务器的工程下都需要放置程序数据集对应的 class 文件和 java 文件。

2.3 配置程序数据源

点击模板数据集下面的加号,选择「程序」数据集,在弹出的程序数据集对话框中,选择对应的 class 文件,如下图所示:

2020-11-18_11-05-42.png

选定 class 文件后,在设计器中编译保存后才可以正常使用,如下图所示:

注:class 文件对应的 Java 文件也要放置在 class 文件所在的位置,否则无法编译,显示://Didn't find java source match the class

image.png

2.4 使用程序数据集

配置好程序数据源后便可以使用自定义的程序数据集,与其他类型的数据集使用方法相同,可以通过拖拽方法实现单元格数据列绑定。如下图所示:

2020-11-18_11-25-38.png