IKVM.Runtime.RuntimeClassLoader Class Reference

Runtime support for a class loader. More...

Inheritance diagram for IKVM.Runtime.RuntimeClassLoader:

Public Member Functions
override string	ToString ()

Protected Member Functions
virtual RuntimeJavaType	FindLoadedClassLazy (string name)
virtual void	CheckProhibitedPackage (string className)
virtual RuntimeJavaType	LoadClassImpl (string name, LoadMode mode)

Protected Attributes
java.lang.ClassLoader	javaClassLoader

Properties
virtual IDiagnosticHandler	Diagnostics [get]
	Gets the IDiagnosticHandler events originated by this class loader should be sent to.
RuntimeContext	Context [get]
	Gets a reference to the RuntimeContext that this RuntimeClassLoader is hosted within.

Detailed Description

Runtime support for a class loader.

Definition at line 60 of file RuntimeClassLoader.cs.

Member Function Documentation

CheckProhibitedPackage()

virtual void IKVM.Runtime.RuntimeClassLoader.CheckProhibitedPackage ( string className )

protectedvirtual

Reimplemented in IKVM.Runtime.BootstrapClassLoader, and IKVM.Tools.Importer.ImportClassLoader.

Definition at line 244 of file RuntimeClassLoader.cs.

        {
            if (className.StartsWith("java.", StringComparison.Ordinal))
                throw new JavaSecurityException("Prohibited package name: " + className.Substring(0, className.LastIndexOf('.')));
        }

FindLoadedClassLazy()

virtual RuntimeJavaType IKVM.Runtime.RuntimeClassLoader.FindLoadedClassLazy ( string name )

protectedvirtual

Reimplemented in IKVM.Runtime.RuntimeGenericClassLoader.

Definition at line 136 of file RuntimeClassLoader.cs.

        {
            return null;
        }

LoadClassImpl()

virtual RuntimeJavaType IKVM.Runtime.RuntimeClassLoader.LoadClassImpl ( string name, LoadMode mode )

protectedvirtual

Reimplemented in IKVM.Tools.Importer.ImportClassLoader.

Definition at line 630 of file RuntimeClassLoader.cs.

        {
            var javaType = FindOrLoadGenericClass(name, mode);
            if (javaType != null)
                return javaType;
 
#if !FIRST_PASS && !IMPORTER && !EXPORTER
 
            if ((mode & LoadMode.Load) == 0)
                return null;
 
            Profiler.Enter("ClassLoader.loadClass");
 
            try
            {
                // invoke 'loadClass' on the associated Java class loader instance
                // this can cause a call to defineClass
                var c = (java.lang.Class)ClassLoaderAccessor.InvokeLoadClassInternal(GetJavaClassLoader(), name);
                if (c == null)
                    return null;
 
                // map resulting reflective instance back into Java type
                var type = RuntimeJavaType.FromClass(c);
                if (type.Name != name)
                    return null;
 
                return type;
            }
            catch (java.lang.ClassNotFoundException x)
            {
                if ((mode & LoadMode.MaskReturn) == LoadMode.ThrowClassNotFound)
                    throw new ClassLoadingException(ikvm.runtime.Util.mapException(x), name);
 
                return null;
            }
            catch (global::java.lang.ThreadDeath)
            {
                throw;
            }
            catch (Exception x)
            {
                if ((mode & LoadMode.SuppressExceptions) == 0)
                    throw new ClassLoadingException(ikvm.runtime.Util.mapException(x), name);
 
                if (Diagnostics.IsEnabled(Diagnostic.GenericClassLoadingError))
                {
                    var cl = GetJavaClassLoader();
                    if (cl != null)
                    {
                        var sb = new ValueStringBuilder();
                        var sep = "";
                        while (cl != null)
                        {
                            sb.Append(sep);
                            sb.Append(cl.ToString());
                            sep = " -> ";
                            cl = cl.getParent();
                        }
 
                        Diagnostics.GenericClassLoadingError($"ClassLoader chain: {sb.ToString()}");
                    }
 
                    var m = ikvm.runtime.Util.mapException(x);
                    Diagnostics.GenericClassLoadingError(m.ToString() + Environment.NewLine + m.StackTrace);
                }
 
                return null;
            }
            finally
            {
                Profiler.Leave("ClassLoader.loadClass");
            }
#else
            return null;
#endif
        }

ToString()

override string IKVM.Runtime.RuntimeClassLoader.ToString

(

)

Definition at line 909 of file RuntimeClassLoader.cs.

        {
            var javaClassLoader = GetJavaClassLoader();
            if (javaClassLoader == null)
                return "null";
            else
                return string.Format("{0}@{1:X}", Context.ClassLoaderFactory.GetJavaTypeFromType(javaClassLoader.GetType()).Name, javaClassLoader.GetHashCode());
        }

Member Data Documentation

javaClassLoader

java.lang.ClassLoader IKVM.Runtime.RuntimeClassLoader.javaClassLoader

protected

Definition at line 70 of file RuntimeClassLoader.cs.

Property Documentation

Context

RuntimeContext IKVM.Runtime.RuntimeClassLoader.Context

get

Gets a reference to the RuntimeContext that this RuntimeClassLoader is hosted within.

Definition at line 120 of file RuntimeClassLoader.cs.

Diagnostics

virtual IDiagnosticHandler IKVM.Runtime.RuntimeClassLoader.Diagnostics

get

Gets the IDiagnosticHandler events originated by this class loader should be sent to.

Definition at line 100 of file RuntimeClassLoader.cs.

---

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

• src/IKVM.Runtime/RuntimeClassLoader.cs