1. 概述编辑
1.1 应用场景
电脑某个目录下保存了几个 XML 文件,希望把 XML 文件转换为报表数据源。如下图所示,将 Northwind.xml 中的数据转换为报表数据源。
Northwind.xml 文件内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<Northwind>
<Customers>
<CustomerID>ALFKI</CustomerID>
<CompanyName>ALfreds Futterkiste</CompanyName>
<ContactName>Maria Anders</ContactName>
<ContactTitle>Sales Representative</ContactTitle>
<Address>Obere Str.57</Address>
<City>Berlin</City>
<PostalCode>12209</PostalCode>
<Country>Germany</Country>
<Phone>030-0074321</Phone>
<Fax>030-0076545</Fax>
</Customers>
</Northwind>
通过程序数据集转换成报表数据源:
当目录下有多个文件时,就可以定义参数,最终实现根据不同的文件名动态获取不同的 XML 中的内容作为报表数据源。如下图所示:
1.2 实现原理
FineReport 中可以通过自定义程序数据集来对 XML 字段数据进行解析,再通过参数的方式,动态获取 XML 文件名,最终作为报表数据源。
2. 示例编辑
示例将实现 1.1 中的效果,定义程序数据集,通过文件名,获取特定目录下的 XML 格式数据,最终解析成适合制作报表的行式数据。
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文件
1)在编辑器中编写 Java 文件,首先定义参数 name 及 type ,供其他类直接调用,安全性比较高。完整代码可参见:
2)在编辑器中定义定义 XMLParseDemoDataModel.java 类继承 AbstractDataModel 接口,实现 getColumnCount、getColumnName、getRowCount、getValueAt 四个方法。完整代码可参见:
注:代码中的数据库连接信息和数据表信息需要改成用户自己存放 xmltest 表的信息。https://git.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/data/XMLParseDemoDataModel.java
3)定义程序数据集 XMLDemoTableData,其中定义一个参数 $filename,动态获取某个路径下的 XML 文件内容,并将其解析成数据列,数据列名称和 XML 内字段名称是一一对应。完整代码可参见:
注1:如果 XML 文件的格式与问题描述处所展示的 XML 格式不一致,则需要修改类中的 deep 变量,把列名所在的节点层数改成相对应的数值。
注2:注意代码中XML文件存放的位置要修改为用户自己的文件路径。
2.2.2 编译Java文件
Java 文件编写完成后,在编译器中依次编译。编译通过后,将会在编译器对应工程文件存储路径下生成 class 文件。如下图所示:
2.2.3 导入class文件
将以上编译后生成的所有类文件复制到 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data工程目录下。如下图所示:
注:远程设计时,本地设计器和远程服务器的工程下都需要放置程序数据集对应的 class 文件。
2.3 创建程序数据集
1)新建普通报表,数据集管理面板新建程序数据集,选择我们定义好的程序数据集 XMLDemoTableData.class文件。如下图所示:
2)选择 class 后添加一个默认参数 filename,值为 Northwind,如下图所示:
在模板数据集窗口,点击预览按钮,弹出参数对话框,输入要显示的 XML 文件名称,点击确定则可以把 Northwind.xml 文件里面的数据读取出来转换报表数据源了,如下图:
2.4 使用程序数据集
配置好程序数据源后便可以使用自定义的程序数据集,与其他类型的数据集使用方法相同,可以通过拖拽方法实现单元格数据列绑定。如下图所示: