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*的长 度