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

目录:

1. 概述编辑

1.1 应用场景

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

本文将会通过一个简单示例,讲解如何定义和使用程序数据集。示例将通过 Java 程序,自定义一个简单数据表,用来制作报表。

1.2 实现原理

SimpleTableData 抽象类中定义了数据源相关的属性和方法,用户如果想要自定义程序数据集,可以在定义类的时候继承SimpleTableData 类,这样就可以使用其上的方法定义程序数据源,定义好后 FineReport 报表引擎就能够读取定义的数据源作为报表数据源使用。

2. 示例编辑

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

Name
Score
Alex15
Helly22
Bobby99

2.1 准备编译环境

编译程序前,需先创建一个 Java 工程环境,并且需要一个 Java 编辑器,如 Eclipse 或 idea 。

在编辑器工程中导入 FineReport 工程 JAR 包。包括报表工程

%FR_HOME%/lib下的所有的包,

%FR_HOME%/server/lib 下的所有包,

%FR_HOME%/webapps/webroot/WEB-INF/lib下的所有包,

还要引入 JDK 下的 tools.jar。详细操作可参考:编译Java程序 

2.2 定义程序数据源

2.2.1 编写 Java 程序

在编辑器中编写 Java 程序 SimpleArrayTableDataDemo.java,即定义一个类,继承 SimpleTableData ,定义数据列和数据。 

完整代码可参见:

注:建议文件的包名路径和如下代码中一致,若不一致,要保证在 2.3 节 %FR_HOME%webapps/webroot/WEB-INF/classes 工程路径下有对应的文件夹。且代码中需要手动引入 SimpleTableData,即代码中加入 import com.fr.data.SimpleTableData;

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

2.2.2 编译 Java 文件

Java 程序编写完成后,在编译器中编译 SimpleArrayTableDataDemo.java ,编译通过后,将会在编译器对应工程文件存储路径下生成 SimpleArrayTableDataDemo.class 类文件。如下图所示:

2.2.3 导入 class 文件

将编译后生成的 SimpleArrayTableDataDemo.class 类文件文件复制到 %FR_HOME%webapps/ webroot/WEB-INF/classes/com/fr/data 工程目录下,此时该程序数据源便定义好了。如下图所示:

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

点击下载 class 文件:SimpleArrayTableDataDemo.rar

2.3 创建程序数据集

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

选定 class 文件后,点击保存后即完成了程序数据源配置。

2.4 使用程序数据集

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

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