JNA 中正确映射 C 语言指针参数（如 double）的实践指南-java教程-PHP中文网

JNA 中正确映射 C 语言指针参数（如 double）的实践指南

本文详解如何在 Java 中使用 JNA 正确映射 C 函数中带星号（）的 double 指针参数（如 double*），重点说明 DoubleByReference 与 double[] 的适用场景、内存管理差异及常见错误规避方法。

本文详解如何在 java 中使用 jna 正确映射 c 函数中带星号（*）的 double 指针参数（如 `double*`），重点说明 `doublebyreference` 与 `double[]` 的适用场景、内存管理差异及常见错误规避方法。

在使用 JNA 调用 Linux 下的 .so 动态库时，C 函数签名中的指针（如 double *pip）并非简单等价于 Java 的 double 或 double[]，而需根据其实际语义选择恰当的 JNA 类型。以您提供的函数为例：

void updateTarget(
    int idcar,
    double *carPosition,
    double *carVelocity,
    double isABT,
    double *busPosition,
    double *busVelocity,
    double *pip,
    double *tgo
);

该函数接收多个 double* 参数，其中 pip 和 tgo 明确为指针（即 double *pip, double *tgo），意味着它们指向单个可被修改的 double 值（而非数组）。因此，Java 端必须使用 DoubleByReference 进行映射，而非原始 double 类型：

✅ 正确映射（推荐用于单值输出参数）：

public interface MyLibrary extends Library {
    MyLibrary INSTANCE = Native.load("mylib", MyLibrary.class);

    void updateTarget(
        int idcar,
        double[] carPosition,     // 若 carPosition 是长度为 N 的数组 → 用 double[]
        double[] carVelocity,
        double isABT,
        double[] busPosition,
        double[] busVelocity,
        DoubleByReference pip,    // ✅ 单个 double 输出：自动分配 8 字节并提供 get()/setValue()
        DoubleByReference tgo     // ✅ 同上
    );
}

调用示例：

DoubleByReference pipRef = new DoubleByReference(0.0);
DoubleByReference tgoRef = new DoubleByReference(0.0);

// 初始化输入数组（假设长度为 3）
double[] carPos = {1.0, 2.0, 3.0};
double[] busVel = {0.5, -0.2, 0.0};

MyLibrary.INSTANCE.updateTarget(
    123,
    carPos, carVel, 1.0,
    new double[3], busVel,  // 输出数组需预先分配足够空间
    pipRef, tgoRef
);

System.out.println("pip = " + pipRef.getValue()); // 获取被 native 修改后的值
System.out.println("tgo = " + tgoRef.getValue());

⚠️ 关键注意事项：

DoubleByReference 适用于单值指针：当 C 函数通过 double *x 仅读写一个 double（如 *pip = 3.14;），这是最安全、最清晰的选择；JNA 自动管理底层内存（8 字节 malloc/free）。
double[] 仅适用于明确的数组场景：若文档说明 pip 实际指向长度为 N 的数组（如 pip[0], pip[1] 均被写入），则需传入 double[N] 并确保容量充足；否则越界写入将导致 JVM 崩溃或未定义行为。
不可混用原始类型：将 double *pip 错误映射为 double pip 会导致 JNA 传递栈上 double 值的地址（非堆内存），native 代码写入将破坏栈，引发 SIGSEGV。
输入/输出语义需与 C 端一致：carPosition 等若为只读输入，double[] 可行；若 native 会修改其内容且长度固定，仍建议用 double[]；但若长度动态或需严格控制内存布局，应考虑 DoubleBuffer 或自定义 Structure。