【NDK开发】JNI简介

1、什么是JNI?

JNI，即Java Native Interface，Java本地编程接口，能够使得运行在虚拟机上的JAVA代码调用C/C++或者汇编语言，同时也支持被调用。当然，我们用的比较多的是JAVA调用C/C++。
参考：https://en.wikipedia.org/wiki/Java_Native_Interface

2、JNI基本框架

在JNI框架中，本地函数通常由C、C++实现，当JVM调用函数时，它将会传递JNIEnv指针、jobject指针及其他声明的相关参数。JNI函数可能是以下的这种形式:

JNIEXPORT void JNICALL Java_ClassName_MethodName(JNIEnv *env, jobject obj)
{
    /*Implement Native Method Here*/
}

其中，
1）JNIEnv *env指针为调用JVM相关接口提供指针，包括所有需要与JVM交互的与JAVA对象工作的函数，例如JNI函数将本地数组与JAVA数组互相转换，将本地字符串与JAVA字符串互相转换，实例化对象，抛出异常等等。
基本上，JAVA代码能够做的事情都可以用JNIEnv指针调用相应接口。

2）obj参数是调用该本地接口的JAVA对象的引用。

具体可参考如下实例。该函数对应于Java层的com.example包的testActivity类的Test函数。

//C++ code
extern "C"
JNIEXPORT void JNICALL Java_com_example_testActivity_Test(JNIEnv *env, jobject obj, jstring javaString)
{
    //Get the native string from javaString
    const char *nativeString = env->GetStringUTFChars(javaString, 0);

    //Do something with the nativeString

    //DON'T FORGET THIS LINE!!!
    env->ReleaseStringUTFChars(javaString, nativeString);
}

C代码中，env的调用方式与C++不同。

/*C code*/
JNIEXPORT void JNICALL Java_ClassName_MethodName
  (JNIEnv *env, jobject obj, jstring javaString)
{
    /*Get the native string from javaString*/
    const char *nativeString = (*env)->GetStringUTFChars(env, javaString, 0);

    /*Do something with the nativeString*/

    /*DON'T FORGET THIS LINE!!!*/
    (*env)->ReleaseStringUTFChars(env, javaString, nativeString);
}

3、数据类型

基本上，基本数据类型几乎可以互换，但如果是复合类型如对象、数组及字符串，本地代码必须要显式的调用接口进行转换。

下面为本地数据类型及java数据类型的对应关系

Native Type	Java Language Type	Description
unsigned char	jboolean	unsigned 8 bits
signed char	jbyte	signed 8 bits
unsigned short	jchar	unsigned 16 bits
short	jshort	signed 16 bits
long	jint	signed 32 bits
long long	jlong	signed 64 bits
float	jfloat	32 bits
double	jdouble	64 bits

需要注意的是：
unsigned char 对应于jboolean；
unsigned short对应于jchar 。

对于数组，则需要调用：
GetByteArrayElements 来获取指针及ReleaseByteArrayElements释放指针。
这两个函数必须配套使用，否则会出现内存溢出问题。