de.spricom.dessert.resolve

Class ClassResolver

java.lang.Object

de.spricom.dessert.resolve.ClassResolver

All Implemented Interfaces:

TraversalRoot

public final class ClassResolver
extends Object
implements TraversalRoot

The class resolver provides fast access to the classes and packages to analyze. Therefore it maintains of a list of all ClassRoot objects for which each represents a classes directory or a JAR file. And it has to HashMaps for all the packages and classes contained in any of these roots. The key used for theses HashMaps is the full qualified class or package name.

The ClassPackage has a collection of all classes subpackages it contains. Thus it provides direct access to all classes and subpackages of some package within some root.

Each ClassPackage or ClassEntry belongs to one root. The same class or package name may appear within different roots. In that case the ClassPackage or ClassEntry has LinkedList of all entries with the same name. This lists can be accessed by ClassPackage.getAlternatives() or ClassEntry.getAlternatives() respectively. Each entry points to the same list of alternatives. If there are no alternatives the correspondig list is null.

Typically one of the static of methods should be used to create a ClassResolver.

Constructor Summary

Constructors

Constructor and Description
ClassResolver()

Method Summary

Modifier and Type	Method and Description
void	add(File file)
void	add(String path)
void	addBootClassPath()
void	addClassPath()
void	addRoot(ClassRoot root)
void	freeze()
int	getClassCount()
ClassEntry	getClassEntry(File root, String classname)
ClassEntry	getClassEntry(String classname)
Map<String,List<ClassEntry>>	getDuplicates()
ClassPackage	getPackage(File root, String packageName)
ClassPackage	getPackage(String packageName)
int	getPackageCount()
ClassRoot	getRoot(File file)
Set<File>	getRootDirs()
Set<File>	getRootFiles()
Set<File>	getRootFiles(Predicate<File> predicate)
Set<File>	getRootJars()
static ClassResolver	of(String path) Creates a ClassResolver for some arbitrary path.
static ClassResolver	ofBootClassPath()
static ClassResolver	ofClassPath()
static ClassResolver	ofClassPathAndBootClassPath()
static ClassResolver	ofClassPathWithoutJars()
String	toString()
void	traverse(NamePattern pattern, ClassVisitor visitor)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassResolver

public ClassResolver()

Method Detail

of

public static ClassResolver of(String path)
                        throws IOException

Creates a ClassResolver for some arbitrary path.

Parameters:

path - the path to scan using the system specific classpath format

Returns:

a ClassResolver with the corresponding entries

Throws:

IOException - if a directory or jar file could not be read

ofClassPath

public static ClassResolver ofClassPath()
                                 throws IOException

Throws:

IOException

ofClassPathWithoutJars

public static ClassResolver ofClassPathWithoutJars()
                                            throws IOException

Throws:

IOException

ofBootClassPath

public static ClassResolver ofBootClassPath()
                                     throws IOException

Throws:

IOException

ofClassPathAndBootClassPath

public static ClassResolver ofClassPathAndBootClassPath()
                                                 throws IOException

Throws:

IOException

addClassPath

public void addClassPath()
                  throws IOException

Throws:

IOException

addBootClassPath

public void addBootClassPath()
                      throws IOException

Throws:

IOException

add

public void add(String path)
         throws IOException

Throws:

IOException

add

public void add(File file)
         throws IOException

Throws:

IOException

addRoot

public void addRoot(ClassRoot root)
             throws IOException

Throws:

IOException

freeze

public void freeze()

getRoot

public ClassRoot getRoot(File file)

getPackage

public ClassPackage getPackage(String packageName)

getPackage

public ClassPackage getPackage(File root,
                               String packageName)

getClassEntry

public ClassEntry getClassEntry(String classname)

getClassEntry

public ClassEntry getClassEntry(File root,
                                String classname)

traverse

public void traverse(NamePattern pattern,
                     ClassVisitor visitor)

Specified by:

traverse in interface TraversalRoot

getRootFiles

public Set<File> getRootFiles()

getRootJars

public Set<File> getRootJars()

getRootDirs

public Set<File> getRootDirs()

getRootFiles

public Set<File> getRootFiles(Predicate<File> predicate)

getDuplicates

public Map<String,List<ClassEntry>> getDuplicates()

getPackageCount

public int getPackageCount()

getClassCount

public int getClassCount()

toString

public String toString()

Overrides:

toString in class Object