1. 概述
1.1 应用场景
定义了单元格后,有时候我们需要对报表每个单元格进行处理,如何在程序中遍历单元格呢?
1.2 实现原理
FineReport 中通过 Report 的 cellIterator() 方法获取 Report 中所有的单元格,这些单元格放在 Iterator 中,可以像遍历普通的 Iterator 对象一样遍历 Iterator 中的单元格,从而对单元格进行处理或作其他操作。
1)获取报表
遍历单元格前我们需要获取单元格所在的容器 Report,我们以 Group.cpt 为例,如下所示:
// 读取模板保存为WorkBook对象
workbook = TemplateWorkBookIO.readTemplateWorkBook("/doc/Primary/GroupReport/Group.cpt");
2)遍历单元格// 遍历单元格
int col = 0, row = 0;
byte direction = 0;
java.util.Iterator it = report.cellIterator();
while (it.hasNext()) {
TemplateCellElement cell = (TemplateCellElement) it.next();
// 获取单元格的行号与列号并互换
col = cell.getColumn();
row = cell.getRow();
cell.setColumn(row);
cell.setRow(col);
// 获取原单元格的扩展方向,0表示纵向扩展,1表示横向扩展
direction = cell.getCellExpandAttr().getDirection();
if (direction == 0) {
cell.getCellExpandAttr().setDirection((byte) 1);
} else if (direction == 1) {
cell.getCellExpandAttr().setDirection((byte) 0);
}
// 将改变后的单元格添加进新的WorkSheet中
newworksheet.addCellElement(cell);
}
2. 示例
如下通过遍历单元格实现报表根据不同的参数值实现行列切换。如下图所示:
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 程序
通过程序报表实现,原 Group.cpt 如下,当输入的变量需要行列转换时,则遍历单元格,将单元格的行号与列号互换即可。
将该模板读入程序,根据传入的参数 change 的值来进行横纵向控制
当 change 没有值或者值为 0 时,为原显示效果;
当 change 值为1,则切换报表行与列,最后转为网络报表。
在编辑器中编写 Java 程序 ChangeRowAndCol.java,其中实现不同参数值不同的报表呈现方式。
完整代码可参见:
注:修改 Java ,重新编译生成 class ,替换原有 class 后,必须重启工程才能生效,否则一直都是展示原来的模板。
2.2.2 编译 Java 文件
Java 程序编写完成后,在编译器中编译 ChangeRowAndCol.java ,编译通过后,将会在编译器对应工程文件存储路径下生成 ChangeRowAndCol.class 类文件。如下图所示:
点击下载 class 文件:ChangeRowAndCol.rar
2.3 发布并在 Web 端预览
将编译后的 ChangeRowAndCol.class 放到报表工程 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\demo目录下。如下图所示:
启动服务器,在浏览器中输入访问报表工程文件的路径,如使用本地设计器工程,启动后在浏览器端输入http://localhost:8075/webroot/decision/view/report?viewlet=com.fr.demo.ChangeRowAndCol便可以预览报表。如下图所示:
浏览器地址中添加参数 &change=1 ,修改地址如下:
http://localhost:8075/webroot/decision/view/report?viewlet=com.fr.demo.ChangeRowAndCol&change=1,结果如下图所示:
这样,报表行列切换就实现了。