IKVM.Runtime.JNI.JNIEnv Struct Reference

Classes
struct	JNINativeMethod

Public Member Functions
void *	PinObject (object obj)
void	UnpinObject (object obj)

Static Public Member Functions
static RuntimeClassLoader	FindNativeMethodClassLoader (JNIEnv *pEnv)
static nint	AllocObjectImpl (JNIEnv *pEnv, RuntimeJavaType wrapper)
static object	InvokeHelper (JNIEnv *pEnv, nint objHandle, nint methodID, JValue *pArgs, bool nonVirtual)
	Invokes the given method, by ID, on the given object handle. Accepts a pointer to a JValue array of arguments.
static object	InvokeNonVirtual (JNIEnvContext env, RuntimeJavaMethod mw, object obj, object[] argarray)
	Invokes the given non-virtual method, by ID, on the given object handle. Accepts a pointer to a JValue array of arguments.
static nint	NewObjectA (JNIEnv *pEnv, nint clazz, nint methodID, JValue *args)
static RuntimeJavaMethod	GetMethodImpl (RuntimeJavaType tw, string name, string sig)
static void	AppendInterfaces (List< RuntimeJavaType > list, IList< RuntimeJavaType > add)
static List< RuntimeJavaType >	TransitiveInterfaces (RuntimeJavaType tw)
static RuntimeJavaMethod	GetInterfaceMethodImpl (RuntimeJavaType tw, string name, string sig)
static nint	FindMethodID (JNIEnv *pEnv, nint clazz, byte *name, byte *sig, bool isStatic)
static RuntimeJavaField	GetFieldImpl (RuntimeJavaType tw, string name, string sig)
static nint	FindFieldID (JNIEnv *pEnv, nint clazz, byte *name, byte *sig, bool isStatic)
static RuntimeJavaField	GetFieldWrapper (nint cookie)
static bool	IsLocalRef (nint o)
static bool	IsGlobalRef (nint o)

Static Public Attributes
static readonly MUTF8Encoding	MUTF8 = MUTF8Encoding.GetMUTF8(52)

Detailed Description

Definition at line 53 of file JNIEnv.cs.

Member Function Documentation

AllocObjectImpl()

static nint IKVM.Runtime.JNI.JNIEnv.AllocObjectImpl ( JNIEnv * pEnv, RuntimeJavaType wrapper )

static

Definition at line 622 of file JNIEnv.cs.

        {
            try
            {
                if (wrapper.IsAbstract)
                    throw new java.lang.InstantiationException(wrapper.Name);
 
                wrapper.Finish();
#if NETFRAMEWORK
                return pEnv->MakeLocalRef(FormatterServices.GetUninitializedObject(wrapper.TypeAsBaseType));
#else
                return pEnv->MakeLocalRef(RuntimeHelpers.GetUninitializedObject(wrapper.TypeAsBaseType));
#endif
            }
            catch (RetargetableJavaException e)
            {
                ExceptionDispatchInfo.Capture(e.ToJava()).Throw();
                throw null;
            }
        }

AppendInterfaces()

static void IKVM.Runtime.JNI.JNIEnv.AppendInterfaces ( List< RuntimeJavaType > list, IList< RuntimeJavaType > add )

static

Definition at line 826 of file JNIEnv.cs.

        {
            foreach (var iface in add)
                if (list.Contains(iface) == false)
                    list.Add(iface);
        }

FindFieldID()

static nint IKVM.Runtime.JNI.JNIEnv.FindFieldID ( JNIEnv * pEnv, nint clazz, byte * name, byte * sig, bool isStatic )

static

Definition at line 1249 of file JNIEnv.cs.

        {
            try
            {
                var n = DecodeMUTF8Argument(name, nameof(name));
                var s = DecodeMUTF8Argument(sig, nameof(sig));
 
                var tw = RuntimeJavaType.FromClass((java.lang.Class)pEnv->UnwrapRef(clazz));
                tw.Finish();
 
                // don't allow dotted names!
                if (s.IndexOf('.') < 0)
                {
                    var fw = GetFieldImpl(tw, n, s.Replace('/', '.'));
                    if (fw != null)
                        if (fw.IsStatic == isStatic)
                            return fw.Cookie;
                }
 
                throw new java.lang.NoSuchFieldError($"{(isStatic ? "Static" : "Instance")} field '{n}' with signature '{s}' not found in class '{tw.Name}'");
            }
            catch (RetargetableJavaException x)
            {
                ExceptionDispatchInfo.Capture(x.ToJava()).Throw();
                throw null;
            }
        }

