JAVA基础之理解JNI原理

JNI是JAVA标准平台中的一个重要功能，它弥补了JAVA的与平台无关这一重大优点的不足，在JAVA实现跨平台的同时，也能与其它语言（如C、C++）的动态库进行交互，给其它语言发挥优势的机会。

有了JAVA标准平台的支持，使JNI模式更加易于实现和使用。在此总结了下面这个知识图：

JNI（Java Native Interface）的书写步骤

      ·编写带有native声明的方法的java类
      ·使用javac命令编译所编写的java类
      ·使用javah ?jni java类名生成扩展名为h的头文件
      ·使用C/C++（或者其他编程想语言）实现本地方法
      ·将C/C++编写的文件生成动态连接库

实例：

环境说明：ubuntu 10.4.2 LTS系统

程序清单1：src/com/magc/jni/HelloWorld.java

/**
 * 
 */
 package com.magc.jni;

 /**
 * @author magc
 *
 */
 public class HelloWorld {
    
    static {
        
        System.loadLibrary("Hello");
        
    }

    public     native void DisplayHello();
    /**
     * @param args
     */
    public static void main(String[] args) {

        new HelloWorld().DisplayHello();
    }

}

 进入src目录下，编译该JAVA类，

命令：javac ./com/magc/jni/HelloWorld.java

在该HelloWorld.java所在目录下生成HelloWorld.class

然后使用javah生成头文件，

命令：javah -jni com.magc.jni.HelloWorld

在当前目录下生成com_magc_jni_HelloWorld.h头文件，此文件供C、C++程序来引用并实现其中的函数

程序清单2：com_magc_jni_HelloWorld.h

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
 /* Header for class com_magc_jni_HelloWorld */

#ifndef _Included_com_magc_jni_HelloWorld
#define _Included_com_magc_jni_HelloWorld
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_magc_jni_HelloWorld
 * Method:    DisplayHello
 * Signature: ()V
 */
JNIEXPORT void JNICALL Java_com_magc_jni_HelloWorld_DisplayHello
  (JNIEnv *, jobject);

#ifdef __cplusplus
}
#endif
#endif

注：1)、此头文件是不需要用户编译的，直接供其它C、C++程序引用。

     2)、此头文件中的Java_com_magc_jni_HelloWorld_DisplayHello (JNIEnv  * , jobject)方法，是将来与动态链接库交互的接口，并需要名字保持一致。

 程序清单3：src/jni_helloworldImpl.cpp

#include <jni.h>
#include "com_magc_jni_HelloWorld.h"
#include <stdio.h>
JNIEXPORT void JNICALL Java_com_magc_jni_HelloWorld_DisplayHello
(JNIEnv *env, jobject obj)
{
    printf("From jni_helloworldImpl.cpp :");
    printf("Hello world ! \n");
    return;
}

此C++文件实现了上述头文件中的函数，注意方法函数名要保持一致。

编译生成动态库libHello.so,

命令：g++ -shared -I /usr/lib/jvm/java-6-openjdk/include jni_helloworldImpl.cpp -o libHello.so

成功后，便会在当前目录下生成动态链接库libHello.so文件。

有了具体实现的动态库后，就可以运行JAVA调用JNI程序类的native方法了，

命令：java -Djava.library.path=. com.magc.jni.HelloWorld

输入结果即为： From jni_helloworldImpl.cpp :Hello world ! 

 本文参考部分内容参考：

1、http://www.iteye.com/topic/304594#814127

2、《Android应用开发详解》

全局和局部引用

JNI把本地代码使用的相关对象分为两在范畴：局部和全局引用。局部引用的有效期为一个本地方法调用的时间，并自动机方法返回后获释。全球引用仍然有效，直到它们被明确释放。

所有的Java的JNI函数返回的对象都是局部引用。JNI允许程序员通过局部引用来创建全局引用。

局部引用只有在线程中被建立时才有效，并只在该线程中有效。本地代码不能在线程之间调用局部引用。

访问字段和方法

JNI允许本地代码访问字段和调用Java对象的方法。JNI通过符号名称和类型签名来判定方法和字段。例如，要调用类cls中的方法f，本地代码首先获得一个方法的ID，如下：

jmethodID mid = env->GetMethodID(cls, “f”, “(ILjava/lang/String;)D”);

本地代码便可以重复的使用method ID而在方法查找时不需要时间，具体如下：

jdouble result = env->CallDoubleMethod(obj, mid, 10, str);

报告程序错误

JNI不检查编程错误，如空指针或非法参数类型传递。非法使用的参数类型包括用父类对象引用子类对象。

Java异常

JNI允许本地方法任意提高Java异常。本机代码也可以处理严重的Java异常。 Java的未处理的异常是传送回了VM。

因此，程序员可以快速检查上次的JNI调用的返回值，以确定是否发生了错误，并调用一个函数，ExceptionOccurred（），以获得异常对象，它包含一个错误的条件更详细的说明。

异常处理

在本地代码中有两种方法处理异常：

1、本机方法可以选择立即返回，在Java代码中抛出异常，启动了本地方法调用。

2、本地代码能过调用ExceptionClear()来清除异常，然后执行自己的异常处理代码。

在异常被提升之后，本地代码在其它JNI调用之前必须先清除异常。

JNI（Java Native Interface）调用中考虑的问题

      在首次使用JNI的时候有些疑问，后来在使用中一一解决，下面就是这些问题的备忘：

      1。 java和c是如何互通的？
      其实不能互通的原因主要是数据类型的问题，jni解决了这个问题，例如那个c文件中的jstring数据类型就是java传入的String对象，经过jni函数的转化就能成为c的char*。
      对应数据类型关系如下表：
        Java 类型 本地c类型 说明
        boolean jboolean 无符号，8 位
        byte jbyte 无符号，8 位
        char jchar 无符号，16 位
        short jshort 有符号，16 位
        int jint 有符号，32 位
        long jlong 有符号，64 位
        float jfloat 32 位
        double jdouble 64 位
        void void N/A

      2. 如何将java传入的String参数转换为c的char*，然后使用?
java 传入的String参数，在c文件中被jni转换为jstring的数据类型，在c文件中声明char* test，然后test = (char*)(*env)->GetStringUTFChars(env, jstring, NULL);注意：test使用完后，通知虚拟机平台相关代码无需再访问：(*env)->ReleaseStringUTFChars(env, jstring, test);

      3. 将c中获取的一个char*的buffer传递给java？
这个char*如果是一般的字符串的话，作为string传回去就可以了。如果是含有’/0’的buffer，最好作为bytearray传出，因为可以制定copy的length，如果copy到string，可能到’/0’就截断了。
      有两种方式传递得到的数据：
      一种是在jni中直接new一个byte数组，然后调用函数(*env)->SetByteArrayRegion(env, bytearray, 0, len, buffer);将buffer的值copy到bytearray中，函数直接return bytearray就可以了。
      一种是return错误号，数据作为参数传出，但是java的基本数据类型是传值，对象是传递的引用，所以将这个需要传出的byte数组用某个类包一下，如下：
class RetObj
{
public byte[] bytearray;
}
这个对象作为函数的参数retobj传出，通过如下函数将retobj中的byte数组赋值便于传出。代码如下：
jclass cls;
jfieldID fid;
jbyteArray bytearray;
bytearray = (*env)->NewByteArray(env,len);
(*env)->SetByteArrayRegion(env, bytearray, 0, len, buffer);
cls = (*env)->GetObjectClass(env, retobj);
fid = (*env)->GetFieldID(env, cls, "retbytes", "[B"]);
(*env)->SetObjectField(env, retobj, fid, bytearray);

      4. 不知道占用多少空间的buffer，如何传递出去呢？
      在jni的c文件中new出空间，传递出去。java的数据不初始化，指向传递出去的空间即可。