【零基础】易盛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

原文地址:https://www.cnblogs.com/cation/p/12515433.html