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

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

详情参见：编译Java程序

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

2.3 导入 class 文件

1）请上传class文件至每个bi-engine-worker容器外挂目录/data/polars/classes文件夹对应路径下

• 文件存储位置需要与 java文件里 package 下的位置相对应，classes下如无相关package路径，请自行创建子文件夹

• 请注意如有多个bi-engine-worker，需要一一上传

• 本示例将 StringCat.class 文件存放至每个bi-engine-worker容器外挂目录/data/polars/classes/com/fr/function目录下

2）请上传class文件至每个bi-web容器外挂目录/classes文件夹对应路径下

• 文件存储位置需要与 java文件里 package 下的位置相对应，classes下如无相关package路径，请自行创建子文件夹

• 请注意如有多个bi-web，需要一一上传

• 本示例将 StringCat.class 文件存放至每个bi-web容器外挂目录/data/polars/classes/com/fr/function目录下

3）如该class文件依赖第三方JAR包，请上传对应JAR包至每个bi-engine-worker容器外挂目录/data/polars/customlib文件夹下

• 请注意如有多个bi-engine-worker，需要一一上传

• 本文示例无需上传

4）如该class文件依赖第三方JAR包，请上传对应JAR包至每个bi-web容器外挂目录/customlib文件夹下

• 请注意如有多个bi-web，需要一一上传

• 本文示例无需上传

5）全部放置完毕后，请使用运维平台的「维护>组件管理」功能重启全部bi-web和bi-engine-worker容器，以使功能生效

2.4 使用自定义函数

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

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

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

2.5 效果查看

详情参见本文 1.1 节。

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

3.1 导入 Class 文件

请参照2.1~2.3节生成并导入class文件

3.2 注册自定义函数

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

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

3.3 使用自定义函数

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

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

3.4 效果查看

详情参见本文 1.1 节。