最新历史版本 :自定义函数开发过程 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1.  描述编辑

场景描述:FineReport 已经提供了大量的自带函数,在正常情况下足够满足用户的报表制作需求,但是在一些特殊领域,可能需要一些特殊的函数,在这种情况下,FineReport 提供了自定义函数机制,可以由用户根据业务需要自己来定义一些函数。
FineReport 函数定义规则:Functionname(Para,Para,...),其中 Functionname 为函数名,Para 为参数。


2.思路编辑

在 FineReport 中,每一个函数都被定义成一个类,这个类必须要实现 Function 这个接口,在运算的时候首先通过函数名反射取得这个类,然后调用它的 run(Object[] agrs) 方法。


3. 操作步骤编辑

3.1 编写函数代码

对于复杂函数,可以在 Java 开发工具(IDEA,Eclipse 等)中测试通过后,形成完整 Java 代码


3.2 编译自定义函数

(1)通过 Java 开发工具(IDEA,Eclipse 等)编译成 class 文件,此处不做编译赘述 

打开 Eclipse,新建工程:

222
222

右键工程>属性,添加 FineReport 的 JAR,具体请参考 编译Java程序

在 src 目录下新建 class 文件:

222

命名为 GETIP:

222

将下方代码复制进去,根据提示一步步加载引用直至不报错


package com.fr.function;
import com.fr.script.AbstractFunction;
import java.net.InetAddress;
public class GETIP extends AbstractFunction {
    @Override
    public Object run(Object[] objects) {
        try {
            InetAddress ia = InetAddress.getLocalHost();
            return ia.getHostAddress();
        } catch (Exception e) {
            return e.getMessage();
        }
    }
    public static InetAddress getInetAddress() {
        return null;
    }
}

不会报错的截图如下:

222

保存 Java 文件后,工作目录%FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\function文件夹中会有对应的 class 文件,即编译成功

(2)通过设计器进行编译(此方式要求本地 cmd 下 javac 编译正常不会报错)
选择菜单服务器>函数管理器,新增一个自定义函数名 StringCat,点击编辑,输入代码:

222

代码详见:

https://code.fanruan.com/demo/example/src/branch/persist/10.0/src/main/java/com/fr/function/StringCat.java

确认无误后,点击编译,提示编译成功表示编译已成功,然后点击保存

%FR_HOME%\webapps\webroot\WEB-INF\classes\com\fr\function目录下便会生成 StringCat.class 文件  


3.4 使用自定义函数

注册好自定义函数后,制作报表时可直接使用了,使用方法与内置的函数是相同的。

具体可参考 自定义函数