返回结果乱码_JAVA封装CTP API中文乱码解决方案

た入场券 2023-01-06 01:28 180阅读 0赞

目前上期技术官方提供的CTP API是C++版本，但在实际使用中不少客户的量化交易系统是Java写的，这就需要有一个JAVA封装CTP API的，可供JAVA直接使用的动态库。

SWIG是一个能将C/C++接口转换为其他语言的工具，目前可以支持Python,Java,R等语言，已有成熟的教程。在用swig生成JAVA版CTP API的过程中，最大的问题莫过于返回值中文乱码问题。

本文主要介绍封装时产生的两类乱码问题，一类是普通回报中的字符串乱码问题，另一类是结算单乱码问题。其中结算单乱码问题对其他编程语言亦有参考意义。

一、普通回报中文乱码

此类型常见的乱码主要存在于 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<iconv_t>(-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<size_t>(-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);

请注意仅需修改返回类型和内容代码，方法名称是swig生成的，不能修改。

完成上述步骤后，手动将 CThostFtdcSettlementInfoField.java 文件中的函数  getContent() 方法的返回类型改为byte\[\],将其调用的其他类的方法的返回类型也改为byte\[\]直到无错为止。

在Java中完成拼接后，使用 new String(contentBytes,"GBK")，便可得到完全正确的结算。需要提示的是，最后一组从C++返回到Java的Byte\[\]长度不一定是501，请根据实际长度处理。

**特别感谢本文作者E&N无私奉献！**

往期推荐

● CTP程序化交易入门系列之一：准备

● CTP程序化交易入门系列之二：API基本架构及初始化

● CTP程序化交易入门系列之三：获取实时行情及K线合成

● CTP程序化交易入门系列之四：行情订阅常见问题解答

● CTP程序化交易入门系列之五：现手、增仓、开平、对手盘计算

● CTP 4097错误根源

● Level-1、Level-2、快照数据、Tick数据的区别你都了解吗？