转载https://www.cnblogs.com/anyun/p/9268895.html
目前上期技术CTP系统提供的API版本是C++版本
SWIG是一个能将C/C++接口转换为其他语言的工具,目前可以支持Python,Java,R等语言。
本文主要介绍Windows 32/64位平台下利用Swig工具将CTP C++接口API转换为Java可调用的接口。
1、从CTP官网下载最新API包,包中包含32位和64位。API文件包清单:
2、下载安装Swig软件:
3、编写接口*.i文件。swig是根据h头文件编写接口的,需要输入的h文件编写在i文件中。
这里着重说一下转换中遇到的问题。首先swig中转换 char *str[] 和char **时会转换成SWIGTYPE_p_p_char类型,这里需要various.i文件。various.i文件是swig自带的,将swig/Lib/java/various.i拷贝过来即可。在API文件包中创建thostapi.i 和various.i文件,thostapi.i是一个接口文件,用于告诉swig为哪些类和方法创建接口。various.i是用于将C++接口中的数组参数转换为java 的Array的工具类。
1 %module(directors="1") thosttraderapi2 %include "various.i"
3 %apply char **STRING_ARRAY { char *ppInstrumentID[] }4 %{5 #include "ThostFtdcMdApi.h"
6 #include "ThostFtdcTraderApi.h"
8 %}
26 %feature("director") CThostFtdcMdSpi;27 %ignore THOST_FTDC_VTC_BankBankToFuture;28 %ignore THOST_FTDC_VTC_BankFutureToBank;29 %ignore THOST_FTDC_VTC_FutureBankToFuture;30 %ignore THOST_FTDC_VTC_FutureFutureToBank;31 %ignore THOST_FTDC_FTC_BankLaunchBankToBroker;32 %ignore THOST_FTDC_FTC_BrokerLaunchBankToBroker;33 %ignore THOST_FTDC_FTC_BankLaunchBrokerToBank;34 %ignore THOST_FTDC_FTC_BrokerLaunchBrokerToBank;35 %include "ThostFtdcUserApiDataType.h"
36 %include "ThostFtdcUserApiStruct.h"
37 %include "ThostFtdcMdApi.h"
38 %feature("director") CThostFtdcTraderSpi;39 %include "ThostFtdcTraderApi.h"
忽略8个方法,因为涉及到将字符串转换为char类型,有问题。后面可以省略注释掉这几个方法。
4、生成java接口:
在当前文件夹创建src/ctp文件夹用于放置生成的java文件
..\..\swigwin-2.0.11\swig.exe -c++ -java -package ctp.thosttraderapi -outdir src -o thosttraderapi_wrap.cpp thostapi.i
运行完成之后,可在当前文件夹中看到用于包装原来C++接口的文件:
5、通过C++得到java可调用的动态库
创建一个C++工程,应用程序类型选择DLL,将以下文件添加到工程中去:
将dk目录\Java\jdk1.8.0_111\include下的jni.h和win32文件夹下的jni_md.h, jawt_md.h一共三个文件
拷贝到安装vs的include目录底下\Microsoft Visual Studio 12.0\VC\include。
因为thosttraderapi_wrap.cpp文件中包含了,是用于生成Java可调用接口的库文件。
在thosttraderapi_wrap.cpp中将如下8个函数注释掉,这几个函数中涉及到将字符串转换为char类型,有问题。当你编译时报错说字符常量字数太多,可以看到‘xxxx’的字符常量。这是ctp自带的错,但是没有应用所以没有被他们发现。把这些函数注释即可。
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1VTC_1BankBankToFuture_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1VTC_1BankFutureToBank_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1VTC_1FutureBankToFuture_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1VTC_1FutureFutureToBank_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1FTC_1BankLaunchBankToBroker_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1FTC_1BrokerLaunchBankToBroker_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1FTC_1BankLaunchBrokerToBank_1get
Java_ctp_thosttraderapi_thosttradeapiJNI_THOST_1FTDC_1FTC_1BrokerLaunchBrokerToBank_1get
之后进行编译,生成java可调用的动态库文件thosttraderapi_wrap.dll:
6、创建java项目,将三个动态库和之前生成的src/ctp包拷贝到项目,并加载动态库进来:
到此java API制作完成,可以进行java开发了。
一、普通回报中文乱码
此类型常见的乱码主要存在于 CThostFtdcRspInfoField 结构体中的 ErrorMsg 字段,用于在接口调用存在错误时返回必要参考信息,除此之外,通过结构体 CThostFtdcInstrumentField 获取合约中文名称等信息出现乱码也是常见的乱码问题之一。
具体原因:
1. Java基于Unicode字符集,并有多个类库实现了Unicode标准,运行时内部字符串使用UTF-16,默认使用UTF-8序列化字符串。因此当JNI返回字符串时,应调用NewStringUTF方法(当输入为UTF-8时),或者调用NewString(当输入为UTF-16时)方法,最终生成可以在Java中返回的jstring。
2. CTP官方使用的是国标编码,也就是(GB18030>GBK>GB2312)中的一种。
3. SWIG封装时对JNI返回的字符串默认调用JNI中的NewStringUTF方法,显然,CTP官方使用的并不是UTF-8编码,因此出现了乱码,且这个过程中会产生信息丢失,是一个不可逆的错误。
存在如下两类解决方案:
第一类为定义宏 NewStringByGB2312 如下,然后搜索所有的C++文件中的 if (result) jresult = jenv->NewStringUTF((const char *)result); 用该宏替换。
define NewStringByGB2312\
if(result)\
{\
jclass str_cls = jenv->FindClass("java/lang/String");\
jmethodID constructor_mid = jenv-> GetMethodID(str_cls,"","([BLjava/lang/String;)V");\
jbyteArray bytes = jenv->NewByteArray( strlen(result));\
jenv->SetByteArrayRegion(bytes, 0, strlen(result),(const jbyte*) result);\
jstring charsetName = jenv->NewStringUTF("gb2312");\
jresult = (jstring)jenv->NewObject(str_cls, constructor_mid, bytes, charsetName);\
jenv->DeleteLocalRef(str);\
jenv->DeleteLocalRef(bytes);\
jenv->DeleteLocalRef(str_cls);\
}\
这样操作通过C++直接调用Java中的String构造方法,传入C++中的字节数组,设置字符集,因此能够正确解析编码,转换为正确的Java字符串对象。
第二类为借助第三方库iconv。在SWIG配置文件中加入如下代码, 并在生成的代码中加入头文件iconv.h和相关运行库。
%include "various.i"
%typemap(out) char[ANY], char[] {
if ($1) {
iconv_t cd = iconv_open("utf-8", "gbk");
if (cd != reinterpret_cast(-1)) {
char buf[4096] = {};
char **in = &$1;
char *out = buf;
size_t inlen = strlen($1), outlen = 4096;
if (iconv(cd, in, &inlen, &out, &outlen) != static_cast(-1))
$result = JCALL1(NewStringUTF, jenv, (const char *)buf);
iconv_close(cd);
}
}
}
这样操作生成的代码会借助iconv库在C++层面将GBK编码转换为UTF-8编码,因此JNI生成字符串对象时可以生成正确的Java字符串对象。
二、结算单乱码
查询结算单返回结果回调中字段Content是一个长度为501的数组。显然我们的结算单长度往往不止501,所以我们需要注意这个回调方法中还有bIsLast标志,因为结算单实际是多次回报分段传输的,且第501个字符为'\0',仅用于占位,这并不代表字符串结束。
在更底层的字符编码存储传输层面,我们上文提到的国标编码(GB18030>GBK>GB2312)是变长的,因此不能确保每个批次的第500位结束的时候刚好是一个字符结束,因此有可能存在一个字符所属存储编码的前n个字节存在于当前回报的数组尾部,后n个字节存在于下一次回报数组头部。如果我们不做任何修改,SWIG生成的C++和Java代码会将每次回报都直接生成一个字符串从C++返回到Java层面,因此我们会看到结算单一部分正确,一部分错误,混杂部分乱码,或者有时候完整,有时候不完整。
针对上述情况,我们的解决思路是对服务器返回的n个501长度的数组截取每个数组的前500位进行拼接,直到收到bIsLast标记,组成一个n*500的数组。这个操作可以在C++中完成,也可以在Java中完成,显然,在C++中完成会做较大的修改,因此我们可以选择在Java中修改。具体步骤如下。
在cpp中搜索CThostFtdcSettlementInfoField_1Content_1get函数,将函数返回类型改为jbyteArray,将内容改为如下:
jbyteArray jresult = 0 ;
CThostFtdcSettlementInfoField *arg1 = (CThostFtdcSettlementInfoField *) 0 ;
char *result = 0 ;
(void)jenv;
(void)jcls;
(void)jarg1_;
arg1 = *(CThostFtdcSettlementInfoField **)&jarg1;
result = (char *) ((arg1)->Content);
return result;
请注意仅需修改返回类型和内容代码,方法名称是swig生成的,不能修改。
完成上述步骤后,手动将 CThostFtdcSettlementInfoField.java 文件中的函数 getContent() 方法的返回类型改为byte[],将其调用的其他类的方法的返回类型也改为byte[]直到无错为止。
在Java中完成拼接后,使用 new String(contentBytes,"GBK"),便可得到完全正确的结算。需要提示的是,最后一组从C++返回到Java的Byte[]长度不一定是501,请根据实际长度处理。
————————————————
版权声明:本文为CSDN博主「景色正好」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/pjjing/article/details/103104047