com::avpkit::ferry::JNIHelper Class Reference

The JNIHelper object contains a series of methods designed to assist functions when running inside a Java JVM. More...

#include <JNIHelper.h>

Public Types
typedef void(*	CallbackFunc) (JavaVM *jvm, void *closure)

Public Member Functions
VS_API_FERRY JavaVM *	getVM ()
VS_API_FERRY void	setVM (JavaVM *jvm)
VS_API_FERRY void *	getPointer (jobject pointerRef)
VS_API_FERRY void *	setPointer (jobject pointerRef, void *newVal)
VS_API_FERRY jobject	newLocalRef (jobject ref)
VS_API_FERRY void	deleteLocalRef (jobject ref)
VS_API_FERRY jobject	newGlobalRef (jobject ref)
VS_API_FERRY void	deleteGlobalRef (jobject ref)
VS_API_FERRY jweak	newWeakGlobalRef (jobject ref)
VS_API_FERRY void	deleteWeakGlobalRef (jweak ref)
VS_API_FERRY jint	getJNIVersion ()
VS_API_FERRY JNIEnv *	getEnv ()
VS_API_FERRY void	registerInitializationCallback (CallbackFunc, void *closure)
VS_API_FERRY void	registerTerminationCallback (CallbackFunc, void *closure)
VS_API_FERRY void	throwOutOfMemoryError ()
VS_API_FERRY int32_t	isInterrupted ()
VS_API_FERRY bool	isInterruptedException (jthrowable exception)
VS_API_FERRY void	interrupt ()

Static Public Member Functions
static VS_API_FERRY JNIHelper *	getHelper ()
static JavaVM *	sGetVM ()
static void	sSetVM (JavaVM *jvm)
static jint	sGetJNIVersion ()
static JNIEnv *	sGetEnv ()
static void *	sGetPointer (jobject pointerRef)
static void *	sSetPointer (jobject pointerRef, void *newVal)
static jobject	sNewLocalRef (jobject ref)
static void	sDeleteLocalRef (jobject ref)
static jobject	sNewGlobalRef (jobject ref)
static void	sDeleteGlobalRef (jobject ref)
static jweak	sNewWeakGlobalRef (jobject ref)
static void	sDeleteWeakGlobalRef (jweak ref)
static void	sRegisterInitializationCallback (CallbackFunc func, void *closure)
static void	sRegisterTerminationCallback (CallbackFunc func, void *closure)
static VS_API_FERRY void	shutdownHelper ()

Detailed Description

The JNIHelper object contains a series of methods designed to assist functions when running inside a Java JVM.

There is only one JNIHelper object per shared library loaded.

Definition at line 36 of file JNIHelper.h.

Member Function Documentation

throwOutOfMemoryError()

void com::avpkit::ferry::JNIHelper::throwOutOfMemoryError

(

)

Be VERY careful in this function; it gets call when we're low on memory so you check any allocations of memory, as they are incredibly likely to fail – and will do so on the most inconvenient OS more often than others.

Definition at line 514 of file JNIHelper.cpp.

  {
    JNIEnv *env = this->getEnv();
    if (!env)
      return;
    // exception already pending?
    if (env->ExceptionCheck())
      return;
    jclass cls=0;
 
    // let's set up a singleton out of memory error for potential
    // reuse later
    cls = env->FindClass("java/lang/OutOfMemoryError");
    // couldn't find the class?
    if (cls) {
      int retval = env->ThrowNew(cls, "out of native memory");
      env->DeleteLocalRef(cls);
      if (retval == 0) // success
        return;
    }
      
    if (!mOutOfMemoryErrorSingleton)
      return;
    env->Throw(mOutOfMemoryErrorSingleton);
  }

---

The documentation for this class was generated from the following files:

• csrc/com/avpkit/ferry/JNIHelper.h
• csrc/com/avpkit/ferry/JNIHelper.cpp