类型对应
- 简单类型
- 参考官方文档中的对应表
- 简单类型的数组做参数时也同样用对应类型的数组即可,做返回值时需要用 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]
参考资料
上面的整理知识算是些常见情况和要点的汇总,细节可以再参考官方文档,其实还是比较详细的:官方文档