自定义函数开发过程

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

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

3.1 编写函数代码

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

3.2 编译自定义函数

（1）通过 Java 开发工具（IDEA，Eclipse 等）编译成 class 文件，此处不做编译赘述 

打开 Eclipse，新建工程：

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

在 src 目录下新建 class 文件：

命名为 GETIP：

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

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;
    }
}

不会报错的截图如下：

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

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

代码详见：

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 使用自定义函数

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

具体可参考 自定义函数