很多报表工具都自带大量的函数，在正常情况下足够满足用户的报表制作需求，但是在一些特殊领域，可能需要一些特殊的函数，在这种情况下，报表工具FineReport提供了自定义函数机制，可以由用户根据业务需要自己来定义一些函数，满足用户的自定义需求。但这些函数必须FineReport函数定义规则。以下以两个实际案例来仔细详解。
应用一：生成UPC条形码
FineReport中自带有EAN型编码，但却没有UPC条形码，但是可以通过自定义函数引用第三方包来生成UPC编码的条形码并显示出来。如输入数值12345678912，将会得到以下UPC条形码：
具体步骤怎么实现？
1、 编写自定义函数
导入第三方包
在eclipse中导入第三方包（barcode4j-light.jar，可在帆软论坛上下载），barcode4j是一款开源的条形码生成库，能够生成很多种编码的条形码，包括UPC码。自定义函数中可以直接调用该包中现成的方法来生成UPC条形码。
自定义函数类
新建一个类Upc，完整代码如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
package com.fr.
function
;
import java.awt.image.BufferedImage;
import org.krysalis.barcode4j.impl.upcean.UPCABean;
import org.krysalis.barcode4j.output.bitmap.BitmapCanvasProvider;
import org.krysalis.barcode4j.tools.UnitConv;
import com.fr.script.AbstractFunction;
public class Upc extends AbstractFunction {
public Object run(Object[] args) {
if
(args ==
null
|| args.length < 1) {
return
"参数不对，必须有一个参数"
;
}
try
{
// 创建一个UPC编码生成器
UPCABean bean =
new
UPCABean();
// 设置条形码高度，BufferedImage.TYPE_BYTE_BINARY代表常量值12，可直接使用常量值
final int dpi = Integer.parseInt(args[1].toString());
bean.setModuleWidth(UnitConv.in2mm(1.0f / dpi));
bean.doQuietZone(
false
);
BitmapCanvasProvider canvas =
new
BitmapCanvasProvider(dpi,
BufferedImage.TYPE_BYTE_BINARY,
false
, 0);
// 创建条形码
bean.generateBarcode(canvas,args[0].toString());
canvas.finish();
// 返回图片显示
return
canvas.getBufferedImage();
}
catch
(Exception e) {
e.printStackTrace();
}
return
args[0];
}
}
|
2、 编译自定义函数
编译Upc.java生成Upc.class文件，拷贝至报表环境目/WebReport/WEB-INF/classes/com/fr/function下；
将第三方包barcode4j-light.jar放在报表环境目录/WebReport/WEB-INF/lib文件夹下。
3、 注册自定义函数
启动设计器，点击服务器|函数管理器，新增函数取名为Upc，选择Upc.class类，如下图：
4、 Upc()函数的使用
重启服务器，在报表中使用公式==Upc(num1, num2)，num1为需要生成条形码的数值，num2为生成的图片的高度。
如在单元格中输入公式：=Upc(12345678912,100)，预览便可以看到条形码了。
应用二：Unicode编码转化为中文
数据库中保存的是如下形式的编码：%u5357%u4EAC-%u57CE%u5317，希望最好展示出来的是对应的中文“南京-城北”。
具体步骤如下：
1、 编写自定义函数
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
package com.fr.
function
;
import com.fr.script.AbstractFunction;
public class Ubm extends AbstractFunction {
public Object run(Object[] args) {
String str = args[0].toString();
String st =
""
;
StringBuffer buffer =
new
StringBuffer();
while
(str.length() > 0) {
if
(str.startsWith(
"%u"
)) {
st = str.substring(2, 6);
char ch = (char) Integer.parseInt(String.valueOf(st), 16);
buffer.append(
new
Character(ch).toString());
str = str.substring(6);
}
else
{
st = str.substring(0, str.indexOf(
"%u"
));
buffer.append(st);
str = str.substring(st.length());
}
}
return
buffer.toString();
}
}
|
2、 编译自定义函数
将编译后的Ubm.class放到FineReport的安装目录WEB-INF下面的classes目录下，因为Ubm.java属于包com.fr.function，所以Ubm.class需要放到classes\com\fr\function目录下。
3、 注册自定义函数
生成该函数的类后需要在设计器中进行注册，才可以使用该函数。打开服务器|函数管理器选择刚刚定义好了Ubm类，如下图
4、 使用自定义函数
注册号自定义函数后，制作报表时便可直接使用了，使用方法与内置的函数是相同的。输入公式=Ubm("%u5357%u4EAC-%u57CE%u5317")运行如下：
展示值为“南京-城北”。
