NDK中JAVA接口参数类型与C/C++类型的转换处理总结

1.Java，C++和JNI中自定义类型对应关系

2.具体类型的转换和方法

在以下情况需要Java类型与本地类型(C++类型)之间的转换：

• java方法里面将参数传入本地方法；
• 在本地方法里面创建java对象；
• 在本地方法里面return结果给java程序。

下面分两种情况来进行讨论：

一.Java原始类型：

原始类型从Java程序中传到本地方法中的原始类型可以直接使用，也就是说如果我在方法中传进去了一个boolean的参数的话，那么我在本地方法中就有unsigned char类型与之对应。

二.Java对象和数组

Java对象做为引用被传递到本地方法中，所有这些Java对象的引用都有一个共同的父类型jobject(相当于java中的Object类是所有类的父类一样)。下面是JNI实现的一些jobject的子类：

本地方法中访问java程序中的内容

a) 访问String对象：
从java程序中传过去的String对象在本地方法中对应的是jstring类型，jstring类型和c中的char*不同，所以如果你直接当做char*使用的话，就会出错。因此在使用之前需要将jstring转换成为c/c++中的char*，这里使用JNIEnv的方法转换。下面是一个例子：

JNIEXPORT jstring JNICALL Java_com_example_ndkinterfacetest_ndkInterface_Ndk_1String
  (JNIEnv *env, jobject obj, jstring prompt, jint port, jintArray arr)
{
    char buf[128];
    char outBuf[128];
    const char *str = (*env).GetStringUTFChars(prompt, 0);

    memset(buf, 0, 128);
    memset(outBuf, 0, 128);
    memcpy(buf, str, strlen(str));

    sprintf(outBuf, "string: %s port: %d sum: %d", buf, port, sum);

    (*env).ReleaseStringUTFChars(prompt, str);

    return env->NewStringUTF((const char *)outBuf);
}

这里使用GetStringUTFChars方法将传进来的prompt（jstring类型）转换成为UTF-8的格式，就能够在本地方法中使用了。
注意：在使用完你所转换之后的对象之后，需要显示调用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*的长度；

b) 访问Array对象：
和String对象一样，在本地方法中不能直接访问jarray对象，而是使用JNIEnv指针指向的一些方法来是用。

//java接口代码
public class ndkInterface {
    static{
        System.loadLibrary("ndkInterface");
    }

    public native String Ndk_String(String prompt, int port,  int[] arr);

}

//本地接口
/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_example_ndkinterfacetest_ndkInterface */

#ifndef _Included_com_example_ndkinterfacetest_ndkInterface
#define _Included_com_example_ndkinterfacetest_ndkInterface
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_example_ndkinterfacetest_ndkInterface
 * Method:    Ndk_String
 * Signature: (Ljava/lang/String;I[I)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_com_example_ndkinterfacetest_ndkInterface_Ndk_1String
  (JNIEnv *, jobject, jstring, jint, jintArray);

#ifdef __cplusplus
}
#endif
#endif

下面是具体的转换代码：

JNIEXPORT jstring JNICALL Java_com_example_ndkinterfacetest_ndkInterface_Ndk_1String
  (JNIEnv *env, jobject obj, jstring prompt, jint port, jintArray arr)
  {
    char buf[128];
    char outBuf[128];
    const char *str = (*env).GetStringUTFChars(prompt, 0);

    memset(buf, 0, 128);
    memset(outBuf, 0, 128);
    memcpy(buf, str, strlen(str));

    int i, sum = 0;
    size_t len = (*env).GetArrayLength(arr);//获取数据长度

    int *body = (*env).GetIntArrayElements(arr, 0);//获取指向数组的指针
      //计算整型数组所有元素的和
    for (i = 0; i < len; i++) {
        sum += body[i];
    }
    (*env).ReleaseIntArrayElements(arr, body, 0);//释放数组元素的引用

    sprintf(outBuf, "string: %s port: %d sum: %d", buf, port, sum);

    (*env).ReleaseStringUTFChars(prompt, str);
    return env->NewStringUTF((const char *)outBuf);
  }

