GBase 8s Java UDR安装说明

创建Java UDR过程

1, 将共享库gbasedbt-judr-x.x.x.jar 放置于数据库服务器上

比如，放到$GBASEDBTDIR/udr 目录下，并改名为judr.jar
则gbasedbt-judr-x.x.x.jar的位置为$GBASEDBTDIR/udr/judr.jar
下载地址：https://docs.gbasedbt.com/Java_Udr/install/gbasedbt-judr-1.0.0.jar

2, 设置数据库的JVP环境

ONCONFIG配置文件涉及到JVP的相关参数

1）VPCLASS开启jvp，用于处理Java UDR，默认不开启，取消前面的注释符’#'，如果有较多调用，可增加jvp的数量

VPCLASS jvp,num=1  

2）JVPARGS增加 -Dfile.encoding=UTF-8（根据实际需要增加与否，即直接java执行的参数），JVPCLASSPATH增加judr.jar

JVPARGS -Dcom.ibm.tools.attach.enable=no;-Dfile.encoding=UTF-8  
JVPCLASSPATH $GBASEDBTDIR/extend/krakatoa/krakatoa.jar:$GBASEDBTDIR/extend/krakatoa/jdbc.jar:$GBASEDBTDIR/udr/judr.jar

重启数据库生效，通过onstat -g glo确认已经增加的jvp。

3, 创建相应的例程

示例：

drop function if exists ifnull(lvarchar,lvarchar);
create dba function ifnull(lvarchar,lvarchar)
returns lvarchar
with (not variant, handlesnulls)
  external name 'com.gbasedbt.judr.mysql.MysqlFunc.ifnull(java.lang.String,java.lang.String)'
language java;

其中function中的 ifnull(lvarchar,lvarchar)应与Java中的定义相对应；
external name 为java中的名称： java类名.方法
使用：

select ifnull(null,'abc') from dual;

4, Java Udr 函数说明

Math类
– conv 进制转换函数

function conv(lvarchar,int,int)

– rand 随机函数（1-1亿的随机数）

function rand()

– random 随机函数（0-1之间的随机数）

function random()

– randnum 指定范围内的随机数

function randomnum(int,int)

HEX
– decodeHex
– 使用默认字符集UTF-8

function decodeHex(lvarchar)

– 第二个参数指定字符集，如UTF-8，GBK

function decodeHex(lvarchar,lvarchar)

– encodeHex
– 使用默认字符集UTF-8

function encodeHex(lvarchar)

– 第二个参数指定字符集，如UTF-8，GBK

function encodeHex(lvarchar,lvarchar)

CRYPT
– decodeBase64
– 输出ascii结果

function decodeBase64(lvarchar)

– decodeBase64Hex
– 输出hex结果

function decodeBase64Hex(lvarchar)

– decryptAES (PKCS5)
– 指定8位secret

function decryptAES(lvarchar,lvarchar)

– 使用默认的8位secret

function decryptAES(lvarchar)

– decryptDES (PKCS5)
– 指定8位secret

function decryptDES(lvarchar,lvarchar)

– 使用默认的8位secret

function decryptDES(lvarchar)

– encodeBase64
– 输出ascii结果

function encodeBase64(lvarchar)

– encodeBase64Hex
– 输出hex结果

function encodeBase64Hex(lvarchar)

– encodeMD5

function encodeMD5(lvarchar)

– encryptAES
– 指定8位secret

function encryptAES(lvarchar,lvarchar)

– 使用默认的8位secret

function encryptAES(lvarchar)

– encryptDES
– 指定8位secret

function encryptDES(lvarchar,lvarchar)

– 使用默认的8位secret

function encryptDES(lvarchar)

– sm4_decrypt
– 指定16位secret

function decryptSM4(lvarchar,lvarchar)

– 使用默认的16位secret

function decryptSM4(lvarchar)

– sm4_encrypt
– 指定16位secret

function encryptSM4(lvarchar,lvarchar)

– 使用默认的16位secret

function encryptSM4(lvarchar)

MySQL兼容
– ascii

function jascii(lvarchar)

– chr

function jchr(int)

– randomstr，随机字符串

function randomstr(int)

– 指定大小写

function randomstr(lvarchar,int)

– uuid

function juuid()

– now

function now()

– unix_timestamp

function unix_timestamp()
-- 指定日期时间字符串  
function unix_timestamp(lvarchar)

– from_unixtime

function from_unixtime(int)

– ifnull

function ifnull(lvarchar,lvarchar)

– find_in_set 兼容函数

function find_in_set(lvarchar,lvarchar)

– format 兼容函数

function format(float,int)

– repeat 兼容函数

function repeat(lvarchar,int)

说明
gbasedbt-judr-x.x.x.jar中包含的函数，具体参考javadoc