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

JNI工作原理

在JNI中，本地函数是通过一个独立的.c或.cpp文件来实现的(C++为JNI提供的界面会更简洁一些)。当JVM调用该函数时，它传递了一个JNIEnv指针、一个jobject指针和通过Java方法定义的Java参数，JNI函数的形式如下：

JNIEXPORT void JNICALL Java_ClassName_MethodName

  (JNIEnv *env, jobjectobj)

{

    //Method native implemenation

}

env指针是一个包含了JVM接口的结构，它包含了与JVM进行交互以及与Java对象协同工作所必需的函数，示例中的JNI函数可以在本地数组和Java数组类型之间、本地字符串和Java字符串类型之间进行转换，其功能还包括对象的实例化、抛出异常等。基本上您可以使用JNIEnv来实现所有Java能做到的事情，虽然要简单很多。

更加正式的解释是这样的，本地代码通过调用JNI的函数来访问JVM，这是通过一个界面指针实现的（界面指针实际上是指向指针的指针），该指针指向一个指针数组，数组中的每个指针都指向了一个界面函数，而每个界面函数都是在数组中预先定义过的。

本地方法将JNI界面指针当作一个参数，如果在同一个Java线程中，出现对该本地方法的多重调用，JVM则保证传递相同的界面指针到本地方法。不过，一个本地方法可以被不同的Java线程调用，因而也可能会收到不同的JNI界面指针。
 
本地方法是通过System.loadLibrary方法加载的，在以下的例子中，类的初始化方法加载了一个指定平台的本地类库，该类库定义了本地方法：

packagepkg;  

class Cls { 

     native double f(inti, String s); 

     static { 

         System.loadLibrary(pkg_Cls"); 

     } 

}

system.loadLibrary方法的参数是一个类库的名称，它可以由程序员任意选取，系统则遵循一个标准的本地化平台的方式来转换类库的名称到一个本地类库的名称。例如，在Solaris操作系统中会将pkg_Cls转换为libpkg_Cls.so，而Win32系统则会将同样的pkg_Cls转换为pkg_Cls.dll。

　　动态指针会根据它们的名字来进行解析，一个本地方法的名称是按照组件进行连接的，它包含了：前缀“Java_”、一个分离的合法的类名称和一个分离的方法名称。

注意：微软的JVM有相同的机制从Java调用本地Windows代码，该机制被称为原始本地接口(Raw Native Interface (RNI))。

                 数据类型映射
 

基本类型，比如整型、字符等等，是在Java和本地代码间进行拷贝的，而其他的自定义Java对象则是通过引用来传递的。

 Java类型和本地类型对应
在如下情况下，需要在本地方法中应用java对象的引用，就会用到类型之间的转换：
1）    java方法里面将参数传入本地方法；
2）    在本地方法里面创建java对象；
3）    在本地方法里面return结果给java程序。
分为如下两种情况：
    Java原始类型
像booleans、integers、floats等从Java程序中传到本地方法中的原始类型可以直接使用，下面是java中的原始类型和本地方法中的类型的对应：
Java类型    本地类型    字节(bit)
boolean    jboolean    8, unsigned
byte    jbyte    8
char    jchar    16, unsigned
short    jshort    16
int    jint    32
long    jlong    64
float    jfloat    32
double    jdouble    64
void    void    n/a
也就是说如果我在方法中传进去了一个boolean的参数的话，那么我在本地方法中就有jboolean类型与之对应。同理，如果在本地方法中return一个jint的话，那么在java中就返回一个int类型。
    Java对象
Java对象做为引用被传递到本地方法中，所有这些Java对象的引用都有一个共同的父类型jobject(相当于java中的Object类是所有类的父类一样)。

以上展示了Java和本地代码之间的类型映射，这些类型是可以互换的，您可以在您使用int类型的位置使用jint类型，当然反过来也一样，而且不需要任何类型转化。但是，Java的字符串和数组类型和本地的字符串与数组类型之间的转换就比较困难了，如果您使用的jstring类型中出现了字符“*”，您的代码会造成JVM的崩溃，以下的例子说明了您应当如何正确使用字符串：

JNIEXPORT void JNICALL Java_ClassName_MethodName

  (JNIEnv *env, jobjectobj, jstringjavaString)

{

    //Get the native string from Java string

    const char *nativeString = env->GetStringUTFChars(env,javaString, 0);

    printf("%s", nativeString);

    env->ReleaseStringUTFChars(env,javaString, nativeString);

}

您需要使用界面指针env来操作Java对象。