美文网首页
JNA 编程要点整理

JNA 编程要点整理

作者: 搞技术的薛彬 | 来源:发表于2017-03-31 20:37 被阅读0次

    类型对应

    • 简单类型
      • 参考官方文档中的对应表
      • 简单类型的数组做参数时也同样用对应类型的数组即可,做返回值时需要用 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]

    参考资料

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

    相关文章

      网友评论

          本文标题:JNA 编程要点整理

          本文链接:https://www.haomeiwen.com/subject/qfavottx.html