Swig 3.0：C++向Java返回带长度字节数组的结构体映射咨询

当然可以！这其实是用SWIG处理C++和Java之间二进制数据传递的非常经典的方案，完全符合你的需求。我来一步步给你讲怎么实现：

第一步：定义C++结构体 #

首先在C++里定义包含缓冲区和长度的结构体，建议再加一个标记字段来管理内存（避免误释放不属于我们的内存）：

#include <cstddef> // 引入size_t的定义

struct BinaryData {
    const char* buffer;   // 二进制数据缓冲区
    size_t length;        // 缓冲区长度
    bool owns_buffer;     // 标记是否由该结构体负责释放内存
};

// 示例：生成并返回二进制数据的C++函数
BinaryData generate_binary_data() {
    // 模拟生成16字节的二进制数据
    const size_t data_len = 16;
    char* buf = new char[data_len];
    for (size_t i = 0; i < data_len; ++i) {
        buf[i] = static_cast<char>(0x10 + i); // 填充测试二进制值
    }
    return {buf, data_len, true}; // 标记由结构体管理内存
}

第二步：编写SWIG接口文件 #

接下来写SWIG接口文件（比如binary_data.i），配置类型映射和内存管理逻辑，确保Java端能安全使用结构体：

%module BinaryDataModule

%{
#include "binary_data.h" // 引入你的C++头文件
%}

// 让SWIG识别size_t类型
%include <cstddef.i>
// 导入我们定义的结构体
%include "binary_data.h"

// 为结构体添加自动内存释放逻辑：当Java对象被GC时，释放缓冲区
%extend BinaryData {
    ~BinaryData() {
        if ($self->owns_buffer) {
            delete[] $self->buffer; // 释放堆分配的内存
        }
    }
}

// 可选优化：直接把BinaryData映射为Java的byte[]，简化使用
%typemap(jstype) BinaryData "byte[]"
%typemap(javaout) BinaryData {
    byte[] result = new byte[(int)$jnicall.length];
    $javacall.copyToByteArray(result);
    return result;
}

// 给结构体添加私有方法，用于将C++缓冲区复制到Java数组
%extend BinaryData {
    void copyToByteArray(jbyteArray arr) {
        if (!$self->buffer || $self->length == 0) return;
        JNIEnv* env = JNI_GetEnv();
        env->SetByteArrayRegion(arr, 0, static_cast<jsize>($self->length), 
                                reinterpret_cast<const jbyte*>($self->buffer));
    }
}

第三步：Java端使用示例 #

用SWIG生成Java绑定后，你可以两种方式使用：

方式1：直接获取byte[]（推荐，更符合Java习惯） #

public class Main {
    public static void main(String[] args) {
        // 调用C++函数，直接拿到Java字节数组
        byte[] binaryData = BinaryDataModule.generate_binary_data();
        System.out.println("Received " + binaryData.length + " bytes of binary data");
        
        // 直接操作字节数组即可，内存会自动由GC管理
    }
}

方式2：手动处理结构体（适合需要精细控制的场景） #

public class Main {
    public static void main(String[] args) {
        BinaryData data = BinaryDataModule.generate_binary_data();
        try {
            long length = data.getLength();
            byte[] buffer = new byte[(int)length];
            data.copyToByteArray(buffer);
            
            // 在这里使用buffer
            System.out.println("Buffer length: " + buffer.length);
        } finally {
            // 手动释放（如果没加自动析构逻辑的话，不过我们的SWIG配置已经加了，GC时会自动释放）
            data.delete();
        }
    }
}

关键注意事项 #

• 内存安全第一：绝对不要返回C++栈上的指针（会导致悬垂指针崩溃），必须返回堆分配的内存，并用owns_buffer标记区分是否需要释放。
• size_t类型转换：Java没有size_t，SWIG会映射为long，如果你的数据长度超过int范围，要注意用long处理，避免溢出。
• 避免重复释放：如果缓冲区是外部传入的（比如Java端传递给C++的），要把owns_buffer设为false，防止SWIG误释放内存。

内容的提问来源于stack exchange，提问作者Angelo Mantellini