遍历单元格

1.1 应用场景

定义了单元格后，有时候我们需要对报表每个单元格进行处理，如何在程序中遍历单元格呢？

1.2 实现原理

FineReport 中通过 Report 的 cellIterator() 方法获取 Report 中所有的单元格，这些单元格放在 Iterator 中，可以像遍历普通的 Iterator 对象一样遍历 Iterator 中的单元格，从而对单元格进行处理或作其他操作。

1）获取报表

遍历单元格前我们需要获取单元格所在的容器 Report，我们以 Group.cpt 为例，如下所示：

// 读取模板保存为WorkBook对象  
workbook = TemplateWorkBookIO.readTemplateWorkBook("/doc/Primary/GroupReport/Group.cpt");

// 遍历单元格  
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.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 后，必须重启工程才能生效，否则一直都是展示原来的模板。

https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/demo/ChangeRowAndCol.java

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，结果如下图所示：

这样，报表行列切换就实现了。