初识 JNI

初识 JNI

JNI, Java Native Interface(Java本地接口).

概述

JNI 是用于和本地 C 代码进行交互操作的API。实际上可以通过许多语言编写,如C++、C#,本质上 Java 调用的是 dll/so 库 。此处说是和本地 C 代码互操作是因为 JNI API的支持。JNI API针对的是 C 语言,而不是Java。

JNI 的出现的原因有一些是为了弥补一些无法通过 Java 平台实现的功能。比如 Windows 的注册表,这是 Windows 独有的东西,Java 并没有现成可以操作它的 API。

也有一些原因是非 Java 语言编写的代码已经经过了大量的测试,无需重新用 Java 实现一套。

当然,最初也有 JVM 运行的比较慢的原因,但随着 JVM 的不断发展,Java编写的代码有时已经不逊于一些 C/C++ 的代码了。

JNI 有着上述的一些好处,随着而来的是它会带来相应语言的缺点,
比如会引入 C 语言的无效指针造成的内存覆写问题等等。

所以说 JNI 实际上使用范围相对较窄,Web 后端方面用的比较少,安卓端用的相对更多一点。

示例 Hello World

以下为一个简单的示例

Java 部分

首先在在 Java 中声明 dll/so 库中定义的函数。
声明通过 native 关键字标识,提醒编译器该方法在外部定义。

// 为了简单,此处没有package
public class HelloNative {
  public static native void greeting();
}

C 部分

然后在 C 中定义函数,函数名有如下要求:

  • Java_包名_类名_方法名 。(其中的.号都要改为 _下划线)
  • 如果类名中含有非 ASCII 码值,或说大于 \uoo7F 的 Unicode 字符,用 _0xxxx 来代替。
    xxxx 是该字符的Unicode值的4个十六进制数序列)
  • 方法重载需要在名称后加两个下划线,后再加上已编码的类型。

为了避免在函数定义时候出错,Java 提供了 javah 工具完成函数名的编写操作。
javah 是通过类文件来生成相应的文件的,所以源代码必须要先编译才可以。

javah HelloNative

通过如上命令,会生成一个 HelloNative.h 的文件,这个文件包含了 greeting() 方法的声明。
复制该文件,改为 .c 文件,去掉一些不需要的东西,然后包含 #include "HelloNative.h" 即可。
然后将方法声明改为方法实现,在方法实现中编写具体的代码。

JNIEXPORT void JNICALL Java_HelloNative_greeting (JNIEnv* env, jclass cl) {
  printf("Hello Native World!");
}

之后就是编译代码了,此处仅粘贴个人测试过的命令,为 Windows 上的 MinGW64 上的 gcc 。

gcc -I "jdk/include" -I "jdk/include/win32" -D __int64="long long" -shared -o HelloNative.dll HelloNative.c

关于 -D __int64="long long" 参数的说明:

Windows 上的 jni_md.h 含有声明 typedef __int64 jlong; ,它专用于 cl 的。如果使用 gcc 需要设置 -D __int64="long long"
或者也可以修改此文件,如:

#ifdef __GNUC__
  typedef long long jlong;
#else
  typedef __int64 jlong;
#endif

调用

创建 HelloNativeTest 类以供测试:

public class HelloNativeTest {
    static {
        // 此处不需要 dll/so 后缀,系统会自动根据系统不同换后缀
        System.loadLibrary("HelloNative");
    }

    public static void main(String[] args){
        HelloNative.greeting();
    }
}

记住这里打印的消息是通过 printf 打印的,不是 java 的代码打印的。

注:
一些本地代码的共享库必须先运行初始化代码,可以将初始化代码放置到JNI_OnLoad方法中,如果提供该方法,则虚拟机关
闭时会调用JNI_OnUnload方法,原型如下:

  jint JNI_OnLoad(JavaVM* vm, void* reserved);    //返回它所需的虚拟机的最低版本,如JNI_VERSION_1_2
  void JNI_OnUnload(JavaVM* vm, void* reserved);

你可能感兴趣的:(java,jni)