Java的JNI快速入门教程(推荐)
1. JNI简介
JNI是Java Native Interface的英文缩写,意为Java本地接口。
问题来源:由于Java编写底层的应用较难实现,在一些实时性要求非常高的部分Java较难胜任(实时性要求高的地方目前还未涉及,实时性这类话题有待考究)。
解决办法:Java使用JNI可以调用现有的本地库(C/C++开发任何和系统相关的程序和类库),极大地灵活Java的开发。
2. JNI快速学习教程
2.1 问题:
使用JNI写一段代码,实现string_Java_Test_helloworld(JNIEnv *env, jclass cls , jstring j_str)函数,实现在字符串j_str("world")前面加上hello,并返回。
2.2 解决问题过程:
I. 编写Test.java类:
public class Test{ // native interface public native String helloworld(String text); public static void main(String[] args){ // Load dynamic library System.loadLibrary("Test2"); Test ts = new Test(); String text = ts.helloworld("world"); System.out.println(text); } }
备注:
1、加载动态类库:System.loadLibrary("Test2");【Windows下加载的就是Test2.dll,Linux下加载的是Test2.so】
II. 编译Test.java文件
进入cmd输入命令 > javac Test.java
III. 生成Test.h文件
进入cmd输入命令 > javah Test
Test.h文件内容如下:
/* DO NOT EDIT THIS FILE - it is machine generated */ #include <jni.h> /* Header for class Test */ #ifndef _Included_Test #define _Included_Test #ifdef __cplusplus extern "C" { #endif /* * Class: Test * Method: helloworld * Signature: (Ljava/lang/String;)Ljava/lang/String; */ JNIEXPORT jstring JNICALL Java_Test_helloworld (JNIEnv *, jobject, jstring); #ifdef __cplusplus } #endif #endif
备注:
1、函数声明,固定格式:JNIEXPORT;返回类型:jstring;JNI调用:JNICALL;Java_完整类名_方法名:Java_Test_helloworld;
2、函数参数:调用jni.h封装好的函数指针:JNIEnv;Java类本身:jobject,Java文件传入参数:jstring。
IV. 编写C语言文件Test2.c实现Test类调用动态链接库的功能:
#include "Test.h" #include <string.h> JNIEXPORT jstring JNICALL Java_Test_helloworld (JNIEnv *env, jobject obj, jstring string){ const char* str = (*env)->GetStringUTFChars(env,string,0); char cap[128]; cap[0] = 'h'; cap[1] = 'e'; cap[2] = 'l'; cap[3] = 'l'; cap[4] = 'o'; strcat(cap,str); (*env)->ReleaseStringUTFChars(env,string,0); return (*env)->NewStringUTF(env,cap); }
备注:
1、由于Java本身使用了双字节字符,C语言本身都是单字节字符,所以需要使用(*env)->GetStringUTFChars()转换Java和C之间的字符串;
2、GetStringUTFChars()和NewStringUTF(),第一个是从UTF8转换为C的编码格式,第二个是根据C的字符串返回一个UTF8字符串;
3、ReleaseStringUTFChars()是用来释放对象的,在Java中有虚拟机进行垃圾回收,但是在C语言中这些对象必须手动回收,否则可能造成内存泄漏。
V. 编译和运行
编译:
进入cmd输入命令 > gcc -I "D:\Program Files\Java\jdk1.8.0_45\include" -I "D:\Program Files\Java\jdk1.8.0_45\include\win32" --share Test2.c -o Test2.dll
运行:
进入cmd输入命令 > java Test
运行结果如下:
helloworld
3. 总结:
第一步:编写带有native方法的Java类(Test.java),使用javac工具编译Java类(生成Test.class);
第二步:使用javah生成与native方法对应的头文件(Test.h);
第三步:使用C/C++实现相应的头文件(Test2.c),并编译为动态链接库(Test2.so)。
本文运行环境:Windows 64位操作系统,JDK 1.8版本,mingw64(GCC)。