本篇將介紹在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 <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;
}
在上面的例子中,作為參數的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數組,就不介紹了,對於其他基本類型的數組,方法類似。