5 DMDRS数据类型

12 JSON数据

<js>            DRS.JSON
<js_lst>        DRS.JSON_LIST
<js_val>        DRS.JSON_VALUE

• JSON类型：用于表示JSON对象，即“名称/值”对的集合。对应于一个JSON字符串中的“{”与“}”之间的内容。

• JSON_LIST类型：用于表示JSON数组，即值的有序列表。对应于一个JSON字符串中的“[”与“]”之间的内容。

• JSON_VALUE类型：用于表示JSON对象中的值，可以是一个字符串、数值、true、false、null、对象或者数组。

12.1 JSON变量属性

序号	语法	类型	说明	附加说明
1	<js> . SIZE	INT	JSON对象的大小，即“名称/值”对的个数。	-
2	<js> . JSON	VARCHAR	JSON对象对应的JSON字符串。	-

12.2 JSON变量函数

12.2.1 ADD_BOOL

功能

添加布尔成员。

语法

<js> . ADD_BOOL(name, bool) RETURN VOID

参数名	类型	说明
name	VARCHAR	布尔成员名。
bool	BOOL	布尔成员。

12.2.2 ADD_LIST

功能

添加JSON数组成员。

语法

<js> . ADD_LIST(name, list) RETURN VOID

参数名	类型	说明
name	VARCHAR	JSON数组成员名。
list	DRS.JSON_LIST	JSON数组成员。

12.2.3 ADD_NULL

功能

添加空值成员。

语法

<js> . ADD_NULL(name) RETURN VOID

参数名	类型	说明
name	VARCHAR	空值成员名。

12.2.4 ADD_NUMBER

功能

添加数值成员。

语法

<js> . ADD_NUMBER(name, num) RETURN VOID

参数名	类型	说明
name	VARCHAR	数值成员名。
num	DOUBLE	数值成员。

12.2.5 ADD_OBJECT

功能

添加JSON对象成员。

语法

<js> . ADD_OBJECT(name, object) RETURN VOID

参数名	类型	说明
name	VARCHAR	JSON对象成员名。
object	DRS.JSON	JSON对象成员。

12.2.6 ADD_STRING

功能

添加字符串成员。

语法

<js> . ADD_STRING(name, str) RETURN VOID

参数名	类型	说明
name	VARCHAR	字符串成员名。
str	VARCHAR	字符串成员。

12.2.7 CREATE

功能

创建JSON对象，即初始化。返回值为1或0，表示成功或失败。

语法

<js> . CREATE() RETURN BOOL

12.2.8 FREE

功能

释放JSON对象。返回值为1或0，表示成功或失败。

语法

<js> . FREE() RETURN BOOL

12.2.9 GET_VALUE

功能

获取指定名称的成员JSON值。返回JSON_VALUE。

语法

<js> . GET_VALUE(name) RETURN DRS.JSON_VALUE

参数名	类型	说明
name	VARCHAR	成员名。

12.2.10 HAS_VALUE

功能

JSON对象是否存在指定名称的成员。

语法

<js> . HAS_VALUE(name) RETURN BOOL

参数名	类型	说明
name	VARCHAR	成员名。

12.2.11 REMOVE_VALUE

功能

移除指定名称的成员。

语法

<js> . REMOVE_VALUE(name) RETURN VOID

参数名	类型	说明
name	VARCHAR	成员名。

12.3 JSON_LIST变量属性

序号	语法	类型	说明	附加说明
1	<js_lst> . SIZE	INT	JSON数组的大小，即值的个数。	-
2	<js_lst> . JSON	VARCHAR	JSON数组对应的JSON字符串。	-

12.4 JSON_LIST变量函数

12.4.1 ADD_BOOL

功能

添加布尔成员。

语法

<js_lst> . ADD_BOOL(bool) RETURN VOID

参数名	类型	说明
bool	BOOL	布尔成员。

12.4.2 ADD_LIST

功能

添加JSON数组成员。

语法

<js_lst> . ADD_LIST(list) RETURN VOID

参数名	类型	说明
list	DRS.JSON_LIST	JSON数组成员。

12.4.3 ADD_NULL

功能

添加空值成员。

语法

<js_lst> . ADD_NULL() RETURN VOID

12.4.4 ADD_NUMBER

功能

添加数值成员。

语法

<js_lst> . ADD_NUMBER(num) RETURN VOID

