润乾报表的使用


原文: 润乾报表的使用
date: 2016-09-15 19:39:04


[TOC]

前言

前段时间项目用到了报表开发, 选择润乾报表来做. 是款纯Java的报表开发工具, 采用设计和集成分离的方式, 开发过程也较为简单.

介绍

设计时需要安装一个报表设计器, 设计过程类似于Excel中的表格设计. 而且支持html, excel, pdf等多种展现方式. 支持导出doc, excel, pdf和打印.

内置一个数据库demo, 很多报表类型的例子, 和非常丰富的教学文档供我们学习, 而且内置Tomcat, 可供我们在设计过程中就在网页中发布报表来查看预览.

安装

安装过程也较为简单, 不在讲述

需要注意的是:

  • Jdk: 安装中有个选择jdk版本的, 可以选择默认的1.5版本, 也可以自定义选择自己安装的jdk版本. 考虑到设计过程中JRE的兼容问题. 这里可以选择默认的版本, 因为里面的html展现最终是靠jsp来完成, 可以尽量避免设计中的问题.

授权: 在设计器打开和在发布预览中设计器都需要授权, 授权lic文件都可以在网上找到.

安装完成打开设计器如图:


这里写图片描述

设计

设计过程一般分为 绘制表图, 填写字段和表达式, 配置数据源, 定义数据源和参数, 集成项目等步骤.

1. 绘制表图

为了使最后展现给用户的报表比较满意, 我们可能需要进行显示格式, 段落, 缩进, 字体的设置. 以及最后的打印, 分页都可以在报表属性中设置.

2. 填写字段和表达式

前两个过程较为简单, 我用程序提供的小例子. 效果如下:


这里写图片描述

在A2单元格中, 相当于一个游标, 来纵向扩展数据. 当然也支持横向扩展, 支持自己选择.

在做分组报表和卡式报表时候, 有一个左/上主格和附属格(子格)的概念:

  • 主格: 原来的扩展单元格.
  • 附属格: 跟随主格扩展的单元格
  • 左主格: 只有纵向扩展才有的概念, 右边的单元格跟随左边的单元格进行纵向扩展, 这个左边被跟随的单元格就是左主格. 其他跟随的单元格叫做附属格.
  • 上主格: 和左主格概念类似, 只不过是在横向扩展中, 称下边附属格上面的即为上主格.

3. 配置数据源

默认的数据源是润乾自带的demo数据库, 可供我们学习和参考.

在实际设计中, 我们通常需要配置自己的数据源, 在新建中选择驱动, 填写数据源URL, 口令和密码即可.

4. 定义数据源和参数

这是比较关键的一步. 在配置中, 可以进行数据集的设置. 数据集支持SQL检索, 存储过程, 复杂SQL等多种类型.

其中SQL检索支持可以检索到你的数据库, 可以用选择的方式进行数据库中 表, 列, 条件, 排序, 参数的设置.

复杂SQL是比较常用的一种数据集创建方式. 直接在里面编写sql就好啦阿.

如果传参的话, 有普通传参和宏传参两种方式.

  • 普通传参(数据集中):
    定义: select name, age form student where xxx = ?
    参数: 参数表达式: id , 结果类型: 字符串.
    配置->参数: 也要配置一下.
  • 宏传参:
    定义: select name, age from student where ${maceventid}
    配置->宏定义: 也要配置一下.

以上步骤做完, 点击发布报表, 会生成一个raq文件. 这个就是最终要集成到项目的文件.

5. 集成项目

关于报表在项目中的配置文件: reportConfig.xml

配置属性很多, 就不一一列举, 就举几个我配置过的属性:

  • jdbc-ds-configs: 配置数据库信息
  • maxCellNum: 在我集成过程中遇到一个错误, cell num exceeds limit. 意思是单元格数超过限制, 但是我的单元格数据量并不大, 为什么会出现这个错误. 查阅资料, 发现xml文件中有个设置:maxCellNum. 它是一个并发控制的选项, 取决于内存大小. 内存越大可以设置的越大, 不超过2000000.

     maxCellNum
     100000

