学习android JNI的那些事儿--------3. basic Types, Strings and Arrays

学习一门新的编程语言，数据类型是最基本的东西，这里我们讲述下jni中的数据类型。

在JNI中把数据类型分为3类：

primitive type:int float char

reference type:class instances arrays

string type

在上一篇HelloWorld中我们打印出HelloWorld等字样，我们没有传入任何参数，这里先给出一个例子，我们在java端传入字符串，然后看在jni中时如何做处理的。

这个例子跟之前的Helloworld差不多，稍作修改，我们在java端传入参数，

新建一个类，专门用来封转jni的method：

package com.android.jni;

public class Prompt {
	public native String getLine(String prompt);
	static {
		System.loadLibrary("MyJNI");
	}

}

在主activity中调用：

	//调用原生函数得到字符串str
	Prompt pmt = new Prompt();
	String str=pmt.getLine("Put in a line!");
	//吐出message
	Toast.makeText(mContext, str, Toast.LENGTH_SHORT).show();
			

我们调用了Prompt中的getLine方法。

然后看下C中的代码：

jstring
Java_com_android_jni_Prompt_getLine(JNIEnv* env,jobject jobj,jstring prompt)
{
	char buf[128];
	const jbyte *str;
	str = (*env)->GetStringUTFChars(env,prompt,NULL);
	if(str == NULL)
		return NULL;
	__android_log_print(ANDROID_LOG_INFO,"-JNI-","%s",str);
	(*env)->ReleaseStringUTFChars(env,prompt,str);
	sprintf(buf,"From C + %s",str);
	return (*env)->NewStringUTF(env,buf);
}

getLine函数呼叫了JNI的功能函数GetStringUFTChars来读取我们传入的prompt字符串（java端）。GetStringUFTChars函数进入JNIEnv 结构指针，把java中的UTF-8字符类型转变成C中的Unicode sequence，转换成jstring 参考来使用。

最后在释放str的时候不要忘记检查str是否为空，因为GetStringUFTChars函数可能会调用失败（outofmenory）。

当原生代码把传进来的UTF-8类型字符串之后应该立即释放内存调用ReleaseStringUTFChars。

调用NewStringUTF函数来构建新的字符串return给java代码。

在模拟器中运行，当我们点击按钮的时候会出现字符串，“From C + 。。。”

调用成功。

---------------------------------------------------------------------------------

下面我们来进入数组,先看下面的数组定义：

int[] iarr;

float[] farr;

Object oarr;

int[][] arr2;

iarr和farr是数据数组，但是oarr和arr2是对象数组。

下面举个例子进入数据数组：

先看下我们要实现的，在java代码中：

				//调用原生函数得到字符串str
				//Prompt pmt = new Prompt();
				//String str=pmt.getLine("Put in a line!");
				int arr[] = new int[10];
				for(int i=0;i<10;i++)
					arr[i]=i;
				int sum = IntArray.sumArray(arr);
				//吐出message
				Toast.makeText(mContext, "sum = "+sum, Toast.LENGTH_SHORT).show();
			

封装动态库function：

package com.android.jni;

public class IntArray {
	public native static int sumArray(int[] arr);

	static {
		System.loadLibrary("IntArray");
	}
}

定义一个数组，然后调用jni中的function来对数组进行操作，这边在java代码中传进去的是一个整形的数组。

-----------------------------------------------------------------------------------------------

我们来看下在jni中是如何处理的：

jint
Java_com_android_jni_Native_sumArray(JNIEnv* env,jobject jobj,jintArray arr)
{
	jint buf[10];
	jint i, sum = 0;
	(*env)->GetIntArrayRegion(env,arr,0,10,buf);
	for(i=0;i<10;i++)
		sum += buf[i];
	return sum;
}

这里调用了GetIntArrayRegion函数来把传进来的arr数组中的数据都拷贝进C，该函数第三个参数是索引的开始值，第四个参数是被拷贝的数。

JNI也可以使用Get/Release<Type>ArrayElements 函数来使原生代码直接拥有数组的指针。

jint
Java_com_android_jni_Native_sumArray(JNIEnv* env,jobject jobj,jintArray arr)
{
//	jint buf[10];
	jint *carr;
	jint i, sum = 0;
//	(*env)->GetIntArrayRegion(env,arr,0,10,buf);
	carr = (*env)->GetIntArrayElements(env,arr,NULL);
	if(carr == NULL)
		return 0;
	for(i=0;i<10;i++)
		sum += carr[i];
	(*env)->ReleaseIntArrayElements(env,arr,carr,0);
	return sum;
}

运行模拟器：

----------------------------------------------------------------------------------------

下面我们来看下jni中对对象数组的处理。

看下原生函数的声明

public static native int[][] intitInt2DArray(int size);	

下面是jni中的实现

jobjectArray
Java_com_android_jni_Native_initInt2DArray(JNIEnv *env,
		jclass cls,int size)
{
	jobjectArray result;
	int i;
	jclass intArrCls = (*env)->FindClass(env, "[I");
	if (intArrCls == NULL) {
		return NULL; /* exception thrown */
	}
	result = (*env)->NewObjectArray(env, size, intArrCls,NULL);
	if (result == NULL) {
		return NULL; /* out of memory error thrown */
	}
	for (i = 0; i < size; i++) {
		jint tmp[256]; /* make sure it is large enough! */
		int j;
		jintArray iarr = (*env)->NewIntArray(env, size);
		if (iarr == NULL) {
			return NULL; /* out of memory error thrown */
		}
		for (j = 0; j < size; j++) {
			tmp[j] = i + j;
		}
		(*env)->SetIntArrayRegion(env, iarr, 0, size, tmp);
		(*env)->SetObjectArrayElement(env, result, i, iarr);
		(*env)->DeleteLocalRef(env, iarr);
	}
	return result;
}

------------------------------------------------------------------------------------------

ok，我们的基本数据类型就介绍到这，这里数据类型还有很多，大家可以参考user guide，一般我遇到新类型就去翻资料。

下面我们会介绍jni是如何调用java中的成员函数和成员变量的。