参数名	类型	说明
num	DOUBLE	数值成员。

12.4.5 ADD_OBJECT

功能

添加JSON对象成员。

语法

<js_lst> . ADD_OBJECT(object) RETURN VOID

参数名	类型	说明
object	DRS.JSON	JSON对象成员。

12.4.6 ADD_STRING

功能

添加字符串成员。

语法

<js_lst> . ADD_STRING(str) RETURN VOID

参数名	类型	说明
str	VARCHAR	字符串成员。

12.4.7 CREATE

功能

创建JSON数组，即初始化。返回值为1或0，表示成功或失败。

语法

<js_lst> . CREATE() RETURN BOOL

12.4.8 FREE

功能

释放JSON数组。返回值为1或0，表示成功或失败。

语法

<js_lst> . FREE() RETURN BOOL

12.4.9 GET_VALUE

功能

获取指定索引位置的成员JSON值。返回JSON_VALUE。

语法

<js_lst> . GET_VALUE(index) RETURN DRS.JSON_VALUE

参数名	类型	说明
index	INT	JSON数组成员的索引位置，从1开始，不超过数组大小。

12.4.10 REMOVE_VALUE

功能

移除指定索引位置的成员。

语法

<js_lst> . REMOVE_VALUE(index) RETURN VOID

参数名	类型	说明
index	INT	JSON数组成员的索引位置，从1开始，不超过数组大小。

12.5 JSON_VALUE变量属性

序号	语法	类型	说明	附加说明
1	<js_val> . TYPE	VARCHAR(16)	JSON值的类型，字符串形式返回，区分大小写。 返回值可以为：'string'，'number'，'true'，'false'，'null'，'object'，'list'。	-
2	<js_val> . JSON	VARCHAR	JSON值对应的JSON字符串。	-

12.6 JSON_VALUE变量函数

12.6.1 CREATE

功能

创建JSON值，即初始化。返回值为1或0，表示成功或失败。

语法

<js_val> . CREATE() RETURN BOOL

12.6.2 FREE

功能

释放JSON值。返回值为1或0，表示成功或失败。

语法

<js_val> . FREE() RETURN BOOL

12.6.3 GET_BOOL

功能

值为布尔类型时，获取布尔值。

语法

<js_val> . GET_BOOL() RETURN BOOL

12.6.4 GET_LIST

功能

值为JSON数组类型时，获取JSON数组。

语法

<js_val> . GET_LIST() RETURN DRS.JSON_LIST

12.6.5 GET_NUMBER

功能

值为数值类型时，获取数值。

语法

<js_val> . GET_NUMBER() RETURN DOUBLE

12.6.6 GET_OBJECT

功能

值为JSON对象类型时，获取JSON对象。

语法

<js_val> . GET_OBJECT() RETURN DRS.JSON

12.6.7 GET_STRING

功能

值为字符串类型时，获取字符串。

语法

<js_val> . GET_STRING() RETURN VARCHAR

12.6.8 PARSE

功能

解析JSON字符串。返回值为1或0，表示成功或失败。

语法

<js_val> . PARSE(str) RETURN BOOL

参数名	类型	说明
str	VARCHAR	要解析的JSON字符串。

12.6.9 SET_BOOL

功能

设置JSON值为布尔值。

语法

<js_val> . SET_BOOL(bool) RETURN VOID

参数名	类型	说明
bool	BOOL	要设置的布尔值。

12.6.10 SET_LIST

功能

设置JSON值为JSON数组。

语法

<js_val> . SET_LIST(list)   RETURN VOID

参数名	类型	说明
list	DRS.JSON_LIST	要设置的JSON数组。

12.6.11 SET_NULL

功能

设置JSON值为空值。

语法

<js_val> . SET_NULL() RETURN VOID

12.6.12 SET_NUMBER

功能

设置JSON值为数值。

语法

<js_val> . SET_NUMBER(num) RETURN VOID

参数名	类型	说明
num	DOUBLE	要设置的数值。

12.6.13 SET_OBJECT

功能

设置JSON值为JSON对象。

语法

<js_val> . SET_OBJECT(object) RETURN VOID

参数名	类型	说明
object	DRS.JSON	要设置的JSON对象。

12.6.14 SET_STRING

功能

设置JSON值为字符串。

语法

<js_val> . SET_STRING(str) RETURN VOID

参数名	类型	说明
str	VARCHAR	要设置的字符串。