org.jikesrvm.classloader

Class RVMClassLoader

java.lang.Object

org.jikesrvm.classloader.RVMClassLoader

public class RVMClassLoader
extends Object

Manufacture type descriptions as needed by the running virtual machine.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static Atom	annotationDefaultAttributeName AnnotationDefault
private static ClassLoader	appCL
private static boolean	appCLReady Is the application class loader ready for use?
private static String	applicationRepositories
private static boolean	assertionsEnabled Are Java 1.4 style assertions enabled?
(package private) static Atom	codeAttributeName Code
(package private) static Atom	constantValueAttributeName ConstantValue
private static boolean	DBG_APP_CL
(package private) static Atom	deprecatedAttributeName Deprecated
private static String[]	disabledAssertionStrings String describing packages and classes to disable assertions on (of the form ":<packagename>...
private static String[]	enabledAssertionStrings String describing packages and classes to enable assertions on (of the form ":<packagename>...
(package private) static Atom	enclosingMethodAttributeName EnclosingMethod
(package private) static Atom	exceptionsAttributeName Exceptions
private static int	gettingAppCL Are we getting the application CL?
(package private) static Atom	innerClassesAttributeName InnerClasses
(package private) static Atom	lineNumberTableAttributeName LineNumberTable
(package private) static Atom	localVariableTableAttributeName LocalVariableTable
(package private) static Atom	runtimeInvisibleAnnotationsAttributeName RuntimeInvisibleAnnotations
(package private) static Atom	runtimeInvisibleParameterAnnotationsAttributeName RuntimeInvisibleParameterAnnotations
(package private) static Atom	runtimeVisibleAnnotationsAttributeName RuntimeVisibleAnnotations
(package private) static Atom	runtimeVisibleParameterAnnotationsAttributeName RuntimeVisibleParameterAnnotations
(package private) static Atom	signatureAttributeName Signature
(package private) static Atom	sourceFileAttributeName SourceFile
static Atom	StandardClassInitializerMethodDescriptor "()V"
static Atom	StandardClassInitializerMethodName <clinit>
static Atom	StandardObjectFinalizerMethodDescriptor ()V
static Atom	StandardObjectFinalizerMethodName finalize
static Atom	StandardObjectInitializerHelperMethodName this
static Atom	StandardObjectInitializerMethodDescriptor ()V
static Atom	StandardObjectInitializerMethodName <init>
(package private) static Atom	syntheticAttributeName Synthetic

Constructor Summary

Constructors

Constructor and Description
RVMClassLoader()

Method Summary

Modifier and Type	Method and Description
static void	boot() Initialize at boot time.
static void	declareApplicationClassLoaderIsReady()
static RVMType	defineClassInternal(String className, byte[] classRep, int offset, int length, ClassLoader classloader)
static RVMType	defineClassInternal(String className, InputStream is, ClassLoader classloader)
static ClassLoader	findWorkableClassloader(Atom clazz) An unpleasant hack to deal with the problem of replaying work when using dynamic classloaders (whose identity will vary from run to run).
static ClassLoader	getApplicationClassLoader()
static String	getApplicationRepositories() Get list of places currently being searched for application classes and resources.
private static TypeReference	getClassTypeRef(DataInputStream input, ClassLoader cl)
(package private) static boolean	getDesiredAssertionStatus(RVMClass klass) Calculate the desired assertion status for a freshly loaded class
static void	init(String bootstrapClasspath) Initialize for boot image writing.
static void	setApplicationRepositories(String classpath) Set list of places to be searched for application classes and resources.
static void	stashApplicationRepositories(String classpath) Set list of places to be searched for application classes and resources.
static void	stashDisableAssertionArg(String arg) Remember the given disable assertions string
static void	stashEnableAssertionArg(String arg) Remember the given enable assertions string

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DBG_APP_CL

private static final boolean DBG_APP_CL

See Also:

Constant Field Values

appCL

private static ClassLoader appCL

assertionsEnabled

private static boolean assertionsEnabled

Are Java 1.4 style assertions enabled?

enabledAssertionStrings

private static String[] enabledAssertionStrings

String describing packages and classes to enable assertions on (of the form ":<packagename>...|:<classname>")

disabledAssertionStrings

private static String[] disabledAssertionStrings

String describing packages and classes to disable assertions on (of the form ":<packagename>...|:<classname>")

gettingAppCL

private static int gettingAppCL

Are we getting the application CL? Access is synchronized via the Class object. Probably not necessary, but doesn't hurt, or shouldn't. Used for sanity checks.

appCLReady

private static boolean appCLReady

Is the application class loader ready for use? Don't leak it out until it is!

applicationRepositories

private static String applicationRepositories

StandardClassInitializerMethodName

public static final Atom StandardClassInitializerMethodName

<clinit>

StandardClassInitializerMethodDescriptor

public static final Atom StandardClassInitializerMethodDescriptor

"()V"

StandardObjectInitializerMethodName

public static final Atom StandardObjectInitializerMethodName

<init>

StandardObjectInitializerMethodDescriptor

public static final Atom StandardObjectInitializerMethodDescriptor

()V

StandardObjectInitializerHelperMethodName

public static final Atom StandardObjectInitializerHelperMethodName

this

StandardObjectFinalizerMethodName

public static final Atom StandardObjectFinalizerMethodName

finalize

StandardObjectFinalizerMethodDescriptor

public static final Atom StandardObjectFinalizerMethodDescriptor

()V

codeAttributeName

static final Atom codeAttributeName

Code

constantValueAttributeName

static final Atom constantValueAttributeName

ConstantValue

lineNumberTableAttributeName

static final Atom lineNumberTableAttributeName

LineNumberTable

exceptionsAttributeName

static final Atom exceptionsAttributeName

Exceptions

sourceFileAttributeName

static final Atom sourceFileAttributeName

SourceFile

localVariableTableAttributeName

static final Atom localVariableTableAttributeName

LocalVariableTable

deprecatedAttributeName

static final Atom deprecatedAttributeName

Deprecated

innerClassesAttributeName

static final Atom innerClassesAttributeName

InnerClasses

syntheticAttributeName

static final Atom syntheticAttributeName

Synthetic

enclosingMethodAttributeName

static final Atom enclosingMethodAttributeName

EnclosingMethod

signatureAttributeName

static final Atom signatureAttributeName

Signature

runtimeVisibleAnnotationsAttributeName

static final Atom runtimeVisibleAnnotationsAttributeName

RuntimeVisibleAnnotations

runtimeInvisibleAnnotationsAttributeName

static final Atom runtimeInvisibleAnnotationsAttributeName

RuntimeInvisibleAnnotations

runtimeVisibleParameterAnnotationsAttributeName

static final Atom runtimeVisibleParameterAnnotationsAttributeName

RuntimeVisibleParameterAnnotations

runtimeInvisibleParameterAnnotationsAttributeName

static final Atom runtimeInvisibleParameterAnnotationsAttributeName

RuntimeInvisibleParameterAnnotations

annotationDefaultAttributeName

static final Atom annotationDefaultAttributeName

AnnotationDefault

Constructor Detail

RVMClassLoader

public RVMClassLoader()

Method Detail

stashApplicationRepositories

public static void stashApplicationRepositories(String classpath)

Set list of places to be searched for application classes and resources. Do NOT set the java.class.path property; it is probably too early in the VM's booting cycle to set properties.

Parameters:

classpath - path specification in standard "classpath" format

stashEnableAssertionArg

public static void stashEnableAssertionArg(String arg)

Remember the given enable assertions string

Parameters:

arg - String of the form ":<packagename>...|:<classname>"

stashDisableAssertionArg

public static void stashDisableAssertionArg(String arg)

Remember the given disable assertions string

Parameters:

arg - String of the form ":<packagename>...|:<classname>"

getDesiredAssertionStatus

static boolean getDesiredAssertionStatus(RVMClass klass)

Calculate the desired assertion status for a freshly loaded class

Parameters:

klass - to check against command line argument

Returns:

whether assertions should be enabled on class

setApplicationRepositories

public static void setApplicationRepositories(String classpath)

Set list of places to be searched for application classes and resources.

Our Jikes RVM classloader can not handle having the class path reset after it's been set up. Unfortunately, it is stashed by classes in GNU Classpath.

Parameters:

classpath - path specification in standard "classpath" format

getApplicationRepositories

public static String getApplicationRepositories()

Get list of places currently being searched for application classes and resources.

Returns:

names of directories, .zip files, and .jar files

declareApplicationClassLoaderIsReady

public static void declareApplicationClassLoaderIsReady()

getApplicationClassLoader

public static ClassLoader getApplicationClassLoader()

boot

public static void boot()

Initialize at boot time.

init

public static void init(String bootstrapClasspath)

Initialize for boot image writing.

Parameters:

bootstrapClasspath - the bootstrap classpath to load the classes from

defineClassInternal

public static RVMType defineClassInternal(String className,
                                          byte[] classRep,
                                          int offset,
                                          int length,
                                          ClassLoader classloader)
                                   throws ClassFormatError

Throws:

ClassFormatError

defineClassInternal

public static RVMType defineClassInternal(String className,
                                          InputStream is,
                                          ClassLoader classloader)
                                   throws ClassFormatError

Throws:

ClassFormatError

getClassTypeRef

private static TypeReference getClassTypeRef(DataInputStream input,
                                             ClassLoader cl)
                                      throws IOException,
                                             ClassFormatError

Throws:

IOException

ClassFormatError

findWorkableClassloader

public static ClassLoader findWorkableClassloader(Atom clazz)

An unpleasant hack to deal with the problem of replaying work when using dynamic classloaders (whose identity will vary from run to run). When we can't find the classloader that was specified, see if there are any other (non-matching) classloaders that have the relevant class loaded.

Parameters:

clazz - The class we're after

Returns:

A usable classloader or null