如何配置SWIG接口实现C++ aVector2到Java多float参数的映射

关于性能的补充说明 #

首先纠正你的性能认知：SWIG自动生成的aVector2 Java包装类，内部JNI调用FindClass()、GetFieldID()这类操作只会在第一次访问类/字段时执行，后续会缓存结果，实际运行时开销非常小。如果不是极致性能场景，直接用默认生成的包装类完全没问题。但如果确实需要避免创建对象，下面的方案可以实现你的需求。

正确的SWIG接口文件配置 #

你之前的typemap写法有误，需要针对「单个aVector2参数拆分为两个float参数」的场景配置多参数typemap。以下是完整的SWIG接口文件（假设命名为example.i）：

%module example

// 定义JNI层的参数类型：两个jfloat
%typemap(jni) aVector2 "jfloat, jfloat"
// Java native方法的参数类型：两个float
%typemap(jtype) aVector2 "float, float"
// Java上层调用的参数类型：两个float
%typemap(jstype) aVector2 "float, float"

// 处理Java传入的两个float，组装成C++的aVector2对象
%typemap(in) aVector2 {
    $1.x = $input1; // 第一个Java传入的float赋值给x
    $1.y = $input2; // 第二个Java传入的float赋值给y
}

// 生成Java侧的包装方法，将两个float参数转发给native方法
%typemap(javain) aVector2 "$javainput1, $javainput2"

// 包含C++头文件
%{
#include "example.h"
%}

// 告诉SWIG要包装的结构体和函数
struct aVector2 {
    float x, y;
};

float sum(aVector2 v2);

代码解释 #

• %typemap(jni): 指定JNI函数的参数类型，把原本的aVector2替换成两个jfloat。
• %typemap(jtype): 指定Java native方法的参数类型，对应两个float。
• %typemap(jstype): 指定Java上层可见的方法参数类型，同样是两个float。
• %typemap(in): 在JNI层将传入的两个jfloat值组装成C++的aVector2对象，$input1和$input2分别对应第一个和第二个JNI参数。
• %typemap(javain): 生成Java侧的包装方法，把上层传入的两个float参数传递给native方法。

编译测试步骤 #

1. 你的C++头文件example.h内容如下：

struct aVector2 {
    float x, y;
};

float sum(aVector2 v2) {
    return v2.x + v2.y;
}

2. 编写example.cpp实现函数：

#include "example.h"

float sum(aVector2 v2) {
    return v2.x + v2.y;
}

3. 用SWIG生成包装代码：

swig -java example.i

4. 编译C++代码生成动态库（以Linux为例）：

g++ -shared -fPIC example.cpp example_wrap.cxx -I$JAVA_HOME/include -I$JAVA_HOME/include/linux -o libexample.so

5. Java侧调用示例：

public class Test {
    static {
        System.loadLibrary("example");
    }

    public static void main(String[] args) {
        float x = 1.0f;
        float y = 2.0f;
        float result = example.sum(x, y);
        System.out.println("Sum result: " + result); // 输出3.0
    }
}

额外说明 #

如果需要同时保留「接收aVector2对象」和「接收两个float参数」的两种调用方式，可以在接口文件中添加内联重载函数：

%inline %{
float sum(float x, float y) {
    aVector2 v;
    v.x = x;
    v.y = y;
    return sum(v);
}
%}

这样SWIG会自动生成两个sum方法，满足不同场景的调用需求。

内容的提问来源于stack exchange，提问作者Sơn Đàm