1. 概述编辑
FineReport 报表的数据来源可以是数据库数据或是文本数据,并且还可以是其它类型的数据。
FineReport 通过 AbstractTableData 抽象类来读取数据源,上述所有的数据来源都继承 AbstractTableData 类实现抽象方法,因此用户只要实现了 AbstractTableData 抽象类,FineReport 报表引擎就能够读取用户自定义的数据源。
FineReport 支持程序数据集,用户自定义程序数据源后,可在数据集处添加「程序」数据集使用。如下图所示:
2. 原理编辑
AbstractTableData 抽象类主要有4个方法,如下:
//获取 AbstractTableData 的总列数
public int getColumnCount();
//获取 AbstractTableData 中第 columnIndex 列的列名
public String getColumnName(int columnIndex);
//获取 AbstractTableData 的总行数
public int getRowCount();
//获取 AbstractTableData 中第 columnIndex 列,第 rowIndex 行的数据,在某些应用场景中,需要在程序中对数据进行处理后再作为报表的数据源使用。
public Object getValueAt(int rowIndex, int columnIndex);
3. 示例编辑
下面实现自定义数据源,作为程序数据集使用。数据如下表所示:
Name | Score |
---|---|
Alex | 15 |
Helly | 22 |
Bobby | 99 |
3.1 定义程序数据源
定义一个类,继承 AbstractTableData,并实现里面的方法,在代码中准备了数据。详细代码参见:
注:远程设计时情况下,自定义程序数据集中定义的数据字段必须是可序列化的,不然数据集预览会报错。
3.2 编译 class 文件
将 ArrayTableDataDemo.java 编译生成 ArrayTableDataDemo.class 类。
编译 class 文件前先要引入 FineReport 的 jar 包文件,具体可参考 Eclipse中启动设计器 第 2.3 节内容。
将 java 文件和生成的 class 文件拷贝到报表工程目录下。由于该文件属于 com.fr.data 包,因此需将 ArrayTableData.class 和 ArrayTableData.java 放在%FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data 目录下,此时该程序数据源便定义好了。
注:远程设计的情况下,程序数据集对应的 class 文件和 java 文件要放在远程服务器对应的工程目录下。
3.3 配置程序数据源
点击模板数据集下面的加号,选择「程序」数据集,在弹出的程序数据集对话框中,选择对应的 class 文件,如下图所示:
选定 class 文件后,在设计器中编译保存后才可以正常使用,如下图所示:
注:class 文件对应的 Java 文件也要放置在 class 文件所在的位置,否则无法编译,显示://Didn't find java source match the class
3.4 使用程序数据集
配置好程序数据源后便可以使用自定义的程序数据集,与其他类型的数据集使用方法相同,可以通过拖拽方法实现单元格数据列绑定。如下图所示: