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);//返回的时候，要生成一个jstring类型的对象

    return rtstr;
}

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

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

如果我们想对String进行修改的话，需要调用 env->ReleaseStringUTFChars 把char*反射到String来进行修改。

如:  env->ReleaseStringUTFChars(prompt, str);

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

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

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