rdbapi 5.1.1.9
实时数据库C接口 for windows/Linux
 
载入中...
搜索中...
未找到
订阅相关相关接口

函数

int rdb_pushjsonmessage_setfun (int h, rdbcb_OnPushJsonMsgs fun, void *pfunparam)
 设置处理实时库推送json消息的处理回调函数,用于高级用户自己解析订阅推送的快照和SOE
 
int rdb_subscription_setfun (int h, rdbcb_OnPushValSnaps funVal, void *pValparam, rdbcb_OnPushObjSnaps funObj, void *pObjparam)
 设置订阅标签快照处理回调函数
 
int rdb_sscsnaps (int h, int mode, int codepage, const char *tagnames[], int nsize, void(*funErr)(const char *tagname, int errcode, void *param), void *paramFun)
 订阅快照,订阅后,当有新的快照数据写入实时库时,对每个订阅者推送一份快照数据。
 
int rdb_unsscsnaps (int h, int codepage, const char *tagnames[], int nsize, void(*funErr)(const char *tagname, int errcode, void *param), void *paramFun)
 取消订阅快照
 
int rdb_unsscallsnaps (int h)
 取消所有订阅
 
int rdb_listsscsnaps (int h, int codepage, void(*funTag)(const char *tagname, void *param), void *paramFun)
 读取当前自己的订阅表
 

详细描述

标签快照订阅相关接口。

函数说明

◆ rdb_listsscsnaps()

int rdb_listsscsnaps ( int h,
int codepage,
void(*)(const char *tagname, void *param) funTag,
void * paramFun )

读取当前自己的订阅表

自从
rdb2024.9 inver 5119
参数
hrdb_create创建的句柄
codepage指示参数字符串和回调函数参数字符串使用的编码;0:GBK, 1:utf8
funTag标签回调,有多少标签回调多少次。
paramFun回调函数funTag的param参数
返回
返回0成功,其他为错误码
备注
适合rdb2024.9 inver=5119及以后版本。

◆ rdb_pushjsonmessage_setfun()

int rdb_pushjsonmessage_setfun ( int h,
rdbcb_OnPushJsonMsgs fun,
void * pfunparam )

设置处理实时库推送json消息的处理回调函数,用于高级用户自己解析订阅推送的快照和SOE

自从
rdb2024.9 inver 5119
参数
hrdb_create创建的句柄
fun处理接收json消息的回调函数
pfunparam回调函数自己的参数
返回
返回0成功,其他为错误码
备注
rdb_create成功后就设置,或者登录成功后设置,也可以在在调用rdb_sscsnaps前设置,推荐rdb_create成功后设置。设置后回调函数包括其pfunparam必须 保持有效可用。注意这个回调函数是在rdbapi后台运行时线程被调用,注意pfunparam参数多线程数据访问冲突。适合rdb2024.9 inver=5119及以后版本。

◆ rdb_sscsnaps()

int rdb_sscsnaps ( int h,
int mode,
int codepage,
const char * tagnames[],
int nsize,
void(*)(const char *tagname, int errcode, void *param) funErr,
void * paramFun )

订阅快照,订阅后,当有新的快照数据写入实时库时,对每个订阅者推送一份快照数据。

自从
rdb2024.9 inver 5119
参数
hrdb_create创建的句柄
mode订阅模式;0:订阅后不推送当前快照;1:订阅需要推送当前快照; 当前快照是指订阅前就存在的快照,这个mode不影响订阅后新快照的推送。
codepage指示参数字符串和回调函数参数字符串使用的编码;0:GBK, 1:utf8
tagnames需要订阅的标签名字符串数组,字符串编码由codepage指定,标签名可以最多有16个通配标签("d0.*","d1.*"等,"*"表示全部)和不限个数的精确指定标签。
nsize标签个数
funErr错误回调,有多少个错误标签回调多少次。
paramFun错误回调函数的param参数。
返回
返回0成功,其他为错误码
备注
订阅快照保存在服务器的连接会话了,连接断开后订阅表在服务端被删除,因此每次登录成功后都需要使用这个函数提交订阅表。适合rdb2024.9 inver=5119及以后版本。

◆ rdb_subscription_setfun()

int rdb_subscription_setfun ( int h,
rdbcb_OnPushValSnaps funVal,
void * pValparam,
rdbcb_OnPushObjSnaps funObj,
void * pObjparam )

设置订阅标签快照处理回调函数

自从
rdb2024.9 inver 5119
参数
hrdb_create创建的句柄
funVal标签值数据回调函数
pValparam值数据回调函数的param参数,回调时原样压缩参数栈。
funObj标签对象数据回调函数
pObjparam对象数据回调函数的param参数,回调时原样压缩参数栈。
返回
返回0成功,其他为错误码
备注
rdb_create成功后就设置,或者登录成功后设置,也可以在在调用rdb_sscsnaps前设置,推荐rdb_create成功后设置。设置后回调函数包括其param必须 保持有效可用。注意这个回调函数是在rdbapi后台运行时线程被调用,注意param参数多线程数据访问冲突。适合rdb2024.9 inver=5119及以后版本。

◆ rdb_unsscallsnaps()

int rdb_unsscallsnaps ( int h)

取消所有订阅

自从
rdb2024.9 inver 5119
参数
hrdb_create创建的句柄
返回
返回0成功,其他为错误码
备注
适合rdb2024.9 inver=5119及以后版本。

◆ rdb_unsscsnaps()

int rdb_unsscsnaps ( int h,
int codepage,
const char * tagnames[],
int nsize,
void(*)(const char *tagname, int errcode, void *param) funErr,
void * paramFun )

取消订阅快照

自从
rdb2024.9 inver 5119
参数
hrdb_create创建的句柄
codepage指示参数字符串和回调函数参数字符串使用的编码;0:GBK, 1:utf8
tagnames需要取消订阅的标签名数组,字符串编码由codepage指定
nsize标签个数
funErr错误回调,有多少个错误标签回调多少次。
paramFun错误回调的param参数。
返回
返回0成功,其他为错误码
备注
适合rdb2024.9 inver=5119及以后版本。