Android学习笔记--JNI的使用方法
1、JNI是什么
JNI是Java Native Interface的缩写，它提供若干的API实现Java与其他语言之间的通信。而Android Framework由基于Java语言的的Java层与基于C/C++语言的C/C++层组成，每个层中的功能模块都是以有相应的语言编写，并且两层中的大部分模块有着千丝万缕的联系。而在两层之间充当连接桥梁这一角色的就是JNI，它允许Java代码和C/C++编写的应用程序与库之间进行交互；通常在以下几种情况下使用JNI
1、注重处理速度，C/C++的处理速度要优于Java语言
2、硬件控制，硬件驱动程序通常使用C语言编写，而要是Java层能够控制硬件，需要用到JNI
3、C/C++代码的复用，一些好的C/C++模块可以被多处复用
2、在Java中调用C库函数
下面以一个例子来说明在Java代码中调用C库函数的流程
1、编写Java代码
class HelloJNI {
/*声明本地方法，该函数在C库中实现*/
native void printHello();
native void printString(String str);
/*在静态块中加载C库，可以保证在main方法前加载完成*/
static { System.loadLibrary("./hellojni"); }
public static void main(String args[])
{
HelloJNI myJNI = new HelloJNI();
/*调用C库中实现的函数*/
myJNI.printHello();
myJNI.printString("Hello world from printstring func");
}
}
在上述代码中使用native关键字声明本地方法，告诉Java编译器，此函数由其他语言编写；在静态块中加载hellojni库，该库由C语言实现，
如果是在Linux系统下则会加载libhellojni.so，如果在Windows系统下则会加载hellojni.dll;(本文以Linux系统为测试环境)
2、编译Java代码
javac HelloJNI.java
编译Java代码很简单，只要配置好JDK就可以完成编译，需要注意的是此时编译通过，但如果运行的话，由于没有实现本地函数，所以会抛出找不到函数的异常
3、生成C头文件
当Java调用本地函数printHello或者printString时并非直接映射到C语言的printHello或者printString函数，而是有一套自己的映射方法，使用如下命令即可生成C函数的头文件
javap HelloJni
执行完成后生成HelloJni.h如下
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class HelloJNI */
#ifndef _Included_HelloJNI
#define _Included_HelloJNI
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: HelloJNI
* Method: printHello
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_HelloJNI_printHello(JNIEnv *, jobject);
/*
* Class: HelloJNI
* Method: printString
* Signature: (Ljava/lang/String;)V
*/
JNIEXPORT void JNICALL Java_HelloJNI_printString(JNIEnv *, jobject, jstring);
#ifdef __cplusplus
}
#endif
#endif
可以看到生成的函数原型并非与Java代码调用的函数一致，函数有JNIEXPORT和JNICALL两个关键字声明，这两个关键词是必须的，有了他们JNI才能正常调用函数；而通过观察函数名称，我们可以知道其命名方式是"Java_类名_本地方法名"; 再看参数，可知JNIEnv*和jobject是本地函数的共同参数，第一个参数是JNI接口的直接，用来调用JNI提供的基本函数集；第二个参数中保存着调用本地方法的对象的一个引用，上例中的jobject中保存的对象myJNI的引用，其他的参数根据Java代码的本地方法的调用生成的
4、编写C/C++代码
把上一步骤生成的HelloJni.h头文件include进来，实现其声明的函数即可，编写hellojni.c如下
#include "HelloJNI.h"
#include <stdio.h>
/*
* Class: HelloJNI
* Method: printHello
* Signature: ()V
*/
JNIEXPORT void JNICALL Java_HelloJNI_printHello(JNIEnv *env, jobject obj)
{
printf("Hello World!\n");
return;
}
/*
* Class: HelloJNI
* Method: printString
* Signature: (Ljava/lang/String;)V
*/
JNIEXPORT void JNICALL Java_HelloJNI_printString(JNIEnv *env, jobject obj, jstring string)
{
/*JNI提供的基本函数集，将jstring转化成char *类型*/
const char *str = (*env)->GetStringUTFChars(env, string, 0);
printf("%s! \n" ,str);
return ;
}
5、生成C动态链接库
gcc -fPIC -shared -o libhellojni.so hellojni.c -I$JAVA_HOME/include
其中JAVA_HOME已经配置到环境变量中，表示JDK安装的目录，需要指定其中的include目录使用jni.h头文件
6、运行Java程序
此时执行java HelloJni会提供找不到hellojni库，这是由于在加载C库的时候在默认目录中没有找到libhellojni.so库，只需将该库复制到/usr/lib/下再次执行
xlzh@cmos:~/code/jni/simpleJNI$ java HelloJNI
Hello World!
Hello world from printstring func!
3、调用JNI函数
上图来自<Android框架揭秘>
由上图可知此示例程序有JniFuncMain类、JniTest类和libjnifunc.so(linux系统)组成，此示例有Java和C代码混合而成。
JniFuncMain类：
public class JniFuncMain
{
private static int staticIntField = 300;
/*加载libjnifunc.so库*/
static { System.loadLibrary("jnifunc"); }
/*使用static关键字声明本地方法，再C库中实现*/
public static native JniTest createJniObject();
public static void main(String[] args) {
System.out.println("[Java] createJniObject() call native method");
/*调用C库的createJniObject，得到JniTest对象，注意不是用new*/
JniTest jniObj = createJniObject();
/*利用JniTest对象调用JniTest中的方法*/
jniObj.callTest();
}
}
此例中与上例不同的是本地方法返回了一个JniTest类的对象的引用，这样就可以在JniFuncMain类中调用JniTest类的方法。
JniTest类
class JniTest {
private int intField;
public JniTest(int num)
{
intField = num;
System.out.println("[Java] call JniTest: intFiled" + intField);
}
public int callByNative(int num)
{
System.out.println("[Java] JniTest 对象的 callByNative(" + num + ")调用");
return num;
}
public void callTest()
{
System.out.println("[Java] JniTest对象的callTest() 方法调用: intField = " + intField);
}
}
JniTest类提供两个方法供JniFuncMain类和C库函数调用
JniFuncMain.h
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class JniFuncMain */
#ifndef _Included_JniFuncMain
#define _Included_JniFuncMain
#ifdef __cplusplus
extern "C" {
#endif
/*
* Class: JniFuncMain
* Method: createJniObject
* Signature: ()LJniTest;
*/
JNIEXPORT jobject JNICALL Java_JniFuncMain_createJniObject
(JNIEnv *, jclass);
#ifdef __cplusplus
}
#endif
#endif
使用javah JniFuncMain生成头文件，需要注意的是第二个参数是jclass，而不是jobject，这是由于该本地方法在JniFuncMain类中声明的是static方法，所以第二个参数表示的该类的应用，而不需要对象的引用
jnifunc.cpp
#include "JniFuncMain.h"
JNIEXPORT jobject JNICALL Java_JniFuncMain_createJniObject(JNIEnv *env, jclass clazz)
{
jclass targetClass;
jmethodID mid;
jobject newObject;
jstring hellostr;
jfieldID fid;
jint staticIntField;
jint result;
/*获取JniFuncMain类的staticField变量值*/
fid = env->GetStaticFieldID(clazz, "staticIntField", "I");
staticIntField = env->GetStaticIntField(clazz, fid);
printf("[CPP] 获取 JniFuncMain类的staticIntField 值\n");
printf(" JniFuncMain.staticIntField = %d\n", staticIntField);
/*查找生成对象的类*/
targetClass = env->FindClass("JniTest");
/*查找构造方法*/
mid = env->GetMethodID(targetClass, "<init>", "(I)V");
/*生成JniTest对象*/
printf("[CPP] JniTest 对象生成 \n");
newObject = env->NewObject(targetClass, mid, 100);
/*调用对象的方法*/
mid = env->GetMethodID(targetClass, "callByNative", "(I)I");
result = env->CallIntMethod(newObject, mid, 200);
/*设置JniObject对象的intField值*/
fid = env->GetFieldID(targetClass, "intField", "I");
printf("[CPP] 设置JniTest对象的intField值为200\n");
env->SetIntField(newObject, fid, result);
/*返回对象引用*/
return newObject;
}
如果想在C代码中访问Java中的成员变量，就需要获取相应成员变量的ID值，成员变量的ID值保存在jfieldID类型的变量中；获取成员变量ID的JNI本地方法有两个，分别是
/* 获取Java中的静态成员变量ID
* env : JNI接口指针
* clazz : 包含成员变量的类的jclass
* name : 成员变量名称
* signature: 成员变量签名
*/
jfield GetStaticFieldID(JNIEnv *env, jclass clazz, const char *name, const char *signature);
/*获取Java中的普通成员变量ID*/
jfield GetFieldID(JNIEnv *env, jclass clazz, const char *name, const char *signature);
上述示例中要访问Java类中的静态成员变量，所以需要使用GetStaticFieldID方法，其他参数很简单，直接使用即可，而对于变量的签名，则需要借助Java反编译器javap命令，如下所示
xlzh@cmos:~/code/jni/middleJNI$ javap -s -p JniFuncMain
Compiled from "JniFuncMain.java"
public class JniFuncMain {
private static int staticIntField;
Signature: I
public JniFuncMain();
Signature: ()V
public static native JniTest createJniObject();
Signature: ()LJniTest;
public static void main(java.lang.String[]);
Signature: ([Ljava/lang/String;)V
static {};
Signature: ()V
}
可以看到，staticIntField的签名是I，将I传入第四个参数即可，其他函数中用到签名的时候可用同样的方法获取
OK，我们得到了成员变量的ID，那么如何通过成员变量的ID来获取或者设置成员变量的值呢？就需要用到以下几个JNI函数
/*
* 获取Java类中静态成员变量的值
* <jnitype> jobject,jboolean,jbyte,jchar, jshort, jint, jlong, jfloat, jdouble
* <type> Object ,Boolean ,Byte,Char , Short , Int, Long , Float , Double
* env: JNI接口指针
* jcalss: 包含成员变量的类
* jfieldID: 成员变量ID
*/
<jnitype> GetStatic<type>Field(JNIEnv *env, jcalss jclazz, jfieldID fieldID)
/*
* 获取Java类的对象中普通成员变量的值
*/
<jnitype> Get<type>Field(JNIEnv *env, jobject obj, jfieldID fieldID)
/*
* 设置Java类中静态成员变量的值
*/
<jnitype> SetStatic<type>Field(JNIEnv *env, jcalss clazz, jfieldID fieldID, <type> value)
/*
* 设置Java类的对象中普通成员变量的值
*/
<jnitype> Set<type>Field(JNIEnv *env, jobject obj, jfieldID fieldID, <type> value)
与成员变量类似， 获取和调用类中方法的JNI函数原型如下
/*获取Java类静态方法的ID*/
jmethod GetStaticMethodID(JNIEnv *env, jclass clazz, const char *name, const char *signature)
/*获取Java类的对象中普通方法的ID*/
jmethod GetMethodID(JNIEnv *env, jclass clazz, const char *name, const char *signature)
/*调用Java类中的静态方法*/
<jnitype> CallStatic<type>Method(JNIEnv *env, jclass clazz, jmethod methodID, ...)
/*调用Java类的对象中的普通方法*/
<jnitype> Call<type>Method(JNIEnv *env, jobject obj, jmethod methodID, ...)
如何获取Java类的对象呢？以示例中获取JniTest类的对象代码例，分为三步
1、获取JniTest的类
2、获取JniTest类的构造方法ID
3、通过构造方法的ID调用和JniTest类使用NeoObject方法生成对象
对比上例中获取JniTest的对象流程，可以很清楚的进行对照
4、在C代码中运行Java类
Java类编译的字节码需要在Java虚拟机上运行，那么在C/C++中运行Java类自然也需要加载Java虚拟机；JNI为我们提供了一套Invocation API，它允许本地代码在自身内存区域内加载Java虚拟机，同样我们以实例的方式进行讲解
InvocationApiTest.java
public class InvocationApiTest {
public static void main(String[] args) {
System.out.println(args[]0);
}
}
invocationApi.c
#include <jni.h>
int main(void)
{
JNIEnv *env;
JavaVM *vm;
JavaVMInitArgs vm_args;
JavaVMOption options[1];
jint res;
jclass cls;
jmethodID mid;
jstring jstr;
jclass stringClass;
jobjectArray args;
/*加载虚拟机选项*/
options[0].optionString = "-Djava.class.path=.";
vm_args.version = JNI_VERSION_1_6;
vm_args.options = options;
vm_args.nOptions = 1;
vm_args.ignoreUnrecognized = JNI_TRUE;
/*生成虚拟机*/
res = JNI_CreateJavaVM(&vm, (void**)&env, &vm_args);
/*查找并加载类*/
cls = (*env)->FindClass(env, "InvocationApiTest");
/*获取main()方法的ID*/
mid = (*env)->GetStaticMethodID(env, cls, "main", "([Ljava/lang/String;)V");
/*生成字符串对象*/
jstr = (*env)->NewStringUTF(env, "Hello Invocation API!!");
stringClass = (*env)->FindClass(env, "java/lang/String");
args = (*env)->NewObjectArray(env, 1, stringClass, jstr);
/*调用main()方法*/
(*env)->CallStaticVoidMethod(env, cls, mid, args);
/*销毁虚拟机*/
(*vm)->DestroyJavaVM(vm);
}
编译允许结果如下
xlzh@cmos:~/code/jni/superJNI$ javac InvocationApiTest.java
xlzh@cmos:~/code/jni/superJNI$ sudo echo "/usr/lib/jvm/java-1.7.0-openjdk-amd64/jre/lib/amd64/jamvm" >> /etc/ld.so.conf
xlzh@cmos:~/code/jni/superJNI$ sudo ldconfig
xlzh@cmos:~/code/jni/superJNI$ gcc -o a.out invocationApi.c -I$JAVA_HOME/include -L$JAVA_HOME/jre/lib/amd64/jamvm/ -ljvm
xlzh@cmos:~/code/jni/superJNI$ ./a.out
Hello Invocation API!!
xlzh@cmos:~/code/jni/superJNI$
