Java JNI 使用笔记

最新推荐文章于 2024-04-20 12:00:16 发布
最新推荐文章于 2024-04-20 12:00:16 发布
阅读量220 收藏 1
点赞数
文章标签： java servlet 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Java_ttcd/article/details/126483145
版权

简介

JNI 的全称是 Java Native Interface，是一种 Java 的 Native 编程接口，支持 Java 与 C/C++ 直接相互调用，从 JDK 1.0 开始提供。

基本使用流程

通过一个简单的例子来介绍下 JNI 的使用方法，对整体 JNI 有个初步的整体概念。

1. native method

定义一个 Java 类，其中包含 native 方法，另外通过 loadLibrary 来加载动态库。

<pre class="prettyprint hljs java" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">package jni;

class JniDemo {
  static {
    // 这里是加载一个名叫 libjnidemo 的动态库，后缀会根据OS不同而不同
    System.loadLibrary("jnidemo");
  }

  public native void nativeMethod();
}

额外说明：

  1. 动态库需要在 java 启动参数的 -Djava.library.path= 中定义，否则会报动态库找不到的错误
  2. 对于苹果的 M1 电脑，需要额外注意动态库是属于那种架构（aarch64 和 x86_64），需要与使用的 jdk 保持一致

2. generate header

JDK 默认自动的工具可以生成头文件

<pre class="prettyprint hljs ruby" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;"># 1\. javac -h：java 编译为 class，并且生成头文件
${JAVA_HOME}/bin/javac -h . jni/JniDemo.java

# 2\. javah：需要在 classpath 下找到已经编译好的 class
${JAVA_HOME}/javah jni.JniDemo

生成的头文件示例如下:

<pre class="prettyprint hljs cpp" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">// filename: jni_JniDemo.h
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class jni_JniDemo */

#ifndef _Included_jni_JniDemo
#define _Included_jni_JniDemo
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     jni_JniDemo
 * Method:    nativeMethod
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_jni_JniDemo_nativeMethod
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

3. implementation

引入头文件，实现其对应的函数

<pre class="prettyprint hljs cpp" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">// filename: JniDemo.cc
#include "jni_JniDemo.h"

JNIEXPORT void JNICALL Java_jni_JniDemo_nativeMethod
  (JNIEnv *env, jobject obj) {
  printf("native method in jni\n");
}

4. compile

编译只需要依赖 jni.h 的头文件，还有一个与OS相关的头文件

这里编译的动态库的名字，与 Java 代码中的 System.loadLibrary 的动态库名字相关，额外多一个 lib 的前缀。

<pre class="prettyprint hljs ruby" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;"># for mac os
g++ -c -fPIC -I${JAVA_HOME}/include -I${JAVA_HOME}/include/darwin JniDemo.cc -o JniDemo.o
g++ -shared -fPIC -o libjnidemo.dylib JniDemo.o -lc

# for linux
g++ -c -fPIC -I${JAVA_HOME}/include -I${JAVA_HOME}/include/linux JniDemo.cc -o JniDemo.o
g++ -dynamiclib -o libjnidemo.so JniDemo.o -lc

5. run

执行的时候只需要指定 java.library.path，在这个路径下有 libjnidemo 动态库即可

<pre class="prettyprint hljs nginx" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;"># run
java -cp . -Djava.library.path=/path/to/libjnidemo jni.JniDemo

JNI Types

Primitive Types

Java 的 Primitive Types 与 JNI 中的 Native 多有对应的类型，都是以 j 开头。

这里在 Java 中定义 native 方法，其参数的类型都会被转换为对应的 native 类型。
Primitive Types and Native Equivalents

array 数组的基础类型是独立的类型，从这里就可以理解为什么说 Java 中的基础类型和基础类型的数组是两个类型，因为底层实现确实是两个。

比较特殊的是 String：有 jstring 的对应实现，但是其不属于 primitive type，属于 jobject，并且也没有单独的 array 实现。

