对于报表开发,很多情况下,自带的函数就能满足大部分用户的报表制作需求,FineReport也不例外。但是在一些特殊领域,可能需要一些特殊的函数,在这种情况下,FineReport提供了自定义函数机制,可以由用户根据业务需要自己来定义一些函数,但这些函数必须满足函数定义规则。
先来了解一下FineReport的函数定义规则:Functionname(Para,Para,...),其中Functionname为函数名,Para为参数。
每一个函数都被定义成一个类,这个类必须要实现Function这个接口,在运算的时候首先通过函数名反射取得这个类,然后调用它的run(Object[] agrs)方法。下面以SUM这个函数为例。
SUM函数原理
由程序可以看到,SUM类用来运算SUM函数,他继承了AbstractFunction类,而AbstractFunction实现了Function这个接口。
当函数运算的时候,先根据函数名取得运算该函数的类,如SUM(2,4,true)这个函数先根据函数名取得SUM这个类,然后调用SUM类的run(Object[] args)方法,args中存放的是SUM函数的参数,运算的时候可以从args中取得参数进行运算。如执行结果为SUM(2,4,true)=2+4+1=7。
SUM函数所使用代码:
package com.fr.report.script; import java.lang.reflect.Array; import com.fr.report.script.core.FArray; import com.fr.report.script.core.FunctionHelper; public class SUM extends AbstractFunction { public Object run(Object[] args) { double result = 0; for (int i = 0; i < args.length; i++) { if (args[i] == null) { continue; } result += parseObject(args[i]); } return FunctionHelper.parsePrimitiveDouble(result); } private double parseObject(Object obj) { if (obj instanceof Number) { return ((Number) obj).doubleValue(); } else if (obj instanceof Boolean) { return ((Boolean) obj).booleanValue() ? 1 : 0; } else if (obj instanceof FArray) { FArray array = (FArray) obj; double sum = 0; for (int i = 0; i < array.length(); i++) { sum += parseObject(array.elementAt(i)); } return sum; } else if (obj != null) { try { return Double.parseDouble(obj.toString()); } catch (NumberFormatException exp) { return 0; } } return 0; } }
实现步骤
编写自定义函数
下面以一个简单的自定义函数例子来说明使用自定义函数。我们定义一个函数StringCat,他的作用是把所有的参数以字符串的形式连接起来。
StringCat函数使用规则为StringCat(Para,Para,Para…….);
其中Para为该函数的参数,个数不限。
由概述可知AbstractFunction实现了Function这个接口,因此StringCat可以直接继承AbstractFunction类,完整代码如下:
package com.fr.function; import com.fr.script.AbstractFunction; public class StringCat extends AbstractFunction { public Object run(Object[] args) { String result = ""; Object para; for (int i = 0; i < args.length; i++) { para = args[i]; result += para.toString(); } return result; } }
这里要注意,使用函数StringCat(Para,Para,Para…..)时,根据函数名取得运算该函数的类StringCat,并将参数传入类中的args对象数组中,执行该类的run函数。
而在run函数中即实现了将传入的参数以字符串的形式连接起来。并返回最终形成的字符串。
编译自定义函数
将编译后的StringCat.class放到FineReport的安装目录WEB-INF下面的classes目录下,因为StringCat.java属于包com.fr.function,所以StringCat.class需要放到classes\com\fr\function目录下。
注册自定义函数
生成该函数的类后需要在设计器中进行注册,才可以使用该函数。打开服务器|函数管理器,选择刚刚定义好了StringCat类,如下图
函数名称可以自定义,如这边定义为StringCat;
同时可以添加该函数的使用说明,如上图所示的描述
使用自定义函数
注册好自定义函数后,制作报表时便可直接使用了,使用方法与内置的函数是相同的。
新建报表,定义两个报表参数para1、para2,类型分别为字符串型与整形,默认值分别为空字符串与0
在空白报表的任意单元格里写入公式:=StringCat($para1,$para2)(注意:写入公式的时候在参数名前加$,表明这是使用的参数)
点击分页预览在参数控件中,写入参数值如para1为:FineReport,para2为:123。
点击查询可以看到结果
说明StringCat公式可以正常使用啦。
相关推荐
本代码主要开源了java报表工具中程序数据集和自定义函数部分的代码,通过该开源代码,你可以了解报表工具的内部原理,掌握国内主流java报表工具的各类接口使用方法,并运用该接口对软件产品或项目中的个性化的需求...
金蝶EAS增加自定义取数公式范例。可以根据文档描述,一步一步的按照文档步骤操作,就可以完成开发自定义取数公式的功能了。
cell报表模板设计器.net代码示例 Cell 产品分Cell 组件和Cell 插件两个姐妹产品。...图表,公式,自定义函数、资源本地化等强大功能,能够完全读写Excel文件,是软件开发人员开发优秀报表软件的最佳解决方案。
本代码主要开源了java报表工具中报表调用部分的代码,通过该开源代码,你可以了解报表工具的内部原理,掌握国内主流java报表工具的各类...另有报表程序数据集、自定义函数和导出API的相关代码,如有需要可以另行下载。
图表,公式,自定义函数、资源本地化等强大功能,能够完全读写Excel文件,是软件开发人员开发优秀报表软件的最佳解决方案。 华表公司网站:http://www.cellsoft.cc Cell产品网站:...
9) 开发者可以使用自定义函数功能。 10) 扩充了图表种类,数据区域可以产生在不连续的区域。 以上功能的增加大大加强了报表控件的实用性。我们继承UFO底层功能的同时,并准备对其进行优化,使报表控件功能强大又不失...
UFO报表取数,UFO报表跨表取数,UFO报表设置
此源码是Cell组件PB中如何自定义函数的代码示例和Cell组件超级报表模板设计器PB源码示例。 Cell 组件适用于Windows环境下各种开发工具(如VB, VC, Visual Foxpro, Delphi, C++ Builder, PowerBuilder, .NET)等,是...
此源码是Cell组件Delphi中如何从数据库取数和自定义函数的代码示例。 Cell网站: Http://Www.Cellsoft.Cc/Cell/Index.Asp Cell组件下载地址: Http://Www.Cellsoft.Cc./GL_Down/2008121323980828.Exe 产品概述: ...
(14)调用简便,与其它PB开发系统之接口简单。 (15)可以直接在Orcal,Sybase,Ms-sql等大型数据库下使用而无需任何改动。 (16)调用本系统之前已经设计好的报表,可以选择“原数据窗口格式”生成到本系统,把“死...
华报智能报表工具(ReportAll)是开发人员最... 支持自定义函数,需要调用自定义函数时,系统产生事件,通过捕捉事件可以实现自定义函数。 界面个性化 设计报表文档时,支持配色方案的设计。 支持菜单的隐藏和显示。
此源码是Cell组件超级报表模板设计器C#.Net源码示例。 Cell网站: ... Cell组件下载地址: ...· 强大的自定义函数功能,用户可根据自己的业务逻辑添加自己的函数 · 极大地提升了图表功能,图表种类和效果比肩E
一、文章引言:近段时间,由于工作的需要,需要以报表和图形的形式对数据进行统计分析,由于手头没有相关的开发组件,于是自己利用GDI 函数进行底层的图形绘制,配合中间层的数据统计及组合,表层嵌入HTML文件中,...
是第一个国产ActiveX商业组件,有300多个编程接口,实现自定义报表、图表、公式、自定义函数、单元风格、资源本地化等强大功能,能够完全读写Excel文件。Cell 插件用于开发B/S结构程序,使用Asp, Asp.net, Jsp,...
程序开发过程中需要做周别统计与显示报表。在做之前,得先找出所在年份周别的开始日期与结束日期。每年每周的开始与结束日期都不尽相同。为了该功能,在sql Server自定义一个用户定义星期函数
软件授权:共享软件/免费软件/试用软件/DEMO软件 使用平台:Win9x/Me/NT...Cell具有报表处理、图表、公式、自定义函数、数据库绑定的强大功能, 且提供几个百个编程接口。是软件开发人员开发完美软件的最佳解决方案。
Cell 组件、插件(ActiveX控件)是北京用友华表公司在长期开发实践的基础上推出的功能强大、技术成熟的报表二次开发工具,是国内技术领先拥有广泛客户群的商业报表组件,有700多个编程接口,实现报表自定义,报表显示...
此源码是Cell组件PB中如何自定义函数的代码示例和Cell组件超级报表模板设计器PB源码示例。 Cell网站: http://www.cellsoft.cc/Cell/index.asp cell组件下载地址: ... 产品概述: Cell 组件适用于Windows环境下各种...
华表插件是华表公司在长期开发实践的基础上推出的功能强大、技术成熟的报表...实现自定义报表、图表、公式、自定义函数、数据库绑定、单元风格、资源本地化等强大功能,是软件开发人员开发完美报表软件的最佳解决方案。