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.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，点击该函数可添加到公式中使用，如下图所示：

1）自定义函数名以 class 文件名为准。

2）自定义函数文件名仅支持英文，包括纯大写、纯小写、大小写混合输入。

3）添加的函数在其他函数中展示。

4）当前不支持大小写混合输入。