零基础易盛9.0API入门二：登陆 外盘期货数据接口

一、前言

前一节解决了开发环境问题，这一节就进一步实现API登陆交易服务。

我们先简要说明下API涉及的两个类ITapTradeAPI和ITapTradeAPINotify，他们分别实现了“指令”和“回调消息”的功能。

ITapTradeAPI（指令）：比如发送下单指令、登陆指令、撤单指令等。

ITapTradeAPINotify（回调消息）：各种指令发送后的执行情况通过这个接口返回，比如登陆是否成功、下单结果如何，还有就是一些重要消息，比如连接是否成功、盈亏通知等。

实际上开发包里已经有一个很完备的demo，为了便于理解我就把它拆分成了好几个小节，一步一步完成学习。

二、创建API实例

TapAPIApplicationInfo stAppInfo;

strcpy(stAppInfo.AuthCode, DEFAULT_AUTHCODE);

strcpy(stAppInfo.KeyOperationLogPath, "\log");

ITapTradeAPI *pAPI = CreateITapTradeAPI(&stAppInfo, iResult);

这里的TapAPIApplicationInfo是一个存数据的结构体，主要包括“授权码”、“日志存放路径”、“断线重连设置”

 

 

 授权码和测试用登陆账户、密码在demo里都有。

最后通过CreateITapTradeAPI()函数创建了API的实例

三、为API实例指定消息回调

创建API实例后就可以做指令操作了，但指令的结果获取是异步的，9.0API要求开发者继承ITapTradeAPINotify这个类并自己实现其中的各种消息接口。

 

 

 其实就是像上图这样，按ITapTradeAPINotify的接口要求定义好各种函数，在函数里写你的代码就行了，当有消息返回时就会根据消息的类型执行不同函数内的代码。

 

 然后你会发现函数前面都有个TAP_CDECL关键字，它定义是

 

 含义为：若当前系统是windows的，TAP_CDECL = __cdecl，若为linux系统则此关键字没有含义。具体含义可以百度下，反正我们是linux系统所以没有作用。

 各回调函数的说明在demo中有说明文档，也可以在“iTapTradeAPI.h”文件中找到。定义好回调类后，还需要将API实例与回调实例关联在一起。

Trade objTrade; pAPI->SetAPINotify(&objTrade);

四、登陆测试

//设置服务器IP、端口

pAPI->SetHostAddress(DEFAULT_IP, DEFAULT_PORT);

//设置账户信息

TapAPITradeLoginAuth stLoginAuth;

memset(&stLoginAuth, 0, sizeof(stLoginAuth));

strcpy(stLoginAuth.UserNo, DEFAULT_USERNAME);

strcpy(stLoginAuth.Password, DEFAULT_PASSWORD);

stLoginAuth.ISModifyPassword = APIYNFLAG_NO;

//登陆

pAPI->Login(&stLoginAuth);

//等待回调消息

while(true){

}

最后为什么会是个while的死循环呢？因为整个过程都是异步的，发送登陆指令和登陆结果的消息通知是分开的，所以要在主进程里死循环等待，以后会介绍demo里的一个等待消息的方法。

执行效果如下：

 

 

五、回顾

简单实现了登陆操作，但是把整体结构过了下，其实挺简单的。

完整代码：https://share.weiyun.com/5szXtuo