FindMethodID()

static nint IKVM.Runtime.JNI.JNIEnv.FindMethodID ( JNIEnv * pEnv, nint clazz, byte * name, byte * sig, bool isStatic )

static

Definition at line 863 of file JNIEnv.cs.

        {
            try
            {
                var tw = RuntimeJavaType.FromClass((java.lang.Class)pEnv->UnwrapRef(clazz));
                tw.Finish();
 
                // if name == NULL, the JDK returns the constructor
                var methodname = (IntPtr)name == IntPtr.Zero ? "<init>" : DecodeMUTF8Argument(name, nameof(name));
                var methodsig = DecodeMUTF8Argument(sig, nameof(sig));
 
                RuntimeJavaMethod mw = null;
 
                // don't allow dotted names!
                if (methodsig.IndexOf('.') < 0)
                {
                    methodsig = methodsig.Replace('/', '.');
                    if (methodname == "<init>" || methodname == "<clinit>")
                        mw = tw.GetMethod(methodname, methodsig, false);
                    else
                        mw = GetMethodImpl(tw, methodname, methodsig) ?? GetInterfaceMethodImpl(tw, methodname, methodsig);
                }
                if (mw != null && mw.IsStatic == isStatic)
                {
                    mw.Link();
                    return mw.Cookie;
                }
 
                throw new java.lang.NoSuchMethodError($"{methodname}{methodsig}");
            }
            catch (RetargetableJavaException e)
            {
                ExceptionDispatchInfo.Capture(e.ToJava()).Throw();
                throw null;
            }
        }

FindNativeMethodClassLoader()

static RuntimeClassLoader IKVM.Runtime.JNI.JNIEnv.FindNativeMethodClassLoader ( JNIEnv * pEnv )

static

Definition at line 196 of file JNIEnv.cs.

        {
            var env = pEnv->GetContext();
            if (env.callerID != null)
                return RuntimeClassLoader.FromCallerID(env.callerID);
            else if (env.classLoader != null)
                return env.classLoader;
            else
                return env.context.ClassLoaderFactory.GetClassLoaderWrapper(java.lang.ClassLoader.getSystemClassLoader());
        }

GetFieldImpl()

static RuntimeJavaField IKVM.Runtime.JNI.JNIEnv.GetFieldImpl ( RuntimeJavaType tw, string name, string sig )

static

Definition at line 1235 of file JNIEnv.cs.

        {
            for (; ; )
            {
                var fw = tw.GetFieldWrapper(name, sig);
                if (fw == null || !fw.IsHideFromReflection)
                    return fw;
 
                tw = fw.DeclaringType.BaseTypeWrapper;
                if (tw == null)
                    return null;
            }
        }

GetFieldWrapper()

static RuntimeJavaField IKVM.Runtime.JNI.JNIEnv.GetFieldWrapper ( nint cookie )

static

Definition at line 1290 of file JNIEnv.cs.

        {
            return RuntimeJavaField.FromCookie(cookie);
        }

GetInterfaceMethodImpl()

static RuntimeJavaMethod IKVM.Runtime.JNI.JNIEnv.GetInterfaceMethodImpl ( RuntimeJavaType tw, string name, string sig )

static

Definition at line 851 of file JNIEnv.cs.

        {
            foreach (var iface in TransitiveInterfaces(tw))
            {
                var mw = iface.GetMethod(name, sig, false);
                if (mw != null && !mw.IsHideFromReflection)
                    return mw;
            }
 
            return null;
        }

GetMethodImpl()

static RuntimeJavaMethod IKVM.Runtime.JNI.JNIEnv.GetMethodImpl ( RuntimeJavaType tw, string name, string sig )

static

Definition at line 812 of file JNIEnv.cs.

        {
            for (; ; )
            {
                var mw = tw.GetMethod(name, sig, true);
                if (mw == null || !mw.IsHideFromReflection)
                    return mw;
 
                tw = mw.DeclaringType.BaseTypeWrapper;
                if (tw == null)
                    return null;
            }
        }

InvokeHelper()

static object IKVM.Runtime.JNI.JNIEnv.InvokeHelper ( JNIEnv * pEnv, nint objHandle, nint methodID, JValue * pArgs, bool nonVirtual )

static

Invokes the given method, by ID, on the given object handle. Accepts a pointer to a JValue array of arguments.

Parameters

pEnv
objHandle
methodID
pArgs
nonVirtual

Returns

Definition at line 652 of file JNIEnv.cs.

        {
            // resolve object who's method is being invoked
            var env = pEnv->GetContext();
            var obj = UnwrapRef(env, objHandle);
 
            // resolve the method being invoked on the object
            var mw = RuntimeJavaMethod.FromCookie(methodID);
            mw.Link();
            mw.ResolveMethod();
 
            // assemble arguments into array
            var argTypes = mw.GetParameters();
            var args = new object[argTypes.Length + (mw.HasCallerID ? 1 : 0)];
            for (int i = 0; i < argTypes.Length; i++)
            {
                var type = argTypes[i];
                if (type == env.context.PrimitiveJavaTypeFactory.BOOLEAN)
                    args[i] = pArgs[i].z != JNI_FALSE;
                else if (type == env.context.PrimitiveJavaTypeFactory.BYTE)
                    args[i] = (byte)pArgs[i].b;
                else if (type == env.context.PrimitiveJavaTypeFactory.CHAR)
                    args[i] = (char)pArgs[i].c;
                else if (type == env.context.PrimitiveJavaTypeFactory.SHORT)
                    args[i] = pArgs[i].s;
                else if (type == env.context.PrimitiveJavaTypeFactory.INT)
                    args[i] = pArgs[i].i;
                else if (type == env.context.PrimitiveJavaTypeFactory.LONG)
                    args[i] = pArgs[i].j;
                else if (type == env.context.PrimitiveJavaTypeFactory.FLOAT)
                    args[i] = pArgs[i].f;
                else if (type == env.context.PrimitiveJavaTypeFactory.DOUBLE)
                    args[i] = pArgs[i].d;
                else
                    args[i] = argTypes[i].GhostWrap(UnwrapRef(env, pArgs[i].l));
            }
 
            // method requires caller
            if (mw.HasCallerID)
                args[args.Length - 1] = env.callerID;
 
            if (nonVirtual && mw.RequiresNonVirtualDispatcher)
                return InvokeNonVirtual(env, mw, obj, args);
 
            if (mw.IsConstructor)
            {
                if (obj == null)
                {
                    return mw.CreateInstance(args);
                }
                else
                {
                    var mb = mw.GetMethod();
                    if (mb.IsStatic)
                    {
                        // we're dealing with a constructor on a remapped type, if obj is supplied, it means
                        // that we should call the constructor on an already existing instance, but that isn't
                        // possible with remapped types
                        throw new NotSupportedException($"Remapped type {mw.DeclaringType.Name} doesn't support constructor invocation on an existing instance");
                    }
                    else if (!mb.DeclaringType.IsInstanceOfType(obj))
                    {
                        // we're trying to initialize an existing instance of a remapped type
                        throw new NotSupportedException($"Unable to partially construct object of type {obj.GetType().FullName} to type {mb.DeclaringType.FullName}");
                    }
                }
            }
 
            return mw.Invoke(obj, args);
        }

InvokeNonVirtual()

static object IKVM.Runtime.JNI.JNIEnv.InvokeNonVirtual ( JNIEnvContext env, RuntimeJavaMethod mw, object obj, object[] argarray )

static

Invokes the given non-virtual method, by ID, on the given object handle. Accepts a pointer to a JValue array of arguments.

Parameters

env
mw
obj
argarray

Returns

Exceptions

NotSupportedException

Definition at line 732 of file JNIEnv.cs.

        {
            if (mw.HasCallerID || mw.IsDynamicOnly)
                throw new NotSupportedException();
 
            if (mw.DeclaringType.IsRemapped && !mw.DeclaringType.TypeAsBaseType.IsInstanceOfType(obj))
                return mw.InvokeNonvirtualRemapped(obj, argarray);
 
            var del = (Delegate)Activator.CreateInstance(mw.GetDelegateType(), new object[] { obj, mw.GetMethod().MethodHandle.GetFunctionPointer() });
            try
            {
                return del.DynamicInvoke(argarray);
            }
            catch (TargetInvocationException e)
            {
                ExceptionDispatchInfo.Capture(ikvm.runtime.Util.mapException(e.InnerException)).Throw();
                throw null;
            }
        }

