报表开发之自定义函数

对于报表开发，很多情况下，自带的函数就能满足大部分用户的报表制作需求，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公式可以正常使用啦。

报表开发之自定义函数相关推荐

Jmeter自定义函数开发-------输入参数被分割
项目场景: 测试开发工程师自学之路:开发Jmeter自定义函数问题描述函数传参时:有一个参数是Json串, 本想着作为一个data参数使用的,但是setParameters自动给按 ", ...
php函数剩余时间,php计算剩余时间的自定义函数
把两个日期格式的字符串转化成unix时间戳,然后相减获得时间戳差,最后判断剩余时间,生成类似(2小时30分钟20秒前发布)这样的时间格式,代码如下: function gettime($time_s, ...
Blink 自定义函数（UDX）
Blink 开发Java自定义函数(UDX) 概述注意事项 UDX函数仅适用于Blink,对开源Flink暂不适用. 为了避免JAR依赖冲突,您需要注意以下几点: 开发页面选择的Blink版本,请和 ...
Excel催化剂开源第12波-VSTO开发遍历功能区所有菜单按钮及自定义函数清单
在插件开发过程中,随着功能越来越多,用户找寻功能入口将变得越来越困难,在Excel催化剂 ,将采用遍历所有功能的方式,让用户可以轻松使用简单的查找功能找到想要功能所在位置,查找的范围有:功能按钮的显示 ...
MS SQL自定义函数IsPositiveInteger MS SQL自定义函数IsNumeric 水晶报表使用IEnumerableT数据源...
MS SQL自定义函数IsPositiveInteger 判断字符串是否为正整数,0开始的的数字不算. SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO ...
python如何自定义函数_python如何自定义函数_后端开发
c语言特点是什么_后端开发 c语言特点是:1.语言简洁.紧凑,使用方便.灵活:2.运算符丰富:3.数据结构丰富,具有现代化语言的各种数据结构:4.具有结构化的控制语句:5.语法限制不太严度格,程序设计 ...
WordPress开发入门08：自定义函数和WordPress钩子
当我们创建自定义主题或插件时,通常必须编写自己的PHP代码.这些代码通常存储在自定义函数中.我们知道函数是可复用的代码块,只要你需要就可以重复调用. 现在来看看几个WordPress常见的使用自定义函 ...
STM8S系列基于STVD开发，自定义printf函数+TIM5精确延时函数模块化工程示例
STM8S系列基于STVD开发,自定义printf函数+TIM5精确延时函数模块化工程示例
构建一个轻量级的嵌入式虚拟平台，开发工程用板stm32 picoc解释器，大量自定义函数，sarm拓展，lwip移植，nes模拟器移植，系统优化，等等技术的融合
让嵌入式想java一样一处编写到处运行第一次写博客,其实接触嵌入式已经快两年了,从开始学51单片机的时候,怀着满腔的热情.写出了点亮第一个流水灯代码的时候那个无比的激动,到后面自己做许多有趣的东西( ...

报表开发之自定义函数

报表开发之自定义函数相关推荐

最新文章

热门文章