历史版本37 :带参程序数据集 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

在实际应用中,可能需要根据表名动态地改变数据源,比如在程序数据集中,通过传进的表名参数,到数据库取出对应的表作为数据源。

1.2 实现原理

FineReport 是通过 AbstractTableData 抽象类来读取数据源的,而上述所有的数据来源都继承实现其抽象方法。

因此用户只要实现了 AbstractTableData 抽象类,也就可以用自定义类型的数据源了(程序数据集),FineReport 报表引擎就能够读取定义的数据源作为报表数据源使用。

下面将举例说明。

2. 操作步骤编辑

2.1 定义数据表结构

定义数据表结构,代码如下:

/**
 * 构造函数,定义表结构,该表有10个数据列,列名为column#0,column#1,。。。。。。column#9
 */
public ParamTableDataDemo() {
    columnNames = new String[columnNum];
    for (int i = 0; i < columnNum; i++) {
        columnNames[i] = "column#" + String.valueOf(i);
    }

2.2 设置数据

将数据放入到定义的表中,代码如下:

/**
 * 准备数据
 */
private void init() {
    // 确保只被执行一次
    if (valueList != null) {
        return;
    }
    // 保存得到的数据库表名
    String tableName = ((ParameterProvider) (parameters.get().toArray())[0]).getValue().toString();
    // 构造SQL语句,并打印出来
    String sql = "select * from " + tableName;
    FRContext.getLogger().info("Query SQL of ParamTableDataDemo: \n" + sql);
    // 保存得到的结果集
    valueList = new ArrayList();
    // 下面开始建立数据库连接,按照刚才的SQL语句进行查询
    com.fr.data.impl.Connection conn = DatasourceManager.getInstance().getConnection("FRDemo");
    try {
        Connection con = conn.createConnection();
        Statement stmt = con.createStatement();
        ResultSet rs = stmt.executeQuery(sql);
        // 获得记录的详细信息,然后获得总列数
        ResultSetMetaData rsmd = rs.getMetaData();
        colNum = rsmd.getColumnCount();
        // 用对象保存数据
        Object[] objArray = null;
        while (rs.next()) {
            objArray = new Object[colNum];
            for (int i = 0; i < colNum; i++) {
                objArray[i] = rs.getObject(i + 1);
            }
            // 在valueList中加入这一行数据
            valueList.add(objArray);
        }
        // 释放数据库资源
        rs.close();
        stmt.close();
        con.close();
        // 打印一共取到的数据行数量
    } catch (Exception e) {
        e.printStackTrace();
    }

2.3 完整的数据集代码

完整的带参程序数据集代码请参见:

https://git.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/data/ParamTableDataDemo.java

2.4 编译 class 文件

编译 ParamTableDataDemo.java ,将生成的 ParamTableDataDemo.class 类文件拷贝到报表工程 %FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\data目录下,此时该程序数据源便定义好了。

点击下载 class 文件:ParamTableDataDemo.rar

2.5 配置程序数据集

1)新建普通报表,数据集管理面板新建程序数据集,选择我们已经定义好的 class 文件,如下图所示:

Snag_6597dcb.png

2)添加默认参数,如下图所示:

Snag_65bb471.png

2.6 预览程序数据集

1)选中新建的程序数据集,点击预览按钮,输入参数值,如下图所示:

Snag_65dd3b7.png

2)查询出的销量表如下图所示:

Snag_65eee7e.png

注:如果预览不出数据,请确认代码段里面定义数据库连接时 URL 的地址是否正确,如下图所示:

Snag_66158d7.png

3. 注意事项编辑

3.1 FRM 中程序数据集参数名冲突

1)问题描述

决策报表中创建了多个程序数据集,每个数据集的参数名都是一样的,只是参数值不同,在表单预览时出现展示的数据都是相同的。

2)原因分析

决策报表中如果多个程序数据集的参数名一样,会产生冲突。

3)解决分析

决策报表中程序数据集的名称不能相同,如果存在相同的名称需要修改成不同的。