引用数据类型的操作

1、字符串

// 用给定的 C 字符串创建 Java 字符串
jstring javaString;
javaString = (*env)->NewStringUTF(env, "Hello World!");

// 将 Java 字符串转换成 C 字符串
const jbyte* str;
jboolean isCopy;

str = (*env)->GetStringUTFCharts(env, javaString, &isCopy);
if( 0 != str)
  printf("Java string: %s", str);

  if(JNI_TRUE == isCopy){
    printf("C string is a copy of the Java string.");
  }else{
    printf("C string points to actual string.");
  }
}

// 释放 JNI 函数返回的 C 字符串
(*env)->ReleaseStringUTFCharts(env, javaString, str);

 

2、数组

// 在原生代码中创建数组
jintArray javaArray;
javaArray = (*env)->NewIntArray(env, 10);
if( 0 != javaArray){
  /*现在可以使用数组了*/
}

// 将 Java 数组区复制到 C 数组中
jint nativeArray[10];
(*env)->GetIntArrayRegion(env, javaArray, 0, 10, nativeArray);

// 从 C 数组向 Java 数组提交所作的修改
(*env)->SetIntArrayRegion(env, javaArray, 0, 10, nativeArray);

// 获得指向 Java 数组元素的直接指针
jint* nativeDirectArray;
jboolean isCopy;

nativeDirectArray = (*env)->GetIntArrayElements(env, javaArray, &isCopy);

// 释放指向 Java 数组元素的直接指针
(*env)->ReleaseIntArrayElements(env, javaArray, nativeDirectArray, 0);

 

3、NIO 缓冲区

// 基于给定的 C 字节数组创建字节缓冲区
unsigned char* buffer = (unsigned char*)malloc(1024);

jobject direcctBuffer;
direcctBuffer = (*env)->NewDirecctByteBuffer(env, buffer, 1024);

// 通过 Java 字节缓冲区获取原生字节数组
unsigned char* buffer;
buffer = (unsigned char*)(*env)->GetDirectBufferAddress(env, directBuffer);

 

4、访问域

// 带有静态域和实例域的 Java 类
public class JavaClass{
  /*实例域*/
  private String instanceField = "Instance Field";

  /*静态域*/
  private static String staticField = "Static Field";
}

// 用对象引用获得类
jclass clazz;
clazz = (*env)->GetObjectClass(env, instance);

// 获取实例域ID
jfieldID instanceFieldId;
instanceFieldId = (*env)->GetFieldID(env, clazz, "instanceField", "Ljava/lang/String;");

// 获取静态域ID
jfieldID staticFieldId;
staticFieldId = (*env)->GetStaticFieldID(env, clazz, "staticField", "Ljava/lang/String;");

// 获得实例域
jstring instanceField;
instanceField = (*env)->GetObjectField(env, instance, instanceFieldId);

// 获得静态域
jstring staticField;
staticField = (*env)->GetStaticObjectField(env, clazz, staticFieldId);

 

5、调用方法

// 带有静态方法和实例方法的 Java 类
public class JavaClass{

   /*实例方法*/
  private String instanceMethod(){
    return "Instance Method";
  }

  /*静态方法*/
  private static String staticMethod(){
    return "Static Method";
  }
}

// 获取实例方法ID
jmethodID instanceMethodId;
instanceMethodId = (*env)->GetMethodID(env, clazz, "instanceMethod", "()Ljava/lang/String;");
 
// 获取静态方法ID
jmethodID staticMethodId;
staticMethodId = (*env)->GetStaticMethodID(env, clazz, "staticMethod", "()Ljava/lang/String;");

// 调用实例方法
jstring instanceMethodResult;
instanceMethodResult = (*env)->CallStringMethod(env, instance, instanceMethodId);
 
// 调用静态方法
jstring staticMethodResult;
staticMethodResult = (*env)->CallStaticStringMethod(env, clazz, StaticMethodId);

 

6、异常处理

// 抛出异常的 Java 类
public class JavaClass{

   /* 抛出方法 */
  private void throwingMethod() throws NullPointerException {
    throw new NullPointerException("Null pointer");
  }

  /* 访问方法（原生方法）*/
  private native void accessMethod();
  }
}

// 原生代码中的异常处理
jthrowable ex;

(*env)->CallVoidMethod(env, instance, throwingMethod);
ex = (*env)->ExceptionOccurred(env);

if( 0 != ex){
  (*env)->ExceptionClear(env);

  /* Exception handler*/
}

// 原生代码中抛出异常
jclass clazz;

clazz = (*env)->FindClass(env, "java/lang/NullPointerException");

if( 0 != clazz){
  (*env)->ThrowNew(env, clazz, "Exception message.");
}

 

7、局部和全局引用

// 删除一个局部引用
jclass clazz;
clazz = (*env)->FindClass(env, "java/lang/String");

(*env)->DeleteLocalRef(env, clazz);

// 用给定的局部引用创建全局引用
jclass localClazz;
jclass globalClazz;

localClazz = (*env)->FindClass(env, "java/lang/String");
globalClazz = (*env)->NewGlobalRef(env, localClazz);

(*env)->DeleteLocalRef(env, localClazz);

// 删除一个全局引用
(*env)->DeleteGlobalRef(env, globalClazz);

// 用给定的局部引用创建弱全局引用
jclass weakGlobalClazz;
weakGlobalClazz = (*env)->NewWeakGlobalRef(env, localClazz);

// 检验弱全局变量是否有效
if(JNI_FALSE == (*env)->IsSameObject(env, weakGlobalClazz, NULL)){
  /* 对象仍然处于活动状态且可以使用 */
}else{
  /* 对象被垃圾回收器收回，不能使用 */
}

// 删除一个弱全局引用
(*env)->DeleteWeakGlobalRef(env, weakGlobalClazz);

 

8、同步

// Java 同步代码块
synchronized(obj){
  /* 同步线程安全代码块 */
}

// Java 同步代码块的原生等价
if(JNI_OK == (*env)->MonitorEnter(env, obj)){
  /* 错误处理 */
}

/* 同步线程安全代码块 */

if(JNI_OK == (*env)->MonitorExit(env, obj)){
  /* 错误处理 */
}

// 将当前线程与虚拟机附着和分离
JavaVM* cachedJvm;
JNIEnv* env;

/* 将当前线程附着到虚拟机 */
(*cachedJvm)->AttachCurrentThread(cachedJvm, &env, NULL);

/* 可以用 JNIEnv 接口实现线程与 Java 应用程序的通信 */

/* 将当前线程与虚拟机分离 */
(*cachedJvm)->DetachCurrentThread(cachedJvm);