1. 概述
1.1 应用场景
在实际应用中,可能需要根据表名动态地改变数据源,比如在程序数据集中,通过传进的表名参数,到数据库取出对应的表作为数据源。
1.2 实现原理
SimpleTableData 抽象类中定义了数据源相关的属性和方法,用户如果想要自定义程序数据集,可以在定义类的时候继承SimpleTableData 类,这样就可以使用其上的方法定义程序数据源,定义好后 FineReport 报表引擎就能够读取定义的数据源作为报表数据源使用。
2. 示例
示例将以 FRDemo 数据连接为例,参数为数据表名,不同的参数值,程序数据集将获取到 FRDemo 中不同的表数据。
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 文件 SimpleParamTableDataDemo.java, 完整代码可参见:
注:建议文件的包名路径和如下代码中一致,若不一致,要保证在 2.3 节 %FR_HOME%webapps/webroot/WEB-INF/classes 工程路径下有对应的文件夹。且代码中需要手动引入 SimpleTableData,即代码中加入 import com.fr.data.SimpleTableData;
2.2.2 编译Java文件
Java 文件编写完成后,在编译器中编译 SimpleParamTableDataDemo.java ,编译通过后,将会在编译器对应工程文件存储路径下生成 SimpleParamTableDataDemo.class 类文件。如下图所示:
2.2.3 导入class文件
将编译后生成的 SimpleParamTableDataDemo.class 类文件复制到 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data工程目录下。如下图所示:
注1:远程设计时,本地设计器和远程服务器的工程下都需要放置程序数据集对应的 class 文件。
点击下载 class 文件:SimpleParamTableDataDemo.rar
2.3 创建程序数据集
1)新建普通报表,数据集管理面板新建程序数据集,选择我们已经定义好的 class 文件,如下图所示:
2)添加默认参数,参数名为 tableName,如下图所示:
2.4 使用程序数据集
1)选中新建的程序数据集,点击预览按钮,输入参数值,如下图所示:
2)查询出的销量表如下图所示,将字段拖入报表中即可用作报表数据。
注:如果预览不出数据,请确认代码段里面定义数据库连接时 URL 的地址是否正确、数据连接名称是否正确。如下图所示:
3. 注意事项
3.1 决策报表中程序数据集参数名冲突
问题描述:
决策报表中创建了多个程序数据集,每个数据集的参数名都是一样的,只是参数值不同,在PC端预览时出现展示的数据都是相同的。
原因分析:
决策报表中如果多个程序数据集的参数名一样,会产生冲突。
解决方案:
决策报表中程序数据集的名称不能相同,如果存在相同的名称需要修改成不同的。