再设计器设计过程中->报表属性中有个’报表格数’ 属性, 可以设置它来规定单元格数的限制.

如果不设置. 默认会按defaultCellNum来. 如果没有defaultCellNum, 则会按20000来算, 我的xml中并没有设置它, 所以发生这个错误.

但是在后面做项目过程中, 其他人没有设置居然没有报这个错. 也很无解


     defaultCellNum
     9999

关于它, 还有更加详细的并发控制.附上链接:
http://wenku.baidu.com/link?url=J6iqHMVKd2FDgnBAFsWfdUoHkaEdLeqFlhp4nOB0AumdWQ72-EInuncQ71jpMvjLOcCsZbt7muhxH6kj2AdS3PuF6LFIlfdxnbYWyTb7qsq

errorPage

这个属性来指定异常页, 可以先把myErrorPage.jsp拷贝到项目里. 用来查看异常信息. 比直接看错误页面好多了.


     errorPage
     /myErrorPage.jsp

除此之外, 还需要拷贝一些必要的文件.


这里写图片描述

web.xml中report的配置


    
        SetContextServlet
        com.runqian.util.webutil.SetContextServlet
        2
    
    
        reportServlet
        com.runqian.report4.view.ReportServlet
        
            configFile
            /WEB-INF/report/reportConfig.xml
        
        1
    
    
        reportServlet
        /reportServlet
    

    
        
            /WEB-INF/report/runqianReport4.tld
            /WEB-INF/report/runqianReport4.tld
        
    

下面看看最主要的文件吧

首先, 我们设计出来的raq文件怎么在html中展现呢?

只需要在你的请求url上, 映射到showReport.jsp上, url上一般还附带着请求的传参, 和raq文件名.

例如: showReport.jsp?params=”+param+”&reqName=”+raqName;

showReport.jsp中:

<%@ page contentType="text/html;charset=GBK" %>
<%@ taglib uri="/WEB-INF/runqianReport4.tld" prefix="report" %>
<%@ page import="java.io.*"%>
<%@ page import="java.util.*"%>
<%@ page import="com.runqian.report4.usermodel.Context"%>




<%
    request.setCharacterEncoding( "GBK" );
    String report = request.getParameter( "raq" );
    String reportFileHome=Context.getInitCtx().getMainDir();
    StringBuffer param=new StringBuffer();
    
    //保证报表名称的完整性
    int iTmp = 0;
    if( (iTmp = report.lastIndexOf(".raq")) <= 0 ){
        report = report + ".raq";
        iTmp = 0;
    }
    
    Enumeration paramNames = request.getParameterNames();
    if(paramNames!=null){
        while(paramNames.hasMoreElements()){
            String paramName = (String) paramNames.nextElement();
            String paramValue=request.getParameter(paramName);
            if(paramValue!=null){
                //把参数拼成name=value;name2=value2;.....的形式
                param.append(paramName).append("=").append(paramValue).append(";");
            }
        }
    }

    //以下代码是检测这个报表是否有相应的参数模板
    String paramFile = report.substring(0,iTmp)+"_arg.raq";
    File f=new File(application.getRealPath(reportFileHome+ File.separator +paramFile));

%>

<% //如果参数模板存在,则显示参数模板 if( f.exists() ) { %>
<% } %>

其中最关键的两个参数是:

  • raqName: 接收的是raq的全文件名.
  • param: 接收的是:“eventid=” + eventid

除此之外, 还需要把该jsp需要引入的jsp和静态资源加进来. 如toolbar.jsp, style.css等.

总结

润乾报表是一个国产收费的报表工具, 工作中遇到了, 承认东西很强

但是不喜欢, 所以不想做过多研究

你可能感兴趣的:(润乾报表的使用)