JNI编程中如何传递参数和返回值

2014-11-24 09:12:54 · 作者: · 浏览: 0

本篇将介绍在JNI编程中如何传递参数和返回值。


首先要强调的是,native方法不但可以传递Java的基本类型做参数,还可以传递更复杂的类型,比如String,数组,甚至自定义的类。这一切都可以在jni.h中找到答案。


1. Java基本类型的传递


用过Java的人都知道,Java中的基本类型包括boolean,byte,char,short,int,long,float,double 这样几种,如果你用这几种类型做native方法的参数,当你通过javah -jni生成.h文件的时候,只要看一下生成的.h文件,就会一清二楚,这些类型分别对应的类型是 jboolean,jbyte,jchar,jshort,jint,jlong,jfloat,jdouble 。这几种类型几乎都可以当成对应的C++类型来用,所以没什么好说的。


2. 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


#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


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;


}


在上面的例子中,作为参数的prompt不能直接被C++程序使用,先做了如下转换
str = env->GetStringUTFChars(prompt, false);
将jstring类型变成一个char*类型。


返回的时候,要生成一个jstring类型的对象,也必须通过如下命令,
jstring rtstr = env->NewStringUTF(tmpstr);


这里用到的GetStringUTFChars和NewStringUTF都是JNI提供的处理String类型的函数,还有其他的函数这里就不一一列举了。


3. 数组类型的传递


和String一样,JNI为Java基本类型的数组提供了j*Array类型,比如int[]对应的就是jintArray。来看一个传递int数组的例子,Java程序就不写了,


JNIEXPORT jint JNICALL Java_IntArray_sumArray(JNIEnv *env, jobject obj, jintArray arr)


{


jint *carr;


carr = env->GetIntArrayElements(arr, false);


if(carr == NULL) {


return 0; /* exception occurred */


}


jint sum = 0;


for(int i=0; i<10; i++) {


sum += carr[i];


}


env->ReleaseIntArrayElements(arr, carr, 0);


return sum;


}


这个例子中的GetIntArrayElements和ReleaseIntArrayElements函数就是JNI提供用于处理int数组的函数。如果试图用arr[i]的方式去访问jintArray类型,毫无疑问会出错。JNI还提供了另一对函数GetIntArrayRegion和 ReleaseIntArrayRegion访问int数组,就不介绍了,对于其他基本类型的数组,方法类似。