IsGlobalRef()

static bool IKVM.Runtime.JNI.JNIEnv.IsGlobalRef ( nint o )

static

Definition at line 3146 of file JNIEnv.cs.

        {
            return o < 0;
        }

IsLocalRef()

static bool IKVM.Runtime.JNI.JNIEnv.IsLocalRef ( nint o )

static

Definition at line 3141 of file JNIEnv.cs.

        {
            return o > 0;
        }

NewObjectA()

static nint IKVM.Runtime.JNI.JNIEnv.NewObjectA ( JNIEnv * pEnv, nint clazz, nint methodID, JValue * args )

static

Definition at line 752 of file JNIEnv.cs.

        {
            try
            {
                var wrapper = RuntimeJavaType.FromClass((java.lang.Class)pEnv->UnwrapRef(clazz));
                if (wrapper.IsAbstract == false && wrapper.TypeAsBaseType.IsAbstract)
                    return pEnv->MakeLocalRef(InvokeHelper(pEnv, IntPtr.Zero, methodID, args, false)); // static newinstance helper method
 
                var obj = AllocObjectImpl(pEnv, wrapper);
                if (obj != IntPtr.Zero)
                {
                    InvokeHelper(pEnv, obj, methodID, args, false);
 
                    if (ExceptionCheck(pEnv) == JNI_TRUE)
                    {
                        DeleteLocalRef(pEnv, obj);
                        obj = IntPtr.Zero;
                    }
                }
 
                return obj;
            }
            catch (Exception e)
            {
                JVM.SetPendingException(e);
                return 0;
            }
        }

PinObject()

void * IKVM.Runtime.JNI.JNIEnv.PinObject

(

object

obj

)

Definition at line 2939 of file JNIEnv.cs.

        {
            if (pinHandleInUseCount == pinHandleMaxCount)
            {
                var newCount = pinHandleMaxCount + 32;
                var pNew = (GCHandle*)JNIMemory.Alloc(sizeof(GCHandle) * newCount);
                for (int i = 0; i < pinHandleMaxCount; i++)
                    pNew[i] = pinHandles[i];
 
                for (int i = pinHandleMaxCount; i < newCount; i++)
                    pNew[i] = new GCHandle();
 
                JNIMemory.Free((nint)pinHandles);
                pinHandles = pNew;
                pinHandleMaxCount = newCount;
            }
 
            var index = pinHandleInUseCount++;
            if (pinHandles[index].IsAllocated == false)
                pinHandles[index] = GCHandle.Alloc(null, GCHandleType.Pinned);
 
            pinHandles[index].Target = obj;
            return (void*)pinHandles[index].AddrOfPinnedObject();
        }

TransitiveInterfaces()

static List< RuntimeJavaType > IKVM.Runtime.JNI.JNIEnv.TransitiveInterfaces ( RuntimeJavaType tw )

static

Definition at line 833 of file JNIEnv.cs.

        {
            var list = new List<RuntimeJavaType>();
 
            // append interfaces from base type
            if (tw.BaseTypeWrapper != null)
                AppendInterfaces(list, TransitiveInterfaces(tw.BaseTypeWrapper));
 
            // append transitive interfaces of current type
            foreach (RuntimeJavaType iface in tw.Interfaces)
                AppendInterfaces(list, TransitiveInterfaces(iface));
 
            // append interfaces of current type
            AppendInterfaces(list, tw.Interfaces);
 
            return list;
        }

UnpinObject()

void IKVM.Runtime.JNI.JNIEnv.UnpinObject

(

object

obj

)

Definition at line 2964 of file JNIEnv.cs.

        {
            for (int i = 0; i < pinHandleInUseCount; i++)
            {
                if (pinHandles[i].Target == obj)
                {
                    pinHandles[i].Target = pinHandles[--pinHandleInUseCount].Target;
                    pinHandles[pinHandleInUseCount].Target = null;
                    return;
                }
            }
        }

Member Data Documentation

MUTF8

readonly MUTF8Encoding IKVM.Runtime.JNI.JNIEnv.MUTF8 = MUTF8Encoding.GetMUTF8(52)

static

Definition at line 76 of file JNIEnv.cs.

---

The documentation for this struct was generated from the following file:

• src/IKVM.Runtime/JNI/JNIEnv.cs