JNA 编程要点整理

类型对应

• 简单类型
  • 参考官方文档中的对应表
  • 简单类型的数组做参数时也同样用对应类型的数组即可，做返回值时需要用 Memory 或 Buffer 类来代表，以便处理内存
  • c++中的多维数组需要按总长度对应成 java 中的一维数组
• 字符串
  • java 中的字符串一般映射到C++的 char*，JNA 会自动处理
  • 需要注意Unicode(带中文的)字符串自动转换成 char* 时会使用平台默认编码
  • 另外，对于C++中的wchar_t类型，应该用专用的 WString 类做映射
• 指针类型
  • JNA 提供了 Pointer 类和一系列子类，它有的write, read, getXXX, setXXX 等方法，用来操作指向的那片内存。所以要注意比如 getByteArray()这种操作是没有内存 copy的，只是返回一个引用。
  • 简单类型如 int 的指针可以直接使用 ByReference 类的子类代表
• 结构体
  • 需要自己定义一个提供了一个继承自 Structures 的java 类，用来对应struct。当参数是 struct数组时，在 java 中也直接用对应类的数组。
  • 用作参数或返回值时，这个类的实例相当于一个C++ struct 的指针，如果这时方法的参数或返回值不是指针，而是传值调用，则对应在 java 中使用 MyStruct.ByValue。
  • 用作另一个 struct 的字段时，
  • 结构体这段比较复杂，不清楚的看官方文档

内存处理

• 一般指针类型的参数，当不需要开辟内存，或者只是接收从 C++ 程序开辟的内存（如返回值或输出参数）时 应该用 Pointer 类型或它的子类型。
• 当需要在 java 中开辟一块内存区域传给 C++ 程序时，应该使用Pointer 的子类 Memory。JVM 在GC时会自动释放Memory中开辟的内存区域。
• Pointer 和子类的 write 和 read 方法使用时注意第一个参数是偏移量 单位是字节，最后一个参数长度是按 java 中的数组长度。比如第一次写入一个长度为2的整形数组，调用时最后一个参数应该为2。因为每一个整形数占4字节，第二次继续写入的时候，第一个偏移量参数应该在原来的基础上加2*4=8。
• 当C++代码中开辟了内存空间，并作为参数返回时，使用后用如下方式释放：
  Native.free(Pointer.nativeValue(yourPointer));

编译运行

• C++代码中一定要加上 extern "C"，保证编译后的名称和源代码中一样，否则会报找不到标识符的错误。
• 动态链接库一般编译成 lib[名称].[扩展名] 的形式
• 名称是你自己取的名字
• 扩展名根据平台有所不同，linux是 so，mac 是 dylib，windows 是 dll
• 编译命令
• Linux/Mac下 g++ -dynamiclib -o 目标文件名 *.cpp
• java 程序运行之前要设置动态链接库所在路径的环境变量 export LD_LIBRARY_PATH=[yourPath]

参考资料

上面的整理知识算是些常见情况和要点的汇总，细节可以再参考官方文档，其实还是比较详细的：官方文档