soot

Class SourceLocator

java.lang.Object

soot.SourceLocator

public class SourceLocator
extends java.lang.Object

Provides utility methods to retrieve an input stream for a class name, given a classfile, or jimple or baf output files.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SourceLocator.FoundFile

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Set<java.lang.ClassLoader>	additionalClassLoaders
protected java.util.Set<java.lang.String>	classesToLoad
static java.lang.String	DUMMY_CLASSPATH_JDK9_FS

Constructor Summary

Constructors

Constructor and Description
SourceLocator(Singletons.Global g)

Method Summary

Modifier and Type	Method and Description
void	additionalClassLoader(java.lang.ClassLoader c)
void	addToSourceToClassMap(java.lang.String key, java.lang.String val)
java.util.Set<java.lang.String>	classesInDynamicPackage(java.lang.String str)
java.util.List<java.lang.String>	classPath()
protected java.util.List<java.lang.String>	explodeClassPath(java.lang.String classPath) Explodes a class path into a list of individual class path entries.
java.util.List<java.lang.String>	getClassesUnder(java.lang.String aPath)
ClassSource	getClassSource(java.lang.String className) Given a class name, uses the soot-class-path to return a ClassSource for the given class.
java.lang.String	getExtensionFor(int rep)
java.lang.String	getFileNameFor(SootClass c, int rep)
java.lang.String	getOutputDir()
java.lang.String	getSourceForClass(java.lang.String className) Returns the name of the class in which the (possibly inner) class className appears.
java.util.HashMap<java.lang.String,java.lang.String>	getSourceToClassMap()
void	invalidateClassPath()
SourceLocator.FoundFile	lookupInClassPath(java.lang.String fileName) Searches for a file with the given name in the exploded classPath.
SourceLocator.FoundFile	lookUpInVirtualFileSystem(java.lang.String archivePath, java.lang.String fileName) Looks up classes in Java 9's virtual filesystem jrt:/
void	setClassProviders(java.util.List<ClassProvider> classProviders)
void	setSourceToClassMap(java.util.HashMap<java.lang.String,java.lang.String> map)
java.util.List<java.lang.String>	sourcePath()
static SourceLocator	v()

Methods inherited from class java.lang.Object

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

Field Detail

DUMMY_CLASSPATH_JDK9_FS

public static final java.lang.String DUMMY_CLASSPATH_JDK9_FS

See Also:

Constant Field Values

additionalClassLoaders

protected java.util.Set<java.lang.ClassLoader> additionalClassLoaders

classesToLoad

protected java.util.Set<java.lang.String> classesToLoad

Constructor Detail

SourceLocator

public SourceLocator(Singletons.Global g)

Method Detail

v

public static SourceLocator v()

getClassSource

public ClassSource getClassSource(java.lang.String className)

Given a class name, uses the soot-class-path to return a ClassSource for the given class.

additionalClassLoader

public void additionalClassLoader(java.lang.ClassLoader c)

setClassProviders

public void setClassProviders(java.util.List<ClassProvider> classProviders)

classPath

public java.util.List<java.lang.String> classPath()

invalidateClassPath

public void invalidateClassPath()

sourcePath

public java.util.List<java.lang.String> sourcePath()

getClassesUnder

public java.util.List<java.lang.String> getClassesUnder(java.lang.String aPath)

getFileNameFor

public java.lang.String getFileNameFor(SootClass c,
                                       int rep)

classesInDynamicPackage

public java.util.Set<java.lang.String> classesInDynamicPackage(java.lang.String str)

getExtensionFor

public java.lang.String getExtensionFor(int rep)

getOutputDir

public java.lang.String getOutputDir()

explodeClassPath

protected java.util.List<java.lang.String> explodeClassPath(java.lang.String classPath)

Explodes a class path into a list of individual class path entries.

lookupInClassPath

public SourceLocator.FoundFile lookupInClassPath(java.lang.String fileName)

Searches for a file with the given name in the exploded classPath.

lookUpInVirtualFileSystem

public SourceLocator.FoundFile lookUpInVirtualFileSystem(java.lang.String archivePath,
                                                         java.lang.String fileName)

Looks up classes in Java 9's virtual filesystem jrt:/

Parameters:

archivePath - path to the filesystem

fileName - the file to search

Returns:

the FoundFile

getSourceToClassMap

public java.util.HashMap<java.lang.String,java.lang.String> getSourceToClassMap()

setSourceToClassMap

public void setSourceToClassMap(java.util.HashMap<java.lang.String,java.lang.String> map)

addToSourceToClassMap

public void addToSourceToClassMap(java.lang.String key,
                                  java.lang.String val)

getSourceForClass

public java.lang.String getSourceForClass(java.lang.String className)

Returns the name of the class in which the (possibly inner) class className appears.