org.apache.tools.ant.util.depend
Interface DependencyAnalyzer
- AbstractAnalyzer, AncestorAnalyzer, AntAnalyzer, FullAnalyzer
public interface DependencyAnalyzer
A dependency analyzer analyzes dependencies between Java classes to
determine the minimal set of classes which are required by a set of
"root" classes. Different implementations of this interface can
use different strategies and libraries to determine the required set. For
example, some analyzers will use class files while others might use
source files. Analyzer specific configuration is catered for through a
generic configure method
void | addClassPath(Path classpath) - Add a classpath to the classpath being used by the analyzer.
|
void | addRootClass(String classname) - Add a root class.
|
void | addSourcePath(Path sourcePath) - Add a source path to the source path used by this analyzer.
|
void | config(String name, Object info) - Configure an aspect of the analyzer.
|
File | getClassContainer(String classname) - Get the file that contains the class definition
|
Enumeration | getClassDependencies() - Get the list of classes upon which root classes depend.
|
Enumeration | getFileDependencies() - Get the list of files in the file system upon which the root classes
depend.
|
File | getSourceContainer(String classname) - Get the file that contains the class source.
|
void | reset() - Reset the dependency list.
|
void | setClosure(boolean closure) - Set the closure flag.
|
addClassPath
public void addClassPath(Path classpath)
Add a classpath to the classpath being used by the analyzer. The
classpath contains the binary classfiles for the classes being
analyzed The elements may either be the directories or jar files.Not
all analyzers will use this information.
classpath
- the Path instance specifying the classpath elements
addRootClass
public void addRootClass(String classname)
Add a root class. The root classes are used to drive the
determination of dependency information. The analyzer will start at
the root classes and add dependencies from there.
classname
- the name of the class in Java dot notation.
addSourcePath
public void addSourcePath(Path sourcePath)
Add a source path to the source path used by this analyzer. The
elements in the given path contain the source files for the classes
being analyzed. Not all analyzers will use this information.
sourcePath
- The Path instance specifying the source path
elements.
config
public void config(String name,
Object info)
Configure an aspect of the analyzer. The set of aspects that are
supported is specific to each analyzer instance.
name
- the name of the aspect being configuredinfo
- the configuration information.
getClassContainer
public File getClassContainer(String classname)
throws IOException
Get the file that contains the class definition
classname
- the name of the required class
- the file instance, zip or class, containing the
class or null if the class could not be found.
getClassDependencies
public Enumeration getClassDependencies()
Get the list of classes upon which root classes depend. This is a
list of Java classnames in dot notation.
- an enumeration of Strings, each being the name of a Java
class in dot notation.
getFileDependencies
public Enumeration getFileDependencies()
Get the list of files in the file system upon which the root classes
depend. The files will be either the classfiles or jar files upon
which the root classes depend.
- an enumeration of File instances.
getSourceContainer
public File getSourceContainer(String classname)
throws IOException
Get the file that contains the class source.
classname
- the name of the required class
- the file instance, zip or java, containing the
source or null if the source for the class could not be found.
reset
public void reset()
Reset the dependency list. This will reset the determined
dependencies and the also list of root classes.
setClosure
public void setClosure(boolean closure)
Set the closure flag. If this flag is true the analyzer will traverse
all class relationships until it has collected the entire set of
direct and indirect dependencies
closure
- true if dependencies should be traversed to determine
indirect dependencies.
Copyright B) 2000-2006 Apache Software Foundation. All Rights Reserved.