PDF《郑州商品交易所》

11 协议时, 系统会采用 UDP 广播行情变化等信息. 具体参见 《郑 州商品交易所 ZCEAPI 参考手册》. 1.6 ZCEAPI 使用环境 ZCEAPI 支持的操作系统平台主要有:Windows 和Linux.并分别提供

32 位和

64 位版 本.ZCEAPI 在发布前,在如下平台做过基本的兼容性测试(随着系统平台的持续更新,客 户可自行选择后续发行版本,并做好兼容性和功能性测试,如遇到问题需要协助,请及时和 郑商所取得联系): ? Red Hat Enterprise Linux Server release 6.5 (Santiago) X64 内核版本:2.6.32-431.el6.x86_64 gcc 版本: 4.4.7

20120313 (Red Hat 4.4.7-17) ? CentOS release 6.5 (Final) X32 内核版本:2.6.32-431.el6.i686 gcc 版本: 4.4.7

20120313 (Red Hat 4.4.7-17) ? Windows 8.1 专业版 64-bit (9600.130821-1623) VS 版本:Visual Studio

2013 ? Windows

7 旗舰版 64-bit (6.1, Build 7601) Service Pack

1 (7601.130828-1532) 郑州商品交易所 ZCEAPI 使用手册

5 VS 版本:Visual Studio

2013 Windows 平台下它以动态库(.dll)的形式被应用程序调用.在Linux/Unix 平台下它以 动态库(.so)的形式被应用程序调用.相应平台下的动态库文件随本文档发布. 使用该 API 不需要进行特殊的系统配置和安装.用户只需从郑州商品交易所获得相应 平台下的动态库文件及相应的辅助文件即可使用. 1.7 ZCEAPI 相关文件说明 发布的 ZCEAPI 相关文件如下: Windows 平台下: FTDDLL.dll ZCEAPI 的动态库. FTDDLL.lib ZCEAPI 动态库引导库文件,C++用户开发使用. Config.h ZCEAPI 类型和常量声明文件,和FTDAPI.h 文件配合使用. 用于 C++用户开发. FTDAPI.h ZCEAPI 的接口定义文件,C++ 用户可以直接使用(结合 Config.h),其他语言用户可以根据文件中的 C++ 形式的接口 函数定义,得到相应语言下的接口函数声明及类型定义. FieldID.h ZCEAPI 数据包的数据域常量定义文件,C++用户可以直接 使用.其他语言的用户可以根据其具体情况作出相应的转化. Linux 平台下: libZCEFTDAPI.so ---- ZCEAPI 的动态库文件. Config.h ZCEAPI 类型和常量声明文件,和FTDAPI.h 文件配合使用. 用于 C++用户开发. FTDAPI.h ZCEAPI 的接口定义文件,C++用户可以直接使用(结合 Config.h). FieldID.h ZCEAPI 数据包的数据域常量定义文件,C++用户可以直接使 用. 2. ZCEAPI 使用说明 2.1 使用概述 郑州商品交易所应用编程接口(ZCEAPI)具有功能强大使用方便的特点. ZCEAPI 在系统中以动态库的形式出现,提供的是标准 C 接口函数和符合 C(C++)语 法定义的数据类型.这些函数和类型的定义请参见本文档第

4 部分的说明. 用户要使用 ZCEAPI 请务必从郑州商品交易所得到相应平台下的动态库文件 (Windows 平台下是 FTDDLL.dll,Linux 平台下是 libZCEFTDAPI.so),这是使用 ZCEAPI 所必需的文 件. 一般情况下使用动态链接库,程序员都必须对动态库提供的接口做出声明.在使用 郑州商品交易所 ZCEAPI 使用手册

6 ZCEAPI 时所要做的声明分两部分---接口函数和基本数据定义.C++程序员可以直接使用随 动态库发布的 FTDAPI.h 文件和 Config.h 文件(FTDAPI.h 引用了 Config.h),FTDAPI.h 和Config.h 提供了 ZCEAPI 的所有的声明.其他语言用户,请根据 FTDAPI.h 中关于 ZCEAPI 的接口声明或本文档下面相应部分的说明,声明出相应语言的 ZCEAPI 接口. 另外, 因为 ZCEAPI 是一个用来进行数据交换的接口, 所以接口提供了自己的数据包格 式.用户可以根据相应的业务填写或读取相应的数据域字段.对于业务和数据域 ZCEAPI 也作出了相应的编码.有关编码的对应表请参见《郑州商品交易所 ZCEAPI 参考手册》中的 相关说明.用户也可根据《郑州商品交易所 ZCEAPI 参考手册》中的定义结合所使用的语言 在程序中给出常量定义. 至于各种平台下的标准动态库的使用方法, 请参考相应平台下的相关技术文档或书籍的 介绍. 使用 ZCEAPI 实际就是对 ZCEAPI 提供的接口的使用. 对ZCEAPI 的调用有一定的先后 顺序:首先,调用 ftd_api_init 函数初始化 API,这是用户必须做成功的一步;