jobject:

  • jclass (java.lang.Class objects)
  • jstring (java.lang.String objects)
  • jarray (arrays)
    • jobjectArray (object arrays)
    • jbooleanArray (boolean arrays)
    • jbyteArray (byte arrays)
    • jcharArray (char arrays)
    • jshortArray (short arrays)
    • jintArray (int arrays)
    • jlongArray (long arrays)
    • jfloatArray (float arrays)
    • jdoubleArray (double arrays)
  • jthrowable (java.lang.Throwable objects)

Java VM Type Signatures

Java 在底层实现来一套 Type Signatures，通过这套签名体系来表示 field 的类型、method 的签名、array 等。

在 JNI 获取 field 和 method 等处均需要使用 Type Signature。这里的 Type Signature 是 Java 单独定义的，需要根据下面的定义来使用。

Java VM Type Signatures 的表格如下：

这里简单举例说一下其使用方法，假设有一个 Java class 的定义如下：

<pre class="prettyprint hljs java" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">public class SimpleData {
  public boolean aBoolean;
  public String aString;
}

这个类在 jni 中读取其中的字段，就需要使用对应的 type signature，读取上述 class 的 field 方法如下：

<pre class="prettyprint hljs elixir" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">jclass kDummyDataClass = env->FindClass("LSimpleData;");

jfieldID data_aBoolean_ = env->GetFieldID(kDummyDataClass, "aBoolean", "Z");
jfieldID data_aString_ = env->GetFieldID(kDummyDataClass, "aString", "Ljava/lang/String;");

// 假设当前已经有 jobject dataObject，其对应的 java class 为 SimpleData
jboolean aBoolean = env->GetBooleanField(dataObject, data_aBoolean_);
// jstring 有单独的实现，但是其本质也是一个 jobject
jstring aString = (jstring) env->GetObjectField(dataObject, data_aString_);

CMake 编译

这里的编译方法可以参考 Arrow 的 c data api和 gandiva的编译。

下面是一个 CMake 的示例，通过 add_jar 来生成 jni 的头文件。

<pre class="prettyprint hljs cmake" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;"># Find java/jni
include(UseJava) # for add_jar

find_package(Java REQUIRED)
find_package(JNI REQUIRED)

# add_jar DESTINATION：生成的 java native method 的头文件位置
set(JNI_HEADERS_DIR "${CMAKE_CURRENT_BINARY_DIR}/generated")

# 设置 jni 的头文件
include_directories(${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_CURRENT_SOURCE_DIR}
                    ${JNI_INCLUDE_DIRS} ${JNI_HEADERS_DIR})

add_jar(${PROJECT_NAME}
        src/main/java/jni/JniException.java
        src/main/java/jni/JniWrapper.java
        GENERATE_NATIVE_HEADERS
        hello_jni-native
        DESTINATION
        ${JNI_HEADERS_DIR})

set(SOURCES src/main/cpp/jni_wrapper.cc)
add_library(hello_jni SHARED ${SOURCES})
target_link_libraries(hello_jni ${JAVA_JVM_LIBRARY})

C/C++ API 差异

API 的差异主要是因为 C++ 支持 class（struct 与 class 的差异仅仅是可见性），C 只能用 struct + function pointer 来模拟。

jni.h 中，对 JNIEnv 的定义如下：

<pre class="prettyprint hljs cpp" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">#ifdef __cplusplus
typedef JNIEnv_ JNIEnv;
#else
typedef const struct JNINativeInterface_ *JNIEnv;
#endif

虽然同为 JNIEnv，但是其内部的实现是不同的，查看对应类即可知道 C/C++ API 的差异，这里以 GetStringUTFChars 为例举例说明其 API 的差异：

<pre class="prettyprint hljs rust" style="padding: 0.5em; font-family: Menlo, Monaco, Consolas, &quot;Courier New&quot;, monospace; color: rgb(68, 68, 68); border-radius: 4px; display: block; margin: 0px 0px 1.5em; font-size: 14px; line-height: 1.5em; word-break: break-all; overflow-wrap: break-word; white-space: pre; background-color: rgb(246, 246, 246); border: none; overflow-x: auto;">// c api
const char *str = (*env)->GetStringUTFChars(env, jstr, 0);

