SWIG 将 unsigned char* 转换为 20 字节缓冲区 Java 结构

Question

我有一个 C 函数（composeKey），它有一个输入 unsigned char* 参数（“key”）。在 C 端，“key”需要是一个空的 20 字节缓冲区结构。我假设大小为 20 的 Java 短数组是传递 composeKey 的“key”参数的正确 Java 结构，但我不确定。也许我需要一个字节[20]。如果这是正确的，需要对 SWIG 接口文件进行哪些修改才能生成 composeKey Java 方法，并使用短[]作为“key”参数的输入？

C Function:
int composeKey(const void* secret, int secret_len, unsigned char* key, int length);

Answer 1

针对您的具体问题的解决方案

Java 在其类型系统中并没有真正区分 short[20] 和（例如）short[21] 。不过，您可以做一些非常简单的事情，通过使 key 的长度对于 SWIG 来说始终是 20 的事实：

%module test

%include "arrays_java.i"

int func(unsigned char key[20]);

即使不直接更改函数的实际签名，这也可以工作 - SWIG 可以包装它，但让包装的代码调用一个仍然需要 unsigned char* 的函数，这非常明智：

%module test

%{
#include "header.h"
// fine even if it's func(unsigned char *key) in the header.
%}

%include "arrays_java.i"
int func(unsigned char key[20]);

如果您使用不适当大小的数组从 Java 调用 func，您将得到一个SWIG 生成的代码自动为您抛出 IndexOutOfBoundsException 异常。

---

一般解决方案

在这种特定情况下，“arrays_java.i”已经提供了合适的类型映射。在更一般的情况下，这是通过为 SWIG 提供 unsigned char [ANY] 的类型映射来实现的（在 SWIG 类型映射语法中按字面意思编写 ANY）。然后，它会被实例化为特定值来代替 ANY（有点像 C++ 中的模板），然后您可以使用 在类型映射中访问 ANY 的特定值>$1_size 并提供填充尺寸的代码（为简洁起见，省略了一些 JNI 详细信息），大致如下：

if (GetArrayLength(arg) != $1_size) {
    // Code to throw a Java Exception ...

然后在生成的包装器中变为：

if (GetArrayLength(arg) != 20) {
    // Code to throw a Java Exception ...