c

HLNDSLN

J

金融基礎件2.0接入

T2SDK開發(fā)手冊

文檔版本V2.0

發(fā)布日期2013-06-27

修改記錄

版本號日期修改者修改說明

V2.0許欣亢創(chuàng)建

目錄

目錄...........................................................................3

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

產品簡介.....................................................................9

讀者對象.....................................................................9

手冊概況.....................................................................9

縮略語/術語..................................................................9

1.開發(fā)包簡介................................................................11

2.開發(fā)流程..................................................................12

2.1同步開發(fā)流程.......................................................12

2.2異步開發(fā)流程.......................................................12

3.開發(fā)接口..................................................................14

3.1T2SDK引出函數.....................................................14

3.1.1取開發(fā)包版本信息(GetVersionlnfo)............................................................14

3.1.2創(chuàng)建配置接口(NewConfig)...........................................................................14

3.1.3創(chuàng)建連接接口(NewConnection)...................................................................15

3.1.4創(chuàng)建打包器接口(NewPacker).......................................................................15

3.1.5創(chuàng)建解包器接口(NewUnPacker)..................................................................15

3.1.6創(chuàng)建v1解包器接口(NewUnPackerVI)...........................................16

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

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

3.1.9創(chuàng)建過濾接口(NewFilter).............................................................................17

3.1.10創(chuàng)建訂閱參數接口(NewSubscribeParam)...................................................17

3.1.11創(chuàng)建業(yè)務消息接口(NewBizMessage)..........................................................17

3.1.12創(chuàng)建業(yè)務消息接口(NewBizMessageEx)......................................................18

3.1.13創(chuàng)建空解包器接口(NewEmptyUnPacker)...................................................18

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

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

3.1.16獲取發(fā)送接收字節(jié)數(GetRateBytes)..........................................................20

3.1.17重置發(fā)送接收字節(jié)數(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數據發(fā)送回調Consent).................................................................................25

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

3.3.7收到消息擴展回調(OnReceivedBizEx)........................................................26

3.3.8收到業(yè)務消息回調(OnReceivedBizMsg).....................................................27

3.4業(yè)務消息接口【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設置營業(yè)部號CSetBranchNo)........................................................................29

3.4.6獲取營業(yè)部號CGetBranchNo).......................................................................29

3.4.7設置系統(tǒng)號(SetSystemNo)...........................................................................29

3.4.8獲取系統(tǒng)號(GetSystemNo)...........................................................................29

3.4.9設置子系統(tǒng)號^SetSubSystemNo)..................................................................30

3.4.10獲取了系統(tǒng)號[GetSubSystemN。)................................30

3.4.11設置發(fā)送者編號(SetSenderld).....................................................................30

3.4.12獲取發(fā)送者編號(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設置發(fā)送者路由(SetSendlnfo).....................................................................32

3.4.18獲取發(fā)送者路由(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設置業(yè)務內容(SetContent)...........................................................................35

3.4.26獲取業(yè)務內容(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設置業(yè)務保留域(SetAppReserved).............................................................41

3.4.44獲取業(yè)務保留域(GetAppReserved).............................................................41

3.4.45設置發(fā)送者公司編號(SetSenderCompanylD)............................................42

3.4.46獲取發(fā)送者公司編號(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設置緩存區(qū)空間(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設置發(fā)送間隔(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獲取發(fā)送間隔^GetSendInterval)...................................................................67

3.9.18設置是否更新消息序號(SetUpdateMsgNo)...............................................68

3.9.19獲取是否更新消息序號(GetUpdateMsgNo)...............................................68

3.9.20重置過濾字段接口(ReSetFilter)..............................................................68

3.10訂閱回調接口[CSubCallbacklnterface].................................................................68

3.10.1收到發(fā)布消息回調(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發(fā)布接口[CPublishnterface].................................................................................73

3.12.1業(yè)務發(fā)包格式發(fā)送(PubMsgByPacker)..............................................................74

3.12.2二進制數據發(fā)送(PubMsg).................................................................................75

3.12.3獲取當前主題的發(fā)布序號(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取連接狀態(tài)(GetStatus).................................................................................80

3.15.6取服務器負載CGetServerLoad).....................................................................80

3.15.7取錯誤碼對應的錯誤信息(GetErrorMsg)...................................................81

3.15.8取連接錯誤號(GetConnectError)................................................................81

3.15.9發(fā)送業(yè)務數據CSendBiz)................................................................................81

3.15.10接收業(yè)務數據(RecvBIz).................................................................................82

3.15.11發(fā)送業(yè)務數據擴展接口(SendBizEx)............................................................83

3.15.12接收業(yè)務數據擴展接口(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創(chuàng)建訂閱者(NewSubscriber).......................................................................86

3.15.18獲取發(fā)布者(NewPublisher)..........................................................................86

3.15.19獲取主題信息(GetTopic)...............................................................................87

3.15.20獲取消息中心的最后錯誤(GetMCLastError).............................................88

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

3.15.22連接發(fā)送IBizMessage業(yè)務消息(SendBizMsg)..........................................89

3.15.23連接接收IBizMessage業(yè)務消息(RecvBizMsg)..........................................89

3.15.24創(chuàng)建文件更新(NewFileUpdate)...................................................................89

3.15.25獲取文件更新最后錯誤信息(GetFileUpdateLastError)............................90

3.15.26獲取最后應答錯誤信息(GetLastAnsError).................................................90

3.15.27創(chuàng)建訂閱者(NewSubscriberEx)....................................................................91

3.15.28設置usejtoken(SetUserToken).................................................................