历史版本12 :遍历单元格 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1.描述编辑
有时候我们需要对报表每个单元格进行处理，如何在程序中遍历单元格呢？FineReport中通过Report的cellIterator()方法获取Report中所有的单元格，这些单元格放在Iterator中，可以像遍历普通的Iterator对象一样遍历Iterator中的单元格，从而对单元格进行处理或作其他操作。
根据需要您可以遍历所有单元格或者仅对部分单元格进行遍历，遍历方法我们在该文档中会一一说明，最后通过一个实际应用来展示遍历单元格的功效。
2. 实现原理编辑
2.1 获取报表
遍历单元格前我们需要获取单元格所在的容器Report，我们以Group.cpt为例，如下
// 读取模板保存为WorkBook对象
workbook = TemplateWorkBookIO.readTemplateWorkBook(oldEnv,
"\\doc\\Primary\\GroupReport\\Group.cpt");
2.2 遍历所有单元格
//定义迭代器遍历所有单元格
java.util.Iterator it = report.getDefaultBlock().cellIterator();
while(it.hasNext()){
TemplateCellElement cell = (TemplateCellElement) it.next();
//以下为遍历时对单元格进行操作的代码，可以根据需要自行定义
System.out.println("行：" + cell.getRow() + " 列：" + cell.getColumn() + " 值：" + cell.getValue().toString());
}
2.3 遍历部分单元格
/*
* 定义迭代器遍历选中的单元格使用intersect(int column, int row, int width, int height)选择某片区域的单元格
* column ：最左边的列，从0开始
* row ：最上面的行，从0开始
* width ：列宽
* height ：行高
*/
java.util.Iterator it = report.intersect(2, 1, 2, 3);
while(it.hasNext()){
TemplateCellElement cell = (TemplateCellElement) it.next();
//以下为遍历时对单元格进行操作的代码，可以根据需要自行定义
System.out.println("行：" + cell.getRow() + " 列：" + cell.getColumn() + " 值：" + cell.getValue().toString());
}
3. 具体实例编辑
3.1 横纵向切换报表
实现思路，首先通过输入的变量决定是否需要横纵向切换显示，若需要则遍历单元格，将单元格的行号与列号互换即可。
Group.cpt如下
将该模板读入程序，根据传入的参数change的值来进行横纵向控制，当change没有值或者值为0时，为原显示效果；若change值为1，则切换报表行与列，最后转为网络报表，完整代码如下
//遍历单元格
package com.fr.demo;
import java.util.Map;
import com.fr.base.Env;
import com.fr.base.FRContext;
import com.fr.report.cell.TemplateCellElement;
import com.fr.report.elementcase.TemplateElementCase;
import com.fr.report.worksheet.WorkSheet;
import com.fr.web.core.Reportlet;
import com.fr.web.request.ReportletRequest;
import com.fr.main.TemplateWorkBook;
import com.fr.io.TemplateWorkBookIO;
public class ChangeRowAndCol extends Reportlet {
public TemplateWorkBook createReport(ReportletRequest reportletrequest) {
// 定义最终需要返回的WorkBook对象
TemplateWorkBook workbook = null;
Env oldEnv = FRContext.getCurrentEnv();
WorkSheet newworksheet = new WorkSheet();
String change = "0";
try {
// 读取模板保存为WorkBook对象
workbook = TemplateWorkBookIO.readTemplateWorkBook(oldEnv,
"\\doc\\Primary\\GroupReport\\Group.cpt");
// 读取请求中的参数判断是否需要切换行列显示，0表示不切换，1表示切换
if (reportletrequest.getParameter("change") != null) {
change = reportletrequest.getParameter("change").toString();
}
if (change.equals("1")) {
// 获得单元格需要首先获得单元格所在的报表
TemplateElementCase report = (TemplateElementCase) workbook
.getTemplateReport(0);
// 遍历单元格
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);
}
// 替换原sheet
workbook.setReport(0, newworksheet);
}
} catch (Exception e) {
e.printStackTrace();
}
return workbook;
}
@Override
public void setParameterMap(Map arg0) {
// TODO Auto-generated method stub
}
@Override
public void setTplPath(String arg0) {
// TODO Auto-generated method stub
}
}
3.2发布与预览
将编译生成的类文件ChangeRowAndCol.class放于报表工程%FR_HOME%\WebReport\WEB-INF\classes\com\fr\demo下，启动服务器，在浏览器地址中输入如:http://localhost:8075/WebReport/ReportServer?reportlet=com.fr.demo.ChangeRowAndCol，结果如下:
浏览器地址中添加参数，修改地址如下:
http://localhost:8075/WebReport/ReportServer?reportlet=com.fr.demo.ChangeRowAndCol&change=1，结果如下:
这样，横纵向切换报表显示便实现了。