WMB专题之ESQL

专题内容简介：
1.基本概念解读
2.语句说明示例
3.函数说明示例

一、基本概念解读
1.ESQL(Extended Structured Query Language)：可扩展的结构化查询语言，是消息流编程的主要语言。
2.数据类型：Boolean ,Datetime ,Numeric ,String和Reference。
3.声明变量：
DECLARE ref REFERENCE TO OutputRoot.XML.Person
4.操作符：
比较操作符：>、BETWEEN等
逻辑操作符：AND、NOT等
计算操作符：+、||等
5.ESQL语句：程序执行的基本单位，调试断点只能设在语句行上。
6.ESQL函数(Function)：本身提供&用户自定义
7.ESQL过程(Procedure)：ESQL是过程化语言，函数体位于BEGIN…END中。
8.ESQL模块(Module)：一组变量、函数、过程的集合。
9.引号：单引号表示字符串，双引号表示标识(比如保留字)。
10.注释：行注释用“--”，段注释用“/* */”。

二、语句说明示例
1.IF … END IF
示例说明：
IF j > MAX THEN
SET j = MAX
END IF;

2.CASE …
WHEN (value/condition) THEN (statements)
END CASE
示例说明：
CASE CurrentMonth
WHEN ‘01’ THEN Month = ‘January’
WHEN ‘02’ THEN Month = ‘February’
END CASE;

3.FOR name AS reference DO statements
END FOR
示例说明：
SET I = 1;
FOR Item AS MessageRoot.Invoice.Purchase.Item[] DO
SET MessageRoot.BasicStatement.FOR.Item[I] = Item;
END FOR;

4.LOOP statements END LOOP
注：LOOP语句会循环往复的执行statements部分的ESQL语句，在语法结构中是死循环，需要与ITERATE和LEAVE配合使用。
示例说明：
DECLARE I INT 0;
X:LOOP
SET I = I + 1;
IF I > 3 THEN
LEAVE X;
END IF;
END LOOP X;

5.WHILE conditioon DO statements END WHILE
示例说明：
DECLARE I INTEGER 1;
WHILE I <= 3 DO
…
SET I = I + 1;
END WHILE;

6.REPEAT statements UNTIL condition END REPEAT
示例说明：
DECLARE I INTEGER 1;
X : REPEAT
SET I = I + 1;
UNTIL I >= 3
END REPEAT X;

7.LEAVE label
功能说明：
LEAVE语句可以将执行控制从带标签的WHILE、REPEAT、LOOP循环语句中跳出，也可以跳出标签的BEGIN…END块。
示例说明：
DECLARE I INTEGER 0;
X : REPEAT
IF I > 1 THEN
LEAVE X;
END IF;
UNTIL FALSE;
END REPEAT X;

8.ITERATE label
功能说明：
ITERATE结束当前循环过程而直接跳到下一次。
示例说明：
DECLARE I INTEGER 0;
X : REPEAT
SET I = I + 1;
IF I IN (2, 3) THEN
ITERATE X;
END IF;
UNTIL I > 4
END REPEAT X;

三、函数说明示例
[color=orange]字串操作函数[/color]
1.UPPER(或UCASE)/LOWER(或LCASE)
语法格式：UPPER/LOWER(String)
说明示例：UPPER(‘abc’)

2.LENGTH
语法格式：LENGTH(String)
说明示例：LENGTH(‘Hello world’) 返回11

3.POSITION
语法格式：POSITON(String IN String)
说明示例：POSITION(‘A’ IN ‘ABC’) 返回1

4.LEFT/RIGHT
功能说明：拷贝源字符串中左起/右起长度为LENGTH的部分
语法格式：LEFT(String, LENGHT)
说明示例：LEFT(‘ABCD’, 2) 返回AB

5.TRIM/LTRIM/RTRIM
语法格式：TRIM(String)
说明示例：LTRIM(‘ Hello’) 返回’Hello’

6.OVERLAY
功能说明：将字串SourceString中从position开始且长度为length的部分覆盖替换成ReplaceString
语法格式：OVERLAY(SourceString PLAYCING ReplaceString FROM position FOR length)
说明示例：OVERLAY(‘ABCDEFG’ PLACING ‘123’ FROM 4 FOR 3)
返回’ABCD123G’

7.SPACE
功能说明：返回一个连续的number个空字符串
语法格式：SPACE(number)
说明示例：SPACE(3) 返回‘ ’

[color=orange]数学计算函数[/color]
1.ABS(ABSVAL)
功能说明：返回number的绝对值
语法格式：ABS(number)
说明示例：ABS(-12) 返回12

2.SIGN
功能说明：返回number的符号
语法格式：SIGN(number)
说明示例：SIGN(4) 返回1
SIGN(-1) 返回-1
SIGN(0) 返回0

3.MOD
功能说明：返回被除数dividend除以除数divisor后的余数
语法格式：MOD(dividend, divisor)
说明示例：MOD(7, 3) 返回1

4.CEIL(CEILING)/FLOOR
功能说明：对number按上限/下限取整
语法格式：CEIL(number) 、FLOOR(number)
说明示例：CEIL(1.3) 返回2
FLOOR(1.3) 返回1

5.SORT
功能说明：返回数值的平方根
语法格式：SORT(number)
说明示例：SORT(4.0) 返回2E+0

[color=orange]日期与时间函数[/color]
ESQL提供了八种用于求日期与时间的函数：

EXTRACT 提取时间元素，如年、月、日等
CURRENT_DATE 返回当前本地日期
CURRENT_TIME 返回当前本地时间
CURRENT_TIMESTAMP 返回当前本地日期与时间
CURRENT_GMTDATE 返回当前GMT日期
CURRENT_GMTTIME 返回当前GMT时间
CURRENT_GMTTIMESTAMP 返回当前GMT日期与时间
LOCAL_TIMEZONE 返回本地时区与GMT的时差

[color=orange]域操作函数[/color]
ESQL提供了9个域操作函数

ASBITSTREAM 将域类型转换成BLOB类型
BITSTREAM 将域所在的一级子树内容转换成BLOB类型
FIELDNAME 返回域名
FIELDNAMESPACE 返回域名空间
FIELDTYPE 返回域类型
FIELDVALUE 返回域值
FOR 检查是否所有或部分项满足条件
LASTMOVE 检查上次指针赋值是否成功
SAMEFIELD 检查两处域的地址是否相同

[color=orange]集合操作函数[/color]
ESQL提供4个集合操作函数：

CARDINALITY 返回集合大小
EXISTS 检查集合是否至少含有一个元素
SINGULAR 检查集合是否只含有一个元素
THE 返回集合中的第一个元素

[color=orange]复杂操作函数[/color]
ESQL提供了5个复杂操作函数：

CASE 根据参数值或参数条件返回对应的内容
CAST 类型转换
SELECT 针对数据库表或消息字段进行选择操作
ROW 形成单行数据
LIST 形成数组数据

[color=orange]数据库操作函数[/color]
ESQL提供了4种数据库操作函数：

SQLCODE 数据库操作返回码
SQLERRORTEXT 数据库操作返回字串
SQLNATIVEERROR 数据库操作错误码
SQLSTATE 数据库操作状态码

[color=orange]其他操作函数[/color]
ESQL提供了5种其他操作函数：

COALESCE 返回参数串的第一个非空值
NULLIF 参数相等返回NULL,否则返回第一个参数
PASSTHRU 将内容原封不动的提交并跳过Parser
UUIDASBLOB 返回BLOB类型的UUID
UUIDASCHAR 返回CHARACTER类型的UUID