JNI中参数的传递与操作(上)

文章参自： http://wenku.baidu.com/view/0b78684669eae009581bec73.html

                   http://wenku.baidu.com/view/3114e862caaedd3383c4d396.html

JNI的所有的本地方法的第一个参数都是指向JNIEnv结构的。这个结构是用来调用JNI函数的。第二个参数jclass/jobject的意义，要看方法是不是静态的（static）或者实例（Instance）的。前者，jclass代表一个类对象的引用，而后者是被调用的方法所属对象的引用。 从第三个参数开始的才是java函数本身传递的参数。

返回值和参数类型根据等价约定映射到本地C/C++类型，如表A所示。有些类型，在本地代码中可直接使用，而有些类型只有通过JNI调用操作。

表A：

Java类型	Java本地C/C++类型	描述
Boolean	Jboolean	C/C++8位整型
Byte	Jbyte	C/C++带符号的8位整型
Char	Jchar	C/C++无符号的16位整型
Short	Jshort	C/C++带符号的16位整型
Int	Jint	C/C++带符号的32位整型
Long	Jlong	C/C++带符号的64位整型e
Float	Jfloat	C/C++32位浮点型
Double	Jdouble	C/C++64位浮点型
Object	Jobject	任何Java对象，或者没有对应java类型的对象
Class	Jclass	Class对象
String	Jstring	字符串对象
Object[]	jobjectArray	任何对象的数组
boolean[]	jbooleanArray	布尔型数组
byte[]	jbyteArray	比特型数组
char[]	jcharArray	字符型数组
short[]	jshortArray	短整型数组
int[]	jintArray	整型数组
long[]	jlongArray	长整型数组
float[]	jfloatArray	浮点型数组
double[]	jdoubleArray	双浮点型数组

一、基本类型

Java中的基本类型包括boolean，byte，char，short，int，long，float，double这样几种，

如果你用这几种类型做native方法的参数，当你通过javah -jni生成.h文件的时候，只要看一下生成的.h文件，就会一清二楚，

这些java类型分别对应的java本地C/C++类型是 jboolean，jbyte，jchar，jshort，jint，jlong，jfloat，jdouble 。这几种类型几乎都可以当成对应的C/C++类型来用。

如果想要返回一个java的基本类型，可以像操作C/C++类型一样，创建一个对应的java本地C/C++类型，操作完成后，最后直接返回它就可以了。

二、String

Java的String和C++的string是不能对等起来的，所以处理起来比较麻烦。

先看一个例子，

class Prompt {

    // native method that prints a prompt and reads a line

     private native String getLine(String prompt);

    public static void main(String args[]) {

        Prompt p = new Prompt();

        String input =  p.getLine("Type a line: ");

        System.out.println("User typed: " + input);

    }

    static {

        System.loadLibrary("Prompt");

    }

}

在这个例子中，我们要实现一个native方法

String getLine(String prompt);

读入一个String参数，返回一个String值。

通过执行javah -jni得到的头文件是这样的

#include <jni.h>

#ifndef _Included_Prompt

#define _Included_Prompt

#ifdef __cplusplus

extern "C" {

#endif

JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv *env, jobject this, jstring prompt);

#ifdef __cplusplus

}

#endif

#endif

jstring是JNI中对应于String的类型，但是和基本类型不同的是，jstring不能直接当作C++的string用。如果你用

cout << prompt << endl;

编译器肯定会扔给你一个错误信息的。

其实要处理jstring有很多种方式，这里只讲一种我认为最简单的方式，看下面这个例子，

#include "Prompt.h"

#include <iostream>

JNIEXPORT  jstring JNICALL Java_Prompt_getLine (JNIEnv *env, jobject obj, jstring prompt)

{

    const char* str;

     str = env->GetStringUTFChars(prompt, false);

    if(str == NULL) {

        return NULL; /* OutOfMemoryError already thrown */

    }

    std::cout << str << std::endl;

     env->ReleaseStringUTFChars(prompt, str);

    char* tmpstr = "return string succeeded";

     jstring rtstr = env->NewStringUTF(tmpstr);

    return rtstr;

}

String不能直接被C++程序使用，需要先用 env->GetStringUTFChars把它转化为UTF编码形式的char*再进行处理。

如： str = env->GetStringUTFChars(prompt, false);

如果想返回一个java的String类型的话，我们可以通过 env->NewStringUTF命令用一个char*来创建一个jstring,然后让该jstring返回就可以。

如： jstring rtstr = env->NewStringUTF(tmpstr);

上面的 GetStringUTFChars，ReleaseStringUTFChars，NewStringUTF都是JNI提供的处理String类型的函数，更多的JNI函数请查看jin.h。

注意： 在使用完你所转换之后的对象之后，需要显示调用  ReleaseStringUTFChars 方法，让JVM释放转换成UTF-8的string的对象的空间，如果不显示的调用的话，JVM中会一直保存 该对象，不会被垃圾回收器回收，因此就会导致内存溢出。

　　下面是访问String的一些方法：

　　◆GetStringUTFChars将jstring转换成为UTF-8格式的char*

　　◆GetStringChars将jstring转换成为Unicode格式的char*

　　◆ReleaseStringUTFChars释放指向UTF-8格式的char*的指针

　　◆ReleaseStringChars释放指向Unicode格式的char*的指针

　　◆NewStringUTF创建一个UTF-8格式的String对象

　　 ◆NewString创建一个Unicode格式的String对象

　　◆GetStringUTFLengt获取 UTF-8格式的char*的长度　

　　◆GetStringLength获取Unicode格式的char*的长 度