C版API使用方法.txt

【编译方法】
-----------------------------------------------------------------------------------------------------------------------------------------------------
本工程支持源代码方式编译或者直接通过lib下的库文件链接

1、根据编译机器的操作系统确定OS_TYPE=[Windows/Linux/Unix]，默认Linux；
2、make premake的使用，首次编译或者makeclean之后需要先做预处理；
3、选择编译类型 BUILD_TYPE=[Debug/Release]，默认Debug；
4、示例
   Windows下编译Debug版本
   make OS_TYPE=Windows premake [首次编译或者完成清理]
   make OS_TYPE=Windows BUILD_TYPE=Debug
   make OS_TYPE=Windows clean [清理时才会调用]

   Linux下编译Debug版本
   make OS_TYPE=Linux premake [首次编译或者完成清理]
   make OS_TYPE=Linux BUILD_TYPE=Debug
   make OS_TYPE=Linux clean [清理时才会调用]

   Unix下编译Debug版本
   make OS_TYPE=Unix premake [首次编译或者完成清理]
   make OS_TYPE=Unix BUILD_TYPE=Debug
   make OS_TYPE=Unix clean [清理时才会调用]

【接口使用说明】
-----------------------------------------------------------------------------------------------------------------------------------------------------
具体使用方法请参见接口头文件注释 src/eps/epsClient.h
客户端演示用例请参见 src/test/simpleEpsClient.c 和 src/test/complexEpsClient.c

simpleEpsClient是同步调用模式示例，仅适用于UDP，调用过程如下：
--> 初始化过程
1、调用EpsInitLib()初始化Express库
2、调用EpsCreateHandle()创建新句柄，
3、调用EpsRegisterSpi()注册回调通知函数
4、调用EpsConnect()启动连接服务器
5、调用EpsSubscribeMarketData()订阅指定市场行情

--> 回调过程
1、在注册的行情数据到达通知函数mktDataArrivedNotify中处理行情数据

--> 注销过程
1、调用EpsDisconnect()断开服务器连接
2、调用EpsDestroyHandle()销毁句柄
3、调用EpsUninitLib()注销Express库

complexEpsClient是一种异步调用模式，同时适用于TCP和UDP，调用过程如下：
--> 初始化过程
1、调用EpsInitLib()初始化Express库
2、调用EpsCreateHandle()创建新句柄，
3、调用EpsRegisterSpi()注册回调通知函数
4、调用EpsConnect()启动连接服务器

--> 回调过程
1、在注册的连接成功通知connectedNotify中调用EpsLogin()进行登录
2、在注册的登录应答通知loginRspNotify中调用EpsSubscribeMarketData()订阅指定市场行情
3、在注册的行情数据到达通知函数mktDataArrivedNotify中处理行情数据
4、在注册的连接断开通知disconnectedNotify、登出应答通知logoutRspNotify、事件发生通知eventOccurred中进行事件处理（可选）

--> 注销过程
1、调用EpsLogout()登出服务器（可选）
2、调用EpsDisconnect()断开服务器连接
3、调用EpsDestroyHandle()销毁句柄
4、调用EpsUninitLib()注销Express库

注意事项：
1、EpsInitLib()必须是第一个被调用的Express库函数
2、EpsUninitLib()必须是最后一个被调用的Express库函数
3、Express库支持最多同时创建32个句柄
4、Express库支持多线程调用
4、Express允许用户在注册回调通知时不实现所有的回调接口，原则是不注册即不通知
5、EpsInitLib()、EpsUninitLib()、EpsDestroyHandle()禁止在回调通知函数中调用