//这里举的例子是使用int数组的，同样还有boolean、float等对应的数组。

获取数组元素指针的对应关系：

函数　　　　　　　　　　　　数组类型

GetBooleanArrayElements　　 boolean
GetByteArrayElements　　　　byte
GetCharArrayElements　　　   char
GetShortArrayElements　　　  short
GetIntArrayElements　　　　   int
GetLongArrayElements　　　   long
GetFloatArrayElements　　　   float
GetDoubleArrayElements　　   double

　　
释放数组元素指针的对应关系：
Function　　　　　　　　　　　　Array Type
ReleaseBooleanArrayElements　　  boolean
ReleaseByteArrayElements　　　　 byte
ReleaseCharArrayElements　　　　char
ReleaseShortArrayElements　　　   short
ReleaseIntArrayElements　　　　    int
ReleaseLongArrayElements　　　　long
ReleaseFloatArrayElements　　　    float
ReleaseDoubleArrayElements　　　double

c) 访问自定义Java对象数组：
JNI提供了一组分离的函数取获取对象数组的元素，你可以使用这些函数取获取和设置自定义对象数组元素。

注意：你不能一次性回去所有的对象数组元素。

GetObjectArrayElement ：返回给定索引的数组元素；
SetObjectArrayElement ：更新给定索引的素组元素；

d) 访问Java对象的方法：
在本地方法中调用Java对象的方法的步骤：

1.获取你需要访问的Java对象的类：
jclass cls = (*env)->GetObjectClass(env, obj);
使用GetObjectClass方法获取obj对应的jclass。
2.获取MethodID：
jmethodID mid = (*env)->GetMethodID(env, cls, "callback", "(I)V");
使用GetMethdoID方法获取你要使用的方法的MethdoID。其参数的意义：
env-->JNIEnv
cls-->第一步获取的jclass
"callback"-->要调用的方法名
"(I)V"-->方法的Signature
3.调用方法：
(*env)->CallVoidMethod(env, obj, mid, depth);
使用CallVoidMethod方法调用方法。参数的意义：
env-->JNIEnv
obj-->通过本地方法穿过来的jobject
mid-->要调用的MethodID（即第二步获得的MethodID）
depth-->方法需要的参数（对应方法的需求，添加相应的参数）
注：这里使用的是CallVoidMethod方法调用，因为没有返回值，如果有返回值的话使用对应的方法，在后面会提到。
方法的Signature
方法的Signature是由方法的参数和返回值的类型共同构成的，下面是他们的结构：
"(argument-types)return-type"
其中Java程序中参数类型和其对应的值如下：

Signature　　Java中的类型
Z　　　　　　　boolean
B　　　　　　　byte
C　　　　　　　char
S　　　　　　　short
I　　　　　　　 int
J　　　　　　　 long
F　　　　　　　float
D　　　　　　　double
L fully-qualified-class;　　 fully-qualified-class
　　
[ type　　type[]
　　
( arg-types ) ret-type　　method type

一个Java类的方法的Signature可以通过javap命令获取：
javap -s -p Java类名
给调用的函数传参数：
通常我们直接在methodID后面将要传的参数添加在后面，但是还有其他的方法也可以传参数：
CallVoidMethodV可以获取一个数量可变的列表作为参数；
CallVoidMethodA可以获取一个union。
　　
调用静态方法：　　
就是将第二步和第三步调用的方法改为对应的：
GetStaticMethodID获取对应的静态方法的ID
CallStaticIntMethod调用静态方法
调用超类的方法：
　　　　
4)访问Java对象的属性：
访问Java对象的属性和访问Java对象的方法基本上一样，只需要将函数里面的Method改为Field即可