org.apache.bcel.util

Class MemorySensitiveClassPathRepository

java.lang.Object

org.apache.bcel.util.MemorySensitiveClassPathRepository

All Implemented Interfaces:

Repository

Direct Known Subclasses:

SyntheticRepository

public class MemorySensitiveClassPathRepository
extends java.lang.Object
implements Repository

This repository is used in situations where a Class is created outside the realm of a ClassLoader. Classes are loaded from the file systems using the paths specified in the given class path. By default, this is the value returned by ClassPath.getClassPath(). This repository holds onto classes with SoftReferences, and will reload as needed, in cases where memory sizes are important.

See Also:

Repository

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<java.lang.String,java.lang.ref.SoftReference<JavaClass>>	_loadedClasses
private ClassPath	_path

Constructor Summary

Constructors

Constructor and Description
MemorySensitiveClassPathRepository(ClassPath path)

Method Summary

Modifier and Type	Method and Description
void	clear() Clear all entries from cache.
JavaClass	findClass(java.lang.String className) Find an already defined (cached) JavaClass object by name.
ClassPath	getClassPath() ClassPath associated with the Repository.
JavaClass	loadClass(java.lang.Class<?> clazz) Find the JavaClass object for a runtime Class object.
private JavaClass	loadClass(java.io.InputStream is, java.lang.String className)
JavaClass	loadClass(java.lang.String className) Find a JavaClass object by name.
void	removeClass(JavaClass clazz) Remove class from repository
void	storeClass(JavaClass clazz) Store a new JavaClass instance into this Repository.

Methods inherited from class java.lang.Object

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

Field Detail

_path

private ClassPath _path

_loadedClasses

private final java.util.Map<java.lang.String,java.lang.ref.SoftReference<JavaClass>> _loadedClasses

Constructor Detail

MemorySensitiveClassPathRepository

public MemorySensitiveClassPathRepository(ClassPath path)

Method Detail

storeClass

public void storeClass(JavaClass clazz)

Store a new JavaClass instance into this Repository.

Specified by:

storeClass in interface Repository

removeClass

public void removeClass(JavaClass clazz)

Remove class from repository

Specified by:

removeClass in interface Repository

findClass

public JavaClass findClass(java.lang.String className)

Find an already defined (cached) JavaClass object by name.

Specified by:

findClass in interface Repository

loadClass

public JavaClass loadClass(java.lang.String className)
                    throws java.lang.ClassNotFoundException

Find a JavaClass object by name. If it is already in this Repository, the Repository version is returned. Otherwise, the Repository's classpath is searched for the class (and it is added to the Repository if found).

Specified by:

loadClass in interface Repository

Parameters:

className - the name of the class

Returns:

the JavaClass object

Throws:

java.lang.ClassNotFoundException - if the class is not in the Repository, and could not be found on the classpath

loadClass

public JavaClass loadClass(java.lang.Class<?> clazz)
                    throws java.lang.ClassNotFoundException

Find the JavaClass object for a runtime Class object. If a class with the same name is already in this Repository, the Repository version is returned. Otherwise, getResourceAsStream() is called on the Class object to find the class's representation. If the representation is found, it is added to the Repository.

Specified by:

loadClass in interface Repository

Parameters:

clazz - the runtime Class object

Returns:

JavaClass object for given runtime class

Throws:

java.lang.ClassNotFoundException - if the class is not in the Repository, and its representation could not be found

See Also:

Class

loadClass

private JavaClass loadClass(java.io.InputStream is,
                            java.lang.String className)
                     throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

getClassPath

public ClassPath getClassPath()

ClassPath associated with the Repository.

Specified by:

getClassPath in interface Repository

clear

public void clear()

Clear all entries from cache.

Specified by:

clear in interface Repository