1. 概述
1.1 应用场景
如果数据库表中某个字段所存的数据为 XML 格式。如下图所示:
那么如何将存于 XML 字段中的值读取出来作为报表数据源使用呢。如下图所示:
1.2 实现原理
通过程序连接目标数据库后,执行 SQL 查询语句,将表数据全部查询出来,通过一个数据提取 GetXmlDate类,将 XML 数据解析出来,将解析后的数据存成多个数据列,然后在设计器中创建程序数据集使用。
2. 示例
示例将实现 1.1 中的效果,将数据库表内 XML 格式的数据提取出来使用,数据存在 MySql 数据库的 xmltest 表中。表中每条 XML 记录数据如下:
注:完成此示例前,需在数据库准备一个含有 XML 类型数据的数据表,如 1.1 节中所示。
<Field><Name>MemoryFreeSize</Name><Type>int</Type><Value>1962</Value></Field> <Field><Name>MemoryTotalSize</Name><Type>int</Type><Value>2047</Value></Field> <Field><Name>MemoryUsage</Name><Type>int</Type><Value>4</Value></Field>
<Field><Name>MemoryFreeSize</Name><Type>Int</Type><Value>1999</Value></Field> <Field><Name>MemoryTotalSize</Name><Type>Int</Type><Value>2048</Value></Field> <Field><Name>MemoryUsage</Name><Type>Int</Type><Value>10</Value></Field>
<Field><Name>MemoryFreeSize</Name><Type>Int</Type><Value>2000</Value></Field> <Field><Name>MemoryTotalSize</Name><Type>Int</Type><Value>2050</Value></Field> <Field><Name>MemoryUsage</Name><Type>Int</Type><Value>15</Value></Field>
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 定义程序数据源
连接目标数据库后,执行sql查询语句,将 xmltest 表数据全部查询出来,对于 ID、NAME 字段的值我们将其直接存于新的结果集 ArrayList 中,对于 XML 字段我们通过GetXmlDate类对其进行解析后再转入 ArrayList 中。
2.2.1 编写Java文件
1)在编辑器中编写 Java 文件 GetXmlDate.java,实现对于XML 字段进行解析的功能。完整代码可参见:
https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/data/GetXmlDate.java
2)在编辑器中定义类 XMLRead.java,继承 AbstractTableData 接口,实现 getColumnCount、getColumnName、getRowCount、getValueAt 四个方法。完整代码可参见:
注:代码中的数据库连接信息和数据表信息需要改成用户自己存放 xmltest 表的信息。
https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/data/XMLRead.java
2.2.2 编译Java文件
Java 文件编写完成后,在编译器中首先编译 GetXmlDate.java 然后再编译 XMLRead.java。编译通过后,将会在编译器对应工程文件存储路径下生成 class 文件。如下图所示:
将其放于WEB-INF/classes/com/fr/data下。
2.2.3 导入class文件
将以上编译后生成的所有类文件复制到 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data工程目录下。如下图所示:
注:远程设计时,本地设计器和远程服务器的工程下都需要放置程序数据集对应的 class 文件。
2.3 创建程序数据集
新建普通报表,数据集管理面板新建「程序数据集」,选择我们定义好的程序数据集 XMLRead.class 文件。如下图所示:
2.4 使用程序数据源
配置好程序数据源后便可以使用自定义的程序数据集,与其他类型的数据集使用方法相同,可以通过拖拽方法实现单元格数据列绑定。如下图所示:
以上数据库表字段为 XML 类型的数据就实现了转换为报表数据源使用。