1. 概述
1.1 应用场景
可以通过 java 程序读取一个模板,读取后在程序中修改报表的属性,然后重新导出成模板文件。如下图所示,读取模板文件Parameter.cpt,在程序中修改 A1 单元格的字体为红色,然后导出成模板文件,导出后在设计器打开模板,A1 单元格字体变成红色。
1.2 实现原理
1)读取某一路径下的模板 cpt 文件,并将其转为 WorkBook 对象,有两种读取报表的方法:
直接以文件绝对路径读取;
先定义报表运行环境,然后从运行环境中直接读取相对路径下的模板。
绝对路径读取模板:
WorkBook workbook = (WorkBook) TemplateWorkBookIO
.readTemplateWorkBook(
"/doc/Primary/Parameter/Parameter.cpt");
读取报表运行环境:
// 定义报表运行环境,用于执行报表
String envpath = "C:\\FineReport_10.0\\webapps\\webroot\\WEB-INF";//工程路径
SimpleWork.checkIn(envpath);
module.start();
2)修改报表单元格属性
// 获得WorkBook中的WorkSheet,进而修改A1单元格的前景色为红色
TemplateElementCase report = (TemplateElementCase) workbook
.getReport(0);
// getCellElement(int column, int row),column和row都从0开始,因此A1单元格便是第0列第0行
CellElement cellA1 = report.getCellElement(0, 0);
FRFont frFont = FRFont.getInstance();
frFont = frFont.applyForeground(Color.red);
Style style = Style.getInstance();
style = style.deriveFRFont(frFont);
cellA1.setStyle(style);
3)将修改过的模板重新导出
//保存模板
FileOutputStream outputStream = new FileOutputStream(new File(
"C:\\test\\newParameter1.cpt"));
((WorkBook) workbook).export(outputStream);
2. 示例
以下示例读取内置模板 Parameter.cpt 修改 A1 单元格字体样式后,将结果导出成 cpt 文件。
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 编写 Java 程序
在编辑器中编写 Java 程序 SimpleDemo.java,即读取内置模板 Parameter.cpt 修改 A1 单元格字体样式后,将结果导出成 cpt 文件。完整代码可参见:
注:用户使用时,注意将示例代码中的工程路径、模板名称和导出路径替换为用户自己工程下的。
https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/io/SimpleDemo.java
2.3 编译 Java 文件
Java 程序编写完成后,在编译器中编译 SimpleDemo.java ,编译通过后,就会在代码中导出路径的文件夹下生成修改过的新文件 newParameter1.cpt,这样就实现了读取模板后修改模板。用设计器打开导出模板,可以看到,A1 单元格的颜色变成了红色。如下图所示: