自定义函数实现字符串拼接

1.1 预期效果

能够在 BI 中使用 StringCat 函数进行拼接字符串，例如要将「合同事实表」下的「合同ID」和「合同付款类型」拼接成一个字段，如下图所示：

注：公式框中的函数、字段都需要点击左侧的选择区域选择，不能手动输入。

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 文件

2.2.1 编译环境准备

详情参见：编译Java程序

2.2.2 生成 class 文件

编译 StringCat.java，生成类 StringCat.class 。

2.2.3 导入 class 文件

将编译后的StringCat.class放到 FineBI 的安装目录%FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function下，如下图所示：

注：若 WEB-INF 下没有对应目录则新建即可。

2.3 使用自定义函数

重启 FineBI后便可直接使用，使用方法与内置的函数是相同的。

比如在添加计算指标中，其他函数下面可以看到之前自定义的函数 Stringcat，点击该函数可添加到公式中使用，如下图所示：

将「合同事实表」下的「合同ID」和「合同付款类型」拼接成一个字段，输入公式：StringCat(合同ID," ",合同付款类型)，如下图所示：

注：公式框中的函数、字段都需要点击左侧的选择区域选择，不能手动输入。

2.5 效果查看

详情参见本文 1.1 节。

参照本文 2.1 2.2.1 2.2.2 编译生成 StringCat.class 文件。

3.1 导入 Class 文件

将 StringCat.class 文件存放至 %FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function 目录下，如下图所示：

文件可存放在 FineBI 工程目录的任何位置，但是要和 java文件里 package 下的位置相对应，例如本示例为：

package com.fr.function;

因此需要将 class 文件存放至 %FineBI%\webapps\webroot\WEB-INF\classes\com\fr\function 文件下。

如果代码为：

package com;

则可将文件存放至%FineBI%\webapps\webroot\WEB-INF\classes\com 下。

3.2 注册自定义函数

生成该函数的类后需要在 FineReport 设计器中进行注册，才可以使用该函数。

使用 FineReport 设计器远程连接 FineBI 工程  ，打开服务器>函数管理器，添加函数并命名为「StringCat」，选择定义好的 StringCat 类，并保存，如下图所示：

3.3 使用自定义函数

重启 FineBI后便可直接使用，使用方法与内置的函数是相同的。

注：注册后取消远程连接，自定义函数仍可使用。

3.4 效果查看

详情参见本文 1.1 节。