org.apache.bcel.util

Class SyntheticRepository

Implemented Interfaces:
Repository, java.io.Serializable

public class SyntheticRepository
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().
It is designed to be used as a singleton, however it can also be used with custom classpaths. /** Abstract definition of a class repository. Instances may be used to load classes from different sources and may be used in the Repository.setRepository method.
Version:
$Id: SyntheticRepository.java 386056 2006-03-15 11:31:56Z tcurdt $
Authors:
M. Dahm
David Dixon-Peugh
See Also:
Repository

Field Summary

private static String
DEFAULT_PATH
private static Map
_instances
private Map
_loadedClasses
private ClassPath
_path

Constructor Summary

SyntheticRepository(ClassPath path)

Method Summary

void
clear()
Clear all entries from cache.
JavaClass
findClass(String className)
Find an already defined (cached) JavaClass object by name.
ClassPath
getClassPath()
ClassPath associated with the Repository.
static SyntheticRepository
getInstance()
static SyntheticRepository
getInstance(ClassPath classPath)
JavaClass
loadClass(Class clazz)
Find the JavaClass object for a runtime Class object.
private JavaClass
loadClass(InputStream is, String className)
JavaClass
loadClass(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.

Field Details

DEFAULT_PATH

private static final String DEFAULT_PATH

_instances

private static Map _instances

_loadedClasses

private Map _loadedClasses

_path

private ClassPath _path

Constructor Details

SyntheticRepository

private SyntheticRepository(ClassPath path)

Method Details

clear

public void clear()
Clear all entries from cache.
Specified by:
clear in interface Repository

findClass

public JavaClass findClass(String className)
Find an already defined (cached) JavaClass object by name.
Specified by:
findClass in interface Repository

getClassPath

public ClassPath getClassPath()
ClassPath associated with the Repository.
Specified by:
getClassPath in interface Repository

getInstance

public static SyntheticRepository getInstance()

getInstance

public static SyntheticRepository getInstance(ClassPath classPath)

loadClass

public JavaClass loadClass(Class clazz)
            throws 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
See Also:
Class

loadClass

private JavaClass loadClass(InputStream is,
                            String className)
            throws ClassNotFoundException

loadClass

public JavaClass loadClass(String className)
            throws 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

removeClass

public void removeClass(JavaClass clazz)
Remove class from repository
Specified by:
removeClass in interface Repository

storeClass

public void storeClass(JavaClass clazz)
Store a new JavaClass instance into this Repository.
Specified by:
storeClass in interface Repository