JNI环境变量——JNIEnv*的使用

 

先看现象：

1. .h文件

JNIEXPORT jintArray JNICALL Java_com_example_testjni_MainActivity_getByteArrayFromC
  (JNIEnv *, jobject, jcharArray);

 

2. .c主函数

JNIEXPORT jintArray JNICALL Java_com_example_testjni_MainActivity_getByteArrayFromC
  (JNIEnv * env, jobject jobj, jcharArray jcarr){
 jcarr.
 return (*env)->NewIntArray(env,cstr);
}

 

3. .c成员函数

/**
 * 返回值 char* 这个代表char数组的首地址
 *  Jstring2CStr 把java中的jstring的类型转化成一个c语言中的char 字符串
 */
char*   Jstring2CStr(JNIEnv*   env,   jstring   jstr)
{
  char*   rtn   =   NULL;
  jclass   clsstring   =   (*env)->FindClass(env,"java/lang/String"); //String
  jstring   strencode   =   (*env)->NewStringUTF(env,"GB2312");  // 得到一个java字符串 "GB2312"
  jmethodID   mid   =   (*env)->GetMethodID(env,clsstring,   "getBytes",   "(Ljava/lang/String;)[B"); //[ String.getBytes("gb2312");
  jbyteArray   barr=   (jbyteArray)(*env)->CallObjectMethod(env,jstr,mid,strencode); // String .getByte("GB2312");
  jsize   alen   =   (*env)->GetArrayLength(env,barr); // byte数组的长度
  jbyte*   ba   =   (*env)->GetByteArrayElements(env,barr,JNI_FALSE);
  if(alen   >   0)
  {
   rtn   =   (char*)malloc(alen+1);         //"\0"
   memcpy(rtn,ba,alen);
   rtn[alen]=0;
  }
  (*env)->ReleaseByteArrayElements(env,barr,ba,0);  //
  return rtn;
}

 

4. jni.h中的静态函数

接口： jmethodID   (*FromReflectedMethod)(JNIEnv*, jobject);

函数： jintArray     (*NewIntArray)(JNIEnv*, jsize);

重载： jintArray NewIntArray(jsize length)
    { return functions->NewIntArray(this, length); }

 

发现：

 

所有的JNI调用都使用了JNIEnv*类型的指针，习惯上在CPP文件中将这个变量定义为env，它是任意一个本地方法的第一个参数。env指针指向一个函数指针表，在VC中可以直接用"->"操作符访问其中的函数。

    jobject 指向在此 Java 代码中实例化的 Java 对象 LocalFunction的一个句柄，相当于this指针。后续的参数就是本地调用中有Java程序传进的参数，本例中只有一个String型参数。对于字符串型参数，因为在本地代码中不能直接读取Java字符串，而必须将其转换为C/C++字符串或Unicode。以下是我们经常会用到的字符串类型处理的函数：

（1）   const char* GetStringUTFChars (jstring string,jboolean* isCopy)
返回指向字符串UTF编码的指针，如果不能创建这个字符数组，返回null。这个指针在调用ReleaseStringUTFChar()函数之前一直有效。 参数：
string Java字符串对象
isCopy 如果进行拷贝，指向以JNI_TRUE填充的jboolean,否则指向以JNI_FALSE填充的jboolean。

（2）   void ReleaseStringUTFChars(jstring str, const char* chars)
通知虚拟机本地代码不再需要通过chars访问Java字符串。
参数：
string Java字符串对象
chars 由GetStringChars返回的指针

（3）   jstring NewStringUTF(const char *utf)
返回一个新的Java字符串并将utf内容拷贝入新串，如果不能创建字符串对象，返回null。通常在反值类型为string型时用到。
参数：
utf UTF编码的字符串指针，对于数值型参数，在C/C++中可直接使用，其字节宽度如下所示：

对于上述类型数组，有一组函数与之对应，以下函数中Xxx为对应类型。
xxx* GetXxxArrayElements(xxxArray array, jboolean *isCopy)
产生一个指向Java数组元素的C指针。不再需要时，需将此指针传给Relea***xxArrayElements
参数：
array 数组对象
isCopy 如果进行拷贝，指向以JNI_TRUE填充的jboolean,否则指向以JNI_FALSE填充的jboolean。
例如：jboolean * GetBooleanArrayElements(jbooleanArray array, jboolean *isCopy)

（4）   void Relea***xxArrayElements(xxxArray array,xxx *elems, jint mode)
通知虚拟机不再需要从GetXxxArrayElements得到的指针。
参数：
array 数组对象
elems 不再需要的指向数组元素的指针
mode 0＝在更新数组元素后释放elems缓冲器
JNI_COMMIT＝在更新数组元素后不释放elems缓冲器
JNI_ABORT＝不更新数组元素释放elems缓冲器
例如：void ReleaseBooleanArrayElements(jbooleanArray array,jboolean *elems, jint mode)

（5）   xxxArray NewXxxArray(jsize len)
产生一个新的数组，通常在反值类型为数组型时用到。
参数：
len 数组中元素的个数。
例如：jbooleanArray NewBooleanArray(jsize len)