使用 SWIG 在 Java 和 C++ 之间传递缓冲区

Question

我想使用 SWIG 在 Java 和 C++ 之间传递一段信息（例如 1024 字节内存）。 C++中定义的结构体如下：

struct Buffer
{
    unsigned char *addr;
    size_t        size;
}

为此，我应该如何编写 SWIG 接口文件？

Answer 1

您还不完全清楚您想要实现的目标。

如果您想将 Buffer 映射到 Java byte[]，您可以使用自定义类型映射：

%typemap(jni) Buffer "jbyteArray"
%typemap(jtype) Buffer "byte[]"
%typemap(jstype) Buffer "byte[]"
%typemap(in) Buffer {
    .addr = (unsigned char *) JCALL2(GetByteArrayElements, jenv, $input, 0);
    .size = JCALL1(GetArrayLength, jenv, $input);
}
%typemap(argout) Buffer {
    JCALL3(ReleaseByteArrayElements, jenv, $input, (jbyte *) .addr, 0);
}
%typemap(out) Buffer {
    $result = JCALL1(NewByteArray, jenv, .size);
    JCALL4(SetByteArrayRegion, jenv, $result, 0, .size, (jbyte *) .addr);
    delete[] .addr;
}
%typemap(javain) Buffer "$javainput"
%typemap(javaout) Buffer { return $jnicall; }

然后像这样的 C++ 代码

  Buffer getData();
  void sendData(Buffer arg);

将映射到 Java:

  public static byte[] getData() { ... }
  public static void sendData(byte[] arg) { ... }

将数据传递给 Java 的困难在于将其放入 JVM 堆 and/or 以管理数据的生命周期。通过一些复制很容易实现，但真正的 0 复制解决方案通常需要更改 C++ 接口。

完整示例：

example.h

#include <stddef.h>
struct Buffer
{
    unsigned char *addr;
    size_t        size;
};
Buffer getData();
void sendData(Buffer);

example.cxx

#include "example.h"

Buffer getData() {
    Buffer rc { new unsigned char[64], 64 };
    for (int i = 0; i < rc.size; ++i)
        rc.addr[i] = 0x40 + i;
    return rc;
}
void sendData(Buffer buf) {
    // use buf.addr
}

example.i

%module example
%{ 
#include "example.h"
%}
%typemap(jni) Buffer "jbyteArray"
%typemap(jtype) Buffer "byte[]"
%typemap(jstype) Buffer "byte[]"
%typemap(in) Buffer {
    .addr = (unsigned char *) JCALL2(GetByteArrayElements, jenv, $input, 0);
    .size = JCALL1(GetArrayLength, jenv, $input);
}
%typemap(argout) Buffer {
    JCALL3(ReleaseByteArrayElements, jenv, $input, (jbyte *) .addr, 0);
}
%typemap(out) Buffer {
    $result = JCALL1(NewByteArray, jenv, .size);
    JCALL4(SetByteArrayRegion, jenv, $result, 0, .size, (jbyte *) .addr);
    delete[] .addr;
}
%typemap(javain) Buffer "$javainput"
%typemap(javaout) Buffer { return $jnicall; }
%ignore Buffer;
%include "example.h"

test.java

class test {
    public static void main(String[] args) throws Exception {
       System.loadLibrary("_example");
       byte[] data = example.getData();
       System.out.println(new String(data));
    }
}

输出:

@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~⌂

使用 SWIG 在 Java 和 C++ 之间传递缓冲区

Passing buffer between Java and C++ using SWIG

java

c++

swig