1. 概述编辑
1.1 预期效果
能够在BI 中使用 StringCat 函数进行拼接字符串,如下图所示:
1.2 实现思路
AbstractFunction 实现了 Function 接口,因此 StringCat 可以直接继承 AbstractFunction 类。
使用函数 StringCat(Para,Para,Para…..) 时,根据函数名取得运算该函数的类 StringCat,并将参数传入类中的 args 对象数组中,执行该类的 run 函数。 而在 run 函数中即实现了将传入的参数以字符串的形式连接起来。并返回最终形成的字符串。
1.3 函数简介
函数 StringCat :作用是把所有的参数以字符串的形式连接起来。
StringCat 函数使用规则为 StringCat(Para,Para,Para…….);其中 Para 为该函数的参数,个数不限。
2. 示例-方法一编辑
2.1 编写 Java 文件
编写StringCat.java, 函数代码如下:
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;
}
}
2.2 生成 class 文件
编译 StringCat.java,生成类 StringCat.class。
2.3 导入 class 文件
将编译后的StringCat.class放到 FineBI 的安装目录%FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function下,如下图所示:
注:若 WEB-INF 下没有对应目录则新建即可。
2.4 使用自定义函数
重启 FineBI后便可直接使用,使用方法与内置的函数是相同的。
比如在添加计算指标中,其他函数下面可以看到之前自定义的函数 Stringcat,点击该函数可添加到公式中使用,如下图所示:
3. 示例-方法二编辑
按照 2.1 2.2 节准备 class 文件。
3.1 导入 Class 文件
将 StringCat.class 文件存放至 %FineBI%\webapps\webroot\WEB-INF\classes\com目录下的任意位置,如下图所示:
3.2 注册自定义函数
生成该函数的类后需要在 FineReport 设计器中进行注册,才可以使用该函数。
使用 FineReport 设计器远程连接 FineBI 工程 ,打开服务器>函数管理器,添加函数并命名为「StringCat」,选择定义好的 StringCat 类,并保存,如下图所示:
3.3 使用自定义函数
重启 FineBI后便可直接使用,使用方法与内置的函数是相同的。
3. 注意事项编辑
1)自定义函数名以 class 文件名为准,即使在 FineReport 中注册更改函数名,依然显示为 class 文件名,且如果通过两种方式添加,仅显示一个函数名。
2)自定义函数文件名仅支持英文,包括纯大写、纯小写、大小写混合输入。
3)添加的函数在其他函数中展示
4)当前不支持大小写混合输入。