3.3 JNI传参

之前是一个jni无参数的传递方式。

如果你习惯了使用JNI，你就不会觉得它难了。

下面我们尝试一些参数的传参方法。

我们在一个java测试类中，加入如下测试接口，来测试一些传参方式。

返回值和参数类型根据等价约定映射到本地C/C++类型，如表JNI类型映射所示。有些类型，在本地代码中可直接使用，而其他类型只有通过JNI调用操作。

String类型的传参

(1) java接口声明代码

    //String 类型的传参
    public native String getLine(String str);

(2) 通过javah 生成native接口对应的C++接口

cd /home/itcast/AndroidStudioProjects/testApp/app/src/main/java

javah -jni com.cpp.itcast.testapp.HelloJni

我们会得到这个接口的原型。

/*
 * Class:     com_cpp_itcast_testapp_HelloJni
 * Method:    getLine
 * Signature: (Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_cpp_itcast_testapp_HelloJni_getLine
  (JNIEnv *, jobject, jstring);

(3) 在.cpp文件中，定义这个文件，来实现java类型和Cpp类型的转换。

/*
 * Class:     com_cpp_itcast_testapp_HelloJni
 * Method:    getLine
 * Signature: (Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_cpp_itcast_testapp_HelloJni_getLine
  (JNIEnv * env, jobject obj , jstring str)
{
    const char *cstr;

    //将jstring 转换成 char*
    cstr = env->GetStringUTFChars(str, NULL);
    if (str == NULL) {
        return NULL;
    }

    __android_log_print(ANDROID_LOG_ERROR, "jnitag", "测试 String 传参: %s", cstr);

    //GetStringUTFChars 之后需要调用ReleaseStringUTFChars释放
    env->ReleaseStringUTFChars(str, cstr);

    //将char* 转换成jstring，供java使用
    jstring retstr = env->NewStringUTF("return string succ!");

    return retstr;
}

(4) java测试调用

//测试 String 传参 JNI
String str = HelloJni.getInstance().getLine("java's string");
Log.e(logTag, str);

int类型和boolean类型的传参

(1) java接口声明代码

    //int 和 boolean 类型的传参
    public native int testBoolInt(int num, boolean b);

(2) 通过javah 生成native接口对应的C++接口

cd /home/itcast/AndroidStudioProjects/testApp/app/src/main/java

javah -jni com.cpp.itcast.testapp.HelloJni

我们会得到这个接口的原型。

JNIEXPORT jint JNICALL Java_com_cpp_itcast_testapp_HelloJni_testBoolInt
  (JNIEnv *env, jobject obj , jint  java_int,  jboolean  java_bool);

(3) 在.cpp文件中，定义这个文件，来实现java类型和Cpp类型的转换。

JNIEXPORT jint JNICALL Java_com_cpp_itcast_testapp_HelloJni_testBoolInt
  (JNIEnv *env, jobject obj , jint  java_int,  jboolean  java_bool)
{
    //java中的int可以和java中的jint 直接转换
    int cint = java_int;
    __android_log_print(ANDROID_LOG_ERROR, "jnitag","int = %d", cint);

    //java中的jboolean会有两个取值 JNI_TRUE, JNI_FALSE
    __android_log_print(ANDROID_LOG_ERROR, "jnitag", "bool = %s", (java_bool == JNI_TRUE)? "true":"false");

    return (jint)cint;
}

(4) java测试调用

//测试 int 和 boolean 传参
int num = HelloJni.getInstance().testBoolInt(100, false);
Log.e(logTag, "num = " + num + ", test is succ!");

（int,boolean,String）数组传参

使用数组：

JNI通过JNIEnv提供的操作Java数组的功能。它提供了两个函数：一个是操作java的简单型数组的，另一个是操作对象类型数组的。

因为速度的原因，简单类型的数组作为指向本地类型的指针暴露给本地代码。因此，它们能作为常规的数组存取。这个指针是指向实际的Java数组或者Java数组的拷贝的指针。另外，数组的布置保证匹配本地类型。

为了存取Java简单类型的数组，你就要要使用GetXXXArrayElements函数，XXX代表了数组的类型。这个函数把Java数组看成参数，返回一个指向对应的本地类型的数组的指针。

当你对数组的存取完成后，要确保调用相应的ReleaseXXXArrayElements函数，参数是对应Java数组和GetXXXArrayElements返回的指针。如果必要的话，这个释放函数会复制你做的任何变化（这样它们就反射到java数组），然后释放所有相关的资源。

为了使用java对象的数组，你必须使用GetObjectArrayElement函数和SetObjectArrayElement函数，分别去get，set数组的元素。GetArrayLength函数会返回数组的长度。

(1) java接口声明代码

    //int 数组 ， boolean数组， String 数组 传参
    public native String[] testArray(int [] iList, String [] sList, boolean[] bList);

(2) 通过javah 生成native接口对应的C++接口

cd /home/itcast/AndroidStudioProjects/testApp/app/src/main/java

javah -jni com.cpp.itcast.testapp.HelloJni

我们会得到这个接口的原型。

JNIEXPORT jobjectArray JNICALL Java_com_cpp_itcast_testapp_HelloJni_testArray
  (JNIEnv *, jobject, jintArray, jobjectArray, jbooleanArray);

(3) 在.cpp文件中，定义这个文件，来实现java类型和Cpp类型的转换。

JNIEXPORT jobjectArray JNICALL Java_com_cpp_itcast_testapp_HelloJni_testArray
  (JNIEnv * env, jobject obj , jintArray java_i_array, jobjectArray java_str_array, jbooleanArray java_b_array)
{
    //处理boolean数组
    jboolean* pba = (env)->GetBooleanArrayElements(java_b_array, 0);
    jsize len = (env)->GetArrayLength(java_b_array);
    int i = 0;

    for (i = 0; i < len; i++) {
        __android_log_print(ANDROID_LOG_ERROR, "jnitag", "bArray[%d] = %s",i, (pba[i] == JNI_TRUE)? "true":"false");

    }
    (env)->ReleaseBooleanArrayElements(java_b_array, pba, 0);


    //处理int数组
    jint *pia = (env)->GetIntArrayElements(java_i_array, 0);
    len = (env)->GetArrayLength(java_i_array);
    for (i = 0; i < len; i ++) {
        __android_log_print(ANDROID_LOG_ERROR, "jnitag", "iArray[%d] = %d", i,pia[i]);
    }
    (env)->ReleaseIntArrayElements(java_i_array, pia, 0);


    //处理String数组
    len = (env)->GetArrayLength(java_str_array);
    for (i = 0; i < len; i++) {
       //由于String不是一个基本类型，而是一个实例对象类型
       //所以调用GetObjectArrayElement
       jstring jstrObj= (jstring)(env)->GetObjectArrayElement(java_str_array, i);

       __android_log_print(ANDROID_LOG_ERROR, "jnitag", "stringArray[%d] = %s",i, env->GetStringUTFChars(jstrObj,NULL));
    }


    //返回String 数组
    jstring str;
    jobjectArray strArray;
    jsize arrayLen = 5;

    const char * sa[] = {"hello", "JNI", "is", "so", "EASY!"};

    //string不是一个基本数据类型，是一个复杂的类型，所以需要用newObjectArray，
    //以下一句代码，表示该Object是一个String类型的数组
    strArray = (env)->NewObjectArray(arrayLen,(env)->FindClass("java/lang/String"),0);

    for (i = 0; i < 5;i++) {
        str = (env)->NewStringUTF(sa[i]);
        (env)->SetObjectArrayElement(strArray, i, str);
    }

    return strArray;
}

(4) java测试调用

//测试 int 数组 ， boolean数组， String 数组 传参
int[] iList = new int[] {1,2,3,4,5,6,7,8};
String[] sList = new String[]{"hello","ITCAST", "so", "COOL!!"};
boolean[] bList = new boolean[]{true, false, true, false};
String retList[] = HelloJni.getInstance().testArray(iList, sList, bList);

for (int i = 0;i < retList.length; i++) {
    Log.e(logTag, retList[i]);
}

对象传参

JNI提供的另外一个功能是在本地代码中使用Java对象。通过使用合适的JNI函数，你可以创建Java对象，get、set 静态(static)和实例（instance）的域，调用静态(static)和实例（instance）函数。JNI通过ID识别域和方法，一个域或方法的ID是任何处理域和方法的函数的必须参数。

下表列出了用以得到静态(static)和实例（instance）的域与方法的JNI函数。每个函数接受（作为参数）域或方法的类，它们的名称，符号和它们对应返回的jfieldID或jmethodID。

如果你有了一个类的实例，它就可以通过方法GetObjectClass得到，或者如果你没有这个类的实例，可以通过FindClass得到。符号是从域的类型或者方法的参数，返回值得到字符串，如下表所示。

详细例子 可以参考 http://blog.csdn.net/qinjuning/article/details/7607214