OPEN3000商用库接口说明.doc

商用库接口说明
一 QueryＳample查询类
qｕerｙ_sampｌｅ_sｅｒvｉce_interｆａce类
建立QｕｅrySaｍple客户端时必须构造一个ｑueｒｙ_sａｍｐle_servicｅ_ｉnterface类的对象,由该类的接口负责与服务端通信。该类主要提供一系列的接口函数完成采样数据的查询/统计功能。
包含头文件：db_coｍ/ｑｕery＿sampｌe＿ｓerｖｉce_interface。h
连接动态库:

ｑueｒｙ_saｍｐle_seｒvice_inｔerfａce　( int app_ｉd， iｎt　poｌicy, conｓｔ int poｒｔ_no,chaｒ ＊ seｒver_object， const veｃtｏｒ＜T_Coｒbａ_Ｐrops＞ ＆proｐs_ｖec, ｓｈort cｏntext　= 0,　 cｈar ＊　orｂ＿naｍe　＝ NUＬＬ ）;
接口参数
输入／输出
参数（返回值）说明
备注
ｉｎt aｐp_id
Ｉn
应用号
int　poｌicy
In
策略
一般为1，代表由系统管理指定主机
int port_ｎo
In
端口号
chａr*　seｒvｅｒ_obｊect
Ｉn
ＱｕarySamplｅ服务端进程名
ｖector<T_Coｒba＿Propｓ> ＆ｐroｐs_vec
In
ORB性能参数管理
shｏrt conteｘt
Ｉn
态号
缺省为０，表示当前态
ｃhａr＊ orb_nａｍe
Ｉｎ
缺省为ＮULＬ
queｒｙ＿ｓａmpｌe_servｉce＿inｔｅrface（int app_id， chａr ＊　sｐeciｆy_hoｓt_nａme， cｏnst iｎt specｉfy_pｏrt_no, char ＊ spｅcify_serｖer_oｂjecｔ， vector〈Ｔ_Ｃorba_Props＞ ＆ｐｒoｐs＿vｅｃ, shｏrｔ coｎtｅxt = 0， char * orb_name=　NULＬ）；
接口参数
输入／输出
参数(返回值）说明
备注
ｉnt　aｐｐ＿id
In
应用号
char* speｃify＿host_namｅ
Ｉn
指定主机名
int spｅcｉfy_ｐort_nｏ
Ｉn
指定端口号
ｃhar＊ spｅcｉfy＿ｓervｅr＿oｂject
In
指定ＱｕarySamｐle服务端进程名
vectoｒ<Ｔ_Ｃorba＿Props> ＆ｐrｏps_vｅc
In
ORＢ性能参数管理
sｈoｒt context
In
态号
缺省为０，表示当前态
chａr＊ orb_name
In
缺省为ＮＵLL
2．以同步方式查询采样数据:ＧetQuerySａmｐlｅRｅsｕlt
shoｒt　ＧｅtＱueｒySamｐleResuｌt(coｎsｔ TQｕeｒySamplｅInPaｒm&　in_para,
　 　 　 　 　　　 　　　TQｕerySamplｅOｕtPａrm＿ｏut　out＿para);
接口参数
输入/输出
参数（返回值)说明
备注
ＴQueｒyＳａmpleInParm&　iｎ_ｐａｒa
In
查询条件
TQueryＳａmｐleOutParm_oｕt　out_pａra
Out
查询结果
返回值
Out
０：成功 —1:失败,但服务端接口调用成功 〈-1：服务端接口调用失败
注：指定超时时间参数时，如果出现指定时间无效情况时，请在构造函数中指定orb_nａme（该参数默认为空）即可。
例如下面程序片断指定调用ｑueｒｙ_samplｅ_server时等待5０秒后认为调用超时。ｏrb_name 指定为＂ alias＿qｕｅry_ｓａｍple_server "
如果不指定该参数（orｂ_naｍe）可能导致proｐs_aｌl参数无效
使用方法举例
／/初始化系统管理主机，设置ＯRＢ性能参数管理
vｅｃtor＜Ｔ_Coｒｂa＿Propｓ> props＿all(3)；
stｒｃpｙ（pｒopｓ_all［0］.ｐrｏp_ｎaｍｅ , ＂ooc。。connectioｎs＂)；
stｒcpy（proｐｓ＿aｌl［0］.pｒop＿valｕe， "３"）；
strcｐｙ(propｓ＿all[1］．prop_nａme , ＂ooｃ．oｒｂ．")；
ｓtｒcpy（