论坛风格切换
您好，欢迎光临本站!   登录 注册新用户
发帖 回复
  • 2374阅读
  • 1回复

[其他]报表开发之自定义函数 [复制链接]

 上一主题 下一主题
帆软传说哥
中级菜鸟
 
发帖
62
黑豆
286
威望
283
贡献值
0
交易币
0
红豆
0
只看楼主 倒序阅读 0 发表于: 2016-07-21
对于报表开发，很多情况下，自带的函数就能满足大部分用户的报表制作需求，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函数所使用代码：
复制代码
  1. package com.fr.report.script;
  2. import java.lang.reflect.Array;
  3. import com.fr.report.script.core.FArray;
  4. import com.fr.report.script.core.FunctionHelper;
  5. public class SUM extends AbstractFunction {
  6.     public Object run(Object[] args) {
  7.         double result = 0;
  8.         for (int i = 0; i < args.length; i++) {
  9.             if (args[i] == null) {
  10.                 continue;
  11.             }
  12.             result += parseObject(args[i]);
  13.         }
  14.         return FunctionHelper.parsePrimitiveDouble(result);
  15.     }
  16.     private double parseObject(Object obj) {
  17.         if (obj instanceof Number) {
  18.             return ((Number) obj).doubleValue();
  19.         } else if (obj instanceof Boolean) {
  20.             return ((Boolean) obj).booleanValue() ? 1 : 0;
  21.         } else if (obj instanceof FArray) {
  22.             FArray array = (FArray) obj;
  23.             double sum = 0;
  24.             for (int i = 0; i < array.length(); i++) {
  25.                 sum += parseObject(array.elementAt(i));
  26.             }
  27.             return sum;
  28.         } else if (obj != null) {
  29.             try {
  30.                 return Double.parseDouble(obj.toString());
  31.             } catch (NumberFormatException exp) {
  32.                 return 0;
  33.             }
  34.         }
  35.         return 0;
  36.     }
  37. }
实现步骤


编写自定义函数
下面以一个简单的自定义函数例子来说明使用自定义函数。我们定义一个函数StringCat，他的作用是把所有的参数以字符串的形式连接起来。
StringCat函数使用规则为StringCat(Para,Para,Para…….)；
其中Para为该函数的参数，个数不限。
由概述可知AbstractFunction实现了Function这个接口，因此StringCat可以直接继承AbstractFunction类，完整代码如下：
复制代码
  1. package com.fr.function;
  3. import com.fr.script.AbstractFunction;
  5. public class StringCat extends AbstractFunction {
  6.     public Object run(Object[] args) {
  7.         String result = "";
  8.         Object para;
  9.         for (int i = 0; i < args.length; i++) {
  10.             para = args[i];
  11.             result += para.toString();
  12.         }
  13.         return result;
  14.     }
  15. }
这里要注意，使用函数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公式可以正常使用啦。
回复
举报
发帖 回复
快速回复
限100 字节
 
上一个 下一个