org.apache.bcel.util

Class SyntheticRepository

public class SyntheticRepository extends 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.

See Also:

Method Summary
voidclear()
Clear all entries from cache.
JavaClassfindClass(String className)
Find an already defined (cached) JavaClass object by name.
ClassPathgetClassPath()
ClassPath associated with the Repository.
static SyntheticRepositorygetInstance()
static SyntheticRepositorygetInstance(ClassPath classPath)
JavaClassloadClass(String className)
Find a JavaClass object by name.
JavaClassloadClass(Class clazz)
Find the JavaClass object for a runtime Class object.
voidremoveClass(JavaClass clazz)
Remove class from repository
voidstoreClass(JavaClass clazz)
Store a new JavaClass instance into this Repository.

Method Detail

clear

public void clear()
Clear all entries from cache.

findClass

public JavaClass findClass(String className)
Find an already defined (cached) JavaClass object by name.

getClassPath

public ClassPath getClassPath()
ClassPath associated with the Repository.

getInstance

public static SyntheticRepository getInstance()

getInstance

public static SyntheticRepository getInstance(ClassPath classPath)

loadClass

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

Parameters: className the name of the class

Returns: the JavaClass object

Throws: ClassNotFoundException if the class is not in the Repository, and could not be found on the classpath

loadClass

public JavaClass loadClass(Class clazz)
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.

Parameters: clazz the runtime Class object

Returns: JavaClass object for given runtime class

Throws: ClassNotFoundException if the class is not in the Repository, and its representation could not be found

See Also: Class

removeClass

public void removeClass(JavaClass clazz)
Remove class from repository

storeClass

public void storeClass(JavaClass clazz)
Store a new JavaClass instance into this Repository.