1. 概述
1.1 应用场景
同样的模板样式,同样的数据源样式,希望通过网络报表连接不同数据库,使用同一个模板样式,在同一个网络报表里面显示结果,但数据来源不同。
1.2 实现原理
通过使用程序网络报表所在类需要继承 com.fr.web.reportlet 这个抽象类,并且需要实现 createReport(ReportletRequest arg0) 这个方法,并返回报表对象。
对返回的报表对象设置新的数据集,通过 putTableData(DSName,tableData) 方法,将定义的数据集添加到报表中,从而改变模板数据,DSName 是定义的数据集名例如 ds1,tableData 是调用数据集。
2. 示例
以下示例通过程序网络报表将一个模板的内置数据集替换成一个程序数据源数据。
2.1 准备模板和数据源
1)新建一个模板,新建一个内置数据集 ds2,将 ds2 中的字段拖拽到报表中,设计报表样式,保存模板为 1.cpt 。如下图所示:
点击可下载模板:1.cpt
2)如上模板中数据源用了内置数据集,如果要把内置数据集替换成程序数据集,就需要提前准备程序数据源。
程序数据集可以获取不同数据库里面的值,用户可以通过 Java 编辑器编译后存成 class 调用。这里使用已经编译好的简单程序数据源 ArrayTableDataDemo 替换模板中的内置数据集 ds2,程序数据源 ArrayTableDataDemo 如何准备可参考:简单程序数据集
2.2 准备编译环境
编译程序前,需先创建一个 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.3 定义程序网络报表
2.3.1 编写 Java 程序
在编辑器中编写 Java 程序 NewDateDemo.java,其中实现读取模板 1.cpt 后将其数据源换成 ArrayTableDataDemo 程序数据源。
完整代码可参见:
注:修改 Java ,重新编译生成 class ,替换原有 class 后,必须重启工程才能生效,否则一直都是展示原来的模板。
注意代码中要调用 ArrayTableDataDemo 类,所以编译以下程序时,工程中必须提前编译了 ArrayTableDataDemo类。
https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/demo/NewDateDemo.java
2.3.2 编译 Java 文件
Java 程序编写完成后,在编译器中编译 NewDateDemo.java ,编译通过后,将会在编译器对应工程文件存储路径下生成 NewDateDemo.class 类文件。如下图所示:
点击下载 class 文件:NewDateDemo.rar
2.3 发布并在 Web 端预览
将编译后的 NewDateDemo.class 放到报表工程 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\demo目录下。如下图所示:
启动服务器,在浏览器中输入访问报表工程文件的路径,如使用本地设计器工程,启动后在浏览器端输入http://localhost:8075/webroot/decision/view/report?viewlet=com.fr.demo.NewDateDemo便可以预览报表。如下图所示: