金融基础件0接入T2SDK开发手册

c

HLNDSLN

J

金融基础件2.0接入

T2SDK开发手册

文档版本V2.0

发布日期2013-06-27

修改记录

版本号日期修改者修改说明

V2.0许欣亢创建

目录

目录...........................................................................3

前言............................................................................9

产品简介.....................................................................9

读者对象.....................................................................9

手册概况.....................................................................9

缩略语/术语..................................................................9

1.开发包简介................................................................11

2.开发流程..................................................................12

2.1同步开发流程.......................................................12

2.2异步开发流程.......................................................12

3.开发接口..................................................................14

3.1T2SDK引出函数.....................................................14

3.1.1取开发包版本信息(GetVersionlnfo)............................................................14

3.1.2创建配置接口(NewConfig)...........................................................................14

3.1.3创建连接接口(NewConnection)...................................................................15

3.1.4创建打包器接口(NewPacker).......................................................................15

3.1.5创建解包器接口(NewUnPacker)..................................................................15

3.1.6创建v1解包器接口(NewUnPackerVI)...........................................16

3.1.7获取Pack包的版本(GetPackVersion).........................................................16

3.1.8密码加密接口(EncodeEx).............................................................................16

3.1.9创建过滤接口(NewFilter).............................................................................17

3.1.10创建订阅参数接口(NewSubscribeParam)...................................................17

3.1.11创建业务消息接口(NewBizMessage)..........................................................17

3.1.12创建业务消息接口(NewBizMessageEx)......................................................18

3.1.13创建空解包器接口(NewEmptyUnPacker)...................................................18

3.1.14测速接口(GetNetWorkSpeed)......................................................................19

3.1.15批量测速接口(GetMultiNetWorkSpeed).....................................................19

3.1.16获取发送接收字节数(GetRateBytes)..........................................................20

3.1.17重置发送接收字节数(ReSetRateBytes).......................................................20

3.2酉己置接口[CConfiglnterface]...................................................................................20

3.2.1读取配置文件(Load).....................................................................................20

3.2.2保存配置文件：Save).....................................................................................21

3.2.3获取字符型配置项值(GetString).................................................................21

3.2.4获取整型配置项值(Getlnt)...........................................................................22

3.2.5设置字符型配置项值(SetString).................................................................22

3.2.6设置整型配置项值(Setlnt)...........................................................................23

3.3连接回调接口【CCallbacklnterface】...................................23

3.3.1TCP连接成功【旦调(OnConnect)...................................................................23

3.3.2安全连接成功回调(OnSafeConnect)...........................................................24

3.3.3注册成功回调COnRegister)...........................................................................24

3.3.4连接断开回调(OnClose)...............................................................................24

3.3.5数据发送回调Consent).................................................................................25

3.3.6收到消息回调(OnReceivedBiz).....................................................................25

3.3.7收到消息扩展回调(OnReceivedBizEx)........................................................26

3.3.8收到业务消息回调(OnReceivedBizMsg).....................................................27

3.4业务消息接口【IBizMessage].................................................................................27

3.4.1设置功能号(SetFunction)..............................................................................27

3.4.2获取功能号(GetFunction).............................................................................28

3.4.3设置包类型(SetPacketType).........................................................................28

3.4.4获取包类型(GetPacketType).........................................................................28

3.4.5设置营业部号CSetBranchNo)........................................................................29

3.4.6获取营业部号CGetBranchNo).......................................................................29

3.4.7设置系统号(SetSystemNo)...........................................................................29

3.4.8获取系统号(GetSystemNo)...........................................................................29

3.4.9设置子系统号^SetSubSystemNo)..................................................................30

3.4.10获取了系统号[GetSubSystemN。)................................30

3.4.11设置发送者编号(SetSenderld).....................................................................30

3.4.12获取发送者编号(GetSenderld).....................................................................31

3.4.13设置包序号(SetPacketld)..............................................................................31

3.4.14获取包序号(GetPacketld).............................................................................31

3.4.15设置目的地路由(SetTargetlnfo)...................................................................32

3.4.16获取目的地路由(GetTargetlnfo)...................................................................32

3.4.17设置发送者路由(SetSendlnfo).....................................................................32

3.4.18获取发送者路由(GetSendlnfo).....................................................................33

3.4.19设置错误号(SetErrorNo)................................................................................33

3.4.20获取错误号(GetErrorNo)..............................................................................33

3.4.21设置错误信息(SetErrorlnfo).........................................................................34

3.4.22获取错误信息(GetErrorlnfo).........................................................................34

3.4.23设置返回码(SetReturnCode)........................................................................34

3.4.24获取返回码(GetReturnCode)........................................................................3S

3.4.25设置业务内容(SetContent)...........................................................................35

3.4.26获取业务内容(GetContent)..........................................................................35

3.4.27设置订阅类型(SetlssueType)........................................................................36

3.4.28获取订阅类型(GetlssueType).......................................................................36

3.4.29设置订阅序号(SetSequeceNo).....................................................................37

3.4.30获取订阅序号(GetSequeceNo).....................................................................37

3.4.31设置订阅关键字段(SetKeylnfo)....................................................................37

3.4.32获取订阅关键字段(GetKeylnfo)...................................................................38

3.4.33设置附加数据CSetAppData)..........................................................................38

3.4.34获取附加数据(GetAppData).........................................................................39

3.4.35请求转换成应答(ChangeReq2AnsMessage)...............................................39

3.4.36消息转换成二进制流(GetBuff)....................................................................39

3.4.37二进制流转换成消息(SetBuff).....................................................................39

3.4.38清除消息内的字段(ReSet)............................................................................40

3.4.39设置公司编号(SetCompanylD).....................................................................40

3.4.40获取公司编号CGetCompanylD)....................................................................40

3.4.41设置内部许可证编号(SetlnternalLicense)..................................................41

3.4.42获取内部许可证编号(GetlnternalLicense)..................................................41

3.4.43设置业务保留域(SetAppReserved).............................................................41

3.4.44获取业务保留域(GetAppReserved).............................................................41

3.4.45设置发送者公司编号(SetSenderCompanylD)............................................42

3.4.46获取发送者公司编号(GetSenderCompanylD)...........................................42

3.4.47设置主题名所在域信息(SetTopicInfo)........................................................42

3.4.48获取主题名所在域信息(GetTopicInfo).......................................................42

3.4.49设置过滤域信息(SetFilterlnfo).....................................................................43

3.4.50获取过滤域信息(GetFilterlnfo)....................................................................43

3.5打包器接口【IF2Packer].........................................................................................43

3.5.1设置缓存区空间(SetBuffer)..........................................................................43

3.5.2开始打包(BeginPack)....................................................................................44

3.5.3构造新结果集CNewDataset).........................................................................44

3.5.4添力口新字段(AddField)...................................................................................45

3.5.5添力「string型数据(AddStr)...........................................................................45

3.5.6添加int型数据(Addlnt)................................................................................45

3.5.7添力口double型数据(AddDouble)................................................................46

3.5.8添加char型数据(AddChar)..........................................................................46

3.5.9添加二进制数据(AddRaw)...........................................................................46

3.5.10结束打包(EndPack)........................................................................................46

3.5.11获取打包结果指针(GetPackBuf)..................................................................47

3.5.12获取打包结果长度(GetPackLen).................................................................47

3.5.13获取打包缓存长度(GetPackBufSize)...........................................................47

3.5.14获取打包版本CGetVersion)...........................................................................48

3.5.15设置返回码(SetReturnCode)........................................................................48

3.5.16获取解包接口(UnPack).................................................................................48

3.5.17释放打包内存(FreeMem).............................................................................48

3.5.18清空最后一个结果集数据(ClearValue).......................................................49

3.5.19开始打包扩展接口(BeginPackEx)................................................................49

3.5.20清空当前结果集(ClearDataSet)...................................................................49

3.6结果集接口[lF2ResultSet]....................................................................................50

3.6.1获取列个数(GetColCount)............................................................................50

3.6.2根据下标获取列名字(GetColName)...........................................................50

3.6.3获取列类型(GetColType)..............................................................................50

3.6.4获取歹U精度(GetColScale)..............................................................................51

3.6.5获取列最大长度(GetColWidth)....................................................................51

3.6.6根据列名字找到列下标(FindCollndex).......................................................51

3.6.7根据列下标获取string类型值(GetStrBylndex).........................................51

3.6.8根据列名字获取string类型值(GetStr)......................................................52

3.6.9根据列下标获取char类型值(GetCharBylndex)........................................52

3.6.10根据列名字获取char类型值(GetChar)......................................................52

3.6.11根据列下标获取double类型值(GetDoubleBylndex)...............................53

3.6.12根据列名字获取double类型值(GetDouble).............................................53

3.6.13根据列下标获取int类型值(GetlntBylndex)...............................................53

3.6.14根据列名字获取int类型值(Getlnt)............................................................53

3.6.15根据列下标获取二进制类型值(GetRawBylndex)......................................54

3.6.16根据列名字获取二进制类型值(GetRaw)...................................................54

3.6.17最后一次取得值是否为空(WasNull)............................................................54

3.6.18结果集下一条记录(Next)..............................................................................55

3.6.19结果集是否到结尾(IsEOF)............................................................................55

3.6.20结果集是否为空(IsEmpty)............................................................................55

3.6.21结果集释放(Destroy).....................................................................................56

3.7解包器接口【IF2UnPacker】...........................................56

3.7.1获取解包器版本(GetVersion).......................................................................56

3.7.2二进制转换为解包器(Open)........................................................................56

3.7.3获取结果集个数(GetDatasetCount).............................................................57

3.7.4根据下标设置当前结果集(SetCurrentDatasetByhidex)............................57

3.7.5根据结果集名字设置当前结果集(SetCurrentDataset)................................57

3.7.6获取解包器缓存指针(GetPackBuf)..............................................................58

3.7.7获取解包器缓存长度(GetPackLen)..............................................................58

3.7.8获取当前结果集行数(GetRowCount)..........................................................58

3.7.9指向结果集第一行记录(First)......................................................................58

3.7.10指向结果集最后一行记录(Last)..................................................................59

3.7.11跳转到结果集任意行(Go).............................................................................59

3.7.12获取当前结果集名字的接口(GetDatasetName).......................................59

3.7.13拷贝数据(OpenAndCopy).............................................................................60

3.7.14根据名字获取字段类型(GetColTypeByName)............................................60

3.7.15取数字型字段小数位数(GetColScaleByName)..........................................60

3.7.16取字段允许存放数据的最大宽度(GetColWidthByName).........................60

3.8过滤器接口[CFilterlnterface]................................................................................61

3.8.1根据下标获取条件名字(GetFiltcrNameBylndex)......................................61

3.8.2根据下标获取条件值(GetFilterValueBylndex)............................................61

3.8.3根据条件名字好获取条件值(GetFilterValue).............................................61

3.8.4获取过滤条件个数(GetCount).....................................................................62

3.8.5设置过滤条件名字和值(SetFilter)...............................................................62

3.9订阅参数接口[CSubscribeParamlnterface].........................................................62

3.9.1设置主题名字(SetTopicName)......................................................................62

3.9.2设置附加数据(SetAppData)...........................................................................63

3.9.3设置过滤条件(SetFilter)................................................................................63

3.9.4设置返回字段CSetReturnFiled).....................................................................63

3.9.5设置补缺标志(SetFromNow)........................................................................64

3.9.6设置覆盖标志(SetReplace)............................................................................64

3.9.7设置发送间隔(SetSendInterval)...................................................................64

3.9.8获取主题名字CGetTopicName).....................................................................65

3.9.9获取附加数据^GetAppData).........................................................................65

3.9.10根据下标获取过滤字段名字(GetFilterNameBylndex)..............................65

3.9.11根据下标获取过滤字段值(GetFllterValueBylndex)...................................66

3.9.12根据过滤名字获取值(GetFilterValue).........................................................66

3.9.13获取过滤条件个数(GetFilterCount)............................................................66

3.9.14获取返回字段CGetReturnFiled)....................................................................66

3.9.15获取补缺标志CGetFromNow).......................................................................67

3.9.16获取覆盖标志(GetReplace)..........................................................................67

3.9.17获取发送间隔^GetSendInterval)...................................................................67

3.9.18设置是否更新消息序号(SetUpdateMsgNo)...............................................68

3.9.19获取是否更新消息序号(GetUpdateMsgNo)...............................................68

3.9.20重置过滤字段接口(ReSetFilter)..............................................................68

3.10订阅回调接口[CSubCallbacklnterface].................................................................68

3.10.1收到发布消息回调(OnReceived)..................................................................69

3.10.2收到剔除订阅回调(OnRecvTickMsg)..........................................................69

3.11订阅接口[CSubscribelnterface]..............................................................................70

3.11.1订阅主题(SubscribeTopic)...................................................................................70

3.11.2取消订阅(CancelSubscribeTopic)........................................................................71

3.11.3取消订阅扩展接口(CancelSubscribeTopicEx)...................................................71

3.11.4获取已经订阅的信息(GetSubcribeTopic).........................................................71

3.11.5取消订阅扩展接口(GetServerAddress).......................................................72

3.11.6获取服务端的所有主题信息(GetTopic)......................................................72

3.11.7批量订阅的接口(BatchSubscribeTopic).......................................................72

3.12发布接口[CPublishnterface].................................................................................73

3.12.1业务发包格式发送(PubMsgByPacker)..............................................................74

3.12.2二进制数据发送(PubMsg).................................................................................75

3.12.3获取当前主题的发布序号(GetMsgNoByTopicName)................................75

3.12.4获取服务器地址(GetServerAddress)...........................................................75

3.13文件更新回调接口[CFileUpdateCallbacklnterface]............................................76

3.13.1收到文件更新列表回调(OnReceFileList)....................................................76

3.13.2收到文件更新进度回调(OnShowProcessBar)............................................76

3.13.3收到文件更新取消回调(OnCancel)............................................................77

3.14文件更新接口[CFileUpdatelnterface]...................................................................77

3.14.1更新文件(Upda:eFile)..........................................................................................77

3.14.2取消文件更新(CancelUpdateFile)......................................................................78

3.14.3获取更新文件列表(GetFileUpdateList).............................................................78

3.15连接接口(CConnectionlnterface]..........................................................................78

3.15.1初始化连接对象(Create)..............................................................................78

3.15.2开始连接/注册(Connect)..............................................................................79

3.15.3断开连接(Close).............................................................................................79

3.15.4取连接服务渊地址(GetServerAddress).......................................................79

3.15.5取连接状态(GetStatus).................................................................................80

3.15.6取服务器负载CGetServerLoad).....................................................................80

3.15.7取错误码对应的错误信息(GetErrorMsg)...................................................81

3.15.8取连接错误号(GetConnectError)................................................................81

3.15.9发送业务数据CSendBiz)................................................................................81

3.15.10接收业务数据(RecvBIz).................................................................................82

3.15.11发送业务数据扩展接口(SendBizEx)............................................................83

3.15.12接收业务数据扩展接口(RecvBizEx)............................................................84

3.15.13连接初始化的扩展接口(CreateEx)..............................................................85

3.15.14获取服务端上连接的IP和端口(GetRealAddress)....................................85

3.15.15获取本地连接使用的IP和端口(GetSelfAddress).....................................85

3.15.16获取连接使用的MAC地址(GetSelfMac)..................................................86

3.15.17创建订阅者(NewSubscriber).......................................................................86

3.15.18获取发布者(NewPublisher)..........................................................................86

3.15.19获取主题信息(GetTopic)...............................................................................87

3.15.20获取消息中心的最后错误(GetMCLastError).............................................88

3.15.21连接用IBizMessage接口初始化(Create2BizMsg).....................................88

3.15.22连接发送IBizMessage业务消息(SendBizMsg)..........................................89

3.15.23连接接收IBizMessage业务消息(RecvBizMsg)..........................................89

3.15.24创建文件更新(NewFileUpdate)...................................................................89

3.15.25获取文件更新最后错误信息(GetFileUpdateLastError)............................90

3.15.26获取最后应答错误信息(GetLastAnsError).................................................90

3.15.27创建订阅者(NewSubscriberEx)....................................................................91

3.15.28设置usejtoken(SetUserToken).................................................................