// c++ api
const char *str = env->GetStringUTFChars(jstr, 0);

方法的名字都是一样的，C/C++ API 下的函数是一样的，仅使用方法不同。

Arrow JNI

JNI 动态库的编译都是使用 CMake 来进行编译，JniLoader 用于加载动态库，JniWrapper 作为 native method 的类。

下面以 Arrow Gandiva 为例，简单分析下其 JNI 实现：

  1. 数据传输的方式为 JVM 堆外内存（从 Netty 申请的），向 JNI 传递数据 input 和 output 的时候使用 buffer address + length 的方式
  2. JVM 堆外内存本质是需要在 Java 侧进行内存的管理，所以在 JNI 中如果需要进行内存扩容（project 场景下，output 的内存可能需要扩容），会在 C++ 中调用 Java 的 VectorExpander 来进行扩容，保证内存全在 Java 中进行申请管理
Java_ttcd
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
java与c++交互（JNI学习笔记）
06-29
1.C++与java交互基本介绍 2.C++获取java属性值、设置java属性值 3.C++创建java对象 4.C++中数据类型间的转换
Java基础知识笔记.rar
03-11
18. **JNI与JNI本地方法**：了解Java Native Interface，允许Java代码调用C/C++原生代码，以提升性能或利用特定平台功能。 19. **垃圾回收**：理解Java的自动内存管理，包括垃圾收集机制和内存泄漏的概念。 20. **...
JNI 使用
DengCaixiang2021的博客
09-01 521
JNI（Java Native Interface）是Java语言提供的一种机制，用于在Java应用程序中调用本地代码（Native Code）或者让本地代码调用Java代码。它为Java和其他编程语言（如C、C++）之间的交互提供了一种标准的接口。
java jni使用
sumengnan的博客
05-28 1308
1、创建java maven项目 创建一个JniDemo类 package com.sumengnan; public class JniDemo { static { //第一种方式：直接写全路径名+文件名 System.load("/Users/sumengnan/CLionProjects/jniSharedLib/libjniSharedLib.dylib"); //第二种方式:只写去掉前缀和后缀的文件名去掉libxxx.dy.
Java JNI调用本地方法1（调用C++方法）
最新发布
weisian的博客
04-20 609
1、JNI（Java Native interface）:sun公司提供的JNI是Java平台的一个功能强大的接口，实现java和操作系统本地代码的相互调用功能，系统本地代码通常是由其他语言编写的，如C++。说明：TestJni指的是TestJni.class文件，不是TestJni.java文件，一定要先编译。2、使用jdk的javah工具，生成包含native方法类的C/C++头文件（.h）。3、按照生成的C/C++头文件(.h)，来写C/C++源文件(.cpp)。如果还有路径层级，使用.连接。
JNI中调用Java函数
Liuqz2009的专栏
04-08 5388
JNI调用Java函数，主要是在JNI中使用反射调用Java中的函数。 1、Java代码： package com.my.hawk.jni2; import androidx.appcompat.app.AppCompatActivity; import android.os.Bundle; import android.util.Log; import android.view.View; import android.widget.Button; import android.widget.T
本地java项目调用jni
程序课代表的博客
12-22 2374
一、环境搭建 1.jdk环境搭建(这个就不说了) 2.安装MinGW,官网可能下载较慢,这里我提供下载地址 提取码:nbc3 配置下MinGw的环境变量
Android之 JNI详解
qq_29848853的博客
03-07 4875
Android JNI详解
java笔记_Java笔记_
10-03
20. **JNI（Java Native Interface）**：允许Java代码调用本地（非Java）代码，实现Java与其他语言的互操作。 这些知识点构成了Java基础学习的主要内容，通过阅读这份"java笔记"，初学者可以逐步建立起对Java语言的...
黑马程序员JNI学习笔记
05-23
针对所有初学JNI的人员的一个最全面的笔记,对于有过基础的朋友来说又是一个更好的助手. 省去了你自己去总结的时间,有更多的时间去敲代码. ------------黑马程序员学员-------------------
Java基础笔记
05-09
10. **JNI（Java Native Interface）**：Java本地接口允许Java代码和其他语言写的代码进行交互，通常用于提升性能或调用系统级别的库。 此外，笔记可能还会涉及Java SE（标准版）和Java EE（企业版）的区别，以及...
java调用jni，及C/C++调用java全流程，简洁易懂！
大炮哥的博客
09-15 1188
'jni.h' file not found Undefined symbols for architecture x86_64: "_main", referenced from: implicit entry/start for main executable ld: symbol(s) not found for architecture x86_64 clang: error: linker command failed with exit code 1 (use -v to see
JNI基础知识总结
金戈鐡馬
09-27 1626
JNI（Java Native Interface）是Java提供的一种编程框架，用于实现Java代码与本地（Native）代码（如C、C++等）之间的交互。JNI允许Java应用程序调用本地代码，并且本地代码可以调用Java代码，实现更高性能的操作或访问底层资源。
使用C++创建jvm虚拟机
wjc133的专栏
06-01 3073
如果我们愿意同样也可以在C++中调用Java方法。
java——JDK安装后Path和JAVA_HOME环境变量
weixin_46362658的博客
01-18 3385
Path环境变量 Path环境变量用于记住程序路径，方便在命令行窗口的任意目录启动程序 path环境变量位置在：我的电脑->属性->高级系统设置->高级->环境变量。 目前较新的JDK安装时会自动配置javac和java程序的路径到Path环境变量中去，因此，javac、java可以直接使用 注意：以前的老版本的JDK在安装的是没有自动配置Path环境变量的，此时必需要自己配置Path环境变量。 配置Path ① 找到安装JDK下的bin目录，复制路径 ②到环境变量中，点击Pa
Java中一个逐渐被遗忘的强大功能，强到你难以置信！！
2401_84003941的博客
04-01 629
上述知识点，囊括了目前互联网企业的主流应用技术以及能让你成为“香饽饽”的高级架构知识，每个笔记里面几乎都带有实战内容。很多人担心学了容易忘，这里教你一个方法，那就是重复学习。打个比方，假如你正在学习 spring 注解，突然发现了一个注解@Aspect，不知道干什么用的，你可能会去查看源码或者通过博客学习，花了半小时终于弄懂了，下次又看到@Aspect 了，你有点郁闷了，上次好像在哪哪哪学习，你快速打开网页花了五分钟又学会了。从半小时和五分钟的对比中可以发现多学一次就离真正掌握知识又近了一步。
jni java_JNI 常见用法
weixin_42127020的博客
02-12 339
一、Java 代码 和JNI代码通信Java代码通过JNI接口 调用 C/C++方法1、首先我们需要在Java代码中声明Natvie方法原型public native void helloJNI(String msg);2、其次我们需要在C/C++代码里声明JNI方法的原型如：extern "C"JNIEXPORT void JNICALLJava_com_kgdwbb_jnistudy_Main...
JNI和javah使用详解
xianhaiwolong的专栏
10-10 774
 jnijavaandroiddlleclipse语言 目录(?)[+] 一使用Eclipse创建Java工程二使用MS VC生成dll动态链接库三运行Java工程总结     Java Nativie Interface(JNI,中文名称Java本地接口)标准时Java平台的一部分，它允许Java代码和其他语言写得代码进行交互。JNI是本地编程接口，它
java 使用 JNI 调QT方法
07-24
在Java中使用JNI（Java Native Interface）调用Qt方法，您需要进行以下步骤： 1. 编写Qt代码：首先，您需要编写您想要在Qt中调用的功能代码。确保将该功能封装在一个类中，并在该类的头文件中声明该函数。 2. 生成...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值