com.ibm.wala.classLoader

Class ClassLoaderImpl

java.lang.Object

com.ibm.wala.classLoader.ClassLoaderImpl

All Implemented Interfaces:

IClassLoader

public class ClassLoaderImpl
extends java.lang.Object
implements IClassLoader

A class loader that reads class definitions from a set of Modules.

Field Summary

Fields

Modifier and Type	Field and Description
protected IClassHierarchy	cha Governing class hierarchy
static int	DEBUG_LEVEL
protected java.util.Map<TypeName,IClass>	loadedClasses A mapping from class name (TypeName) to IClass

Constructor Summary

Constructors

Constructor and Description
ClassLoaderImpl(ClassLoaderReference loader, ArrayClassLoader arrayClassLoader, IClassLoader parent, com.ibm.wala.util.config.SetOfClasses exclusions, IClassHierarchy cha)

Method Summary

Modifier and Type	Method and Description
SSAInstructionFactory	getInstructionFactory()
Language	getLanguage()
Atom	getName()
int	getNumberOfClasses()
int	getNumberOfMethods()
IClassLoader	getParent() Method getParent.
ClassLoaderReference	getReference() Return the ClassLoaderReference for this class loader.
java.io.Reader	getSource(IClass klass)
java.io.Reader	getSource(IMethod method, int offset)
java.lang.String	getSourceFileName(IClass klass)
java.lang.String	getSourceFileName(IMethod method, int offset)
void	init(java.util.List<Module> modules) Initialize internal data structures
java.util.Iterator<IClass>	iterateAllClasses()
protected void	loadAllSources(java.util.Set<ModuleEntry> sourceModules) Set up mapping from type name to Module Entry
IClass	lookupClass(TypeName className) Find and return the IClass defined by this class loader that corresponds to the given class name.
void	removeAll(java.util.Collection<IClass> toRemove) blow away references to any classes in the set
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG_LEVEL

public static final int DEBUG_LEVEL

See Also:

Constant Field Values

loadedClasses

protected final java.util.Map<TypeName,IClass> loadedClasses

A mapping from class name (TypeName) to IClass

cha

protected final IClassHierarchy cha

Governing class hierarchy

Constructor Detail

ClassLoaderImpl

public ClassLoaderImpl(ClassLoaderReference loader,
                       ArrayClassLoader arrayClassLoader,
                       IClassLoader parent,
                       com.ibm.wala.util.config.SetOfClasses exclusions,
                       IClassHierarchy cha)

Parameters:

loader - class loader reference identifying this loader

parent - parent loader for delegation

exclusions - set of classes to exclude from loading

Method Detail

loadAllSources

protected void loadAllSources(java.util.Set<ModuleEntry> sourceModules)

Set up mapping from type name to Module Entry

init

public void init(java.util.List<Module> modules)
          throws java.io.IOException

Initialize internal data structures

Specified by:

init in interface IClassLoader

Throws:

java.lang.IllegalArgumentException - if modules is null

java.io.IOException

getReference

public ClassLoaderReference getReference()

Description copied from interface: IClassLoader

Return the ClassLoaderReference for this class loader.

Specified by:

getReference in interface IClassLoader

Returns:

ClassLoaderReference

iterateAllClasses

public java.util.Iterator<IClass> iterateAllClasses()

Specified by:

iterateAllClasses in interface IClassLoader

Returns:

an Iterator of all classes loaded by this loader

lookupClass

public IClass lookupClass(TypeName className)

Description copied from interface: IClassLoader

Find and return the IClass defined by this class loader that corresponds to the given class name.

Specified by:

lookupClass in interface IClassLoader

Parameters:

className - name of the class

Returns:

the IClass defined by this class loader that corresponds to the given class name, or null if not found.

getParent

public IClassLoader getParent()

Method getParent.

Specified by:

getParent in interface IClassLoader

Returns:

the parent IClassLoader, if any, or null

getName

public Atom getName()

Specified by:

getName in interface IClassLoader

Returns:

the unique name that identifies this class loader.

getLanguage

public Language getLanguage()

Specified by:

getLanguage in interface IClassLoader

Returns:

the unique name that identifies the programming language from which this class loader loads code.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getNumberOfClasses

public int getNumberOfClasses()

Specified by:

getNumberOfClasses in interface IClassLoader

Returns:

the number of classes in scope to be loaded by this loader

getNumberOfMethods

public int getNumberOfMethods()

Specified by:

getNumberOfMethods in interface IClassLoader

getSourceFileName

public java.lang.String getSourceFileName(IClass klass)

Specified by:

getSourceFileName in interface IClassLoader

Parameters:

klass - the class for which information is desired.

Returns:

name of source file corresponding to the class, or null if not available

getSource

public java.io.Reader getSource(IMethod method,
                                int offset)

Specified by:

getSource in interface IClassLoader

Parameters:

method - The method for which information is desired

offset - an offset into the bytecode of the given method.

Returns:

input stream representing the source file for a given bytecode index of a given method, or null if not available

getSourceFileName

public java.lang.String getSourceFileName(IMethod method,
                                          int offset)

Specified by:

getSourceFileName in interface IClassLoader

Parameters:

method - The method for which information is desired

offset - an offset into the bytecode of the given method.

Returns:

name of the source file corresponding to the given offset in the given method. Note that this api allows a single method to arise from multiple source files, which is deliberate as it can happen in some languages.

getSource

public java.io.Reader getSource(IClass klass)

Specified by:

getSource in interface IClassLoader

Returns:

input stream representing the source file for a class, or null if not available

removeAll

public void removeAll(java.util.Collection<IClass> toRemove)

Description copied from interface: IClassLoader

blow away references to any classes in the set

Specified by:

removeAll in interface IClassLoader

Parameters:

toRemove - Collection<IClass>

getInstructionFactory

public SSAInstructionFactory getInstructionFactory()

Specified by:

getInstructionFactory in interface IClassLoader