org.evosuite.continuous.project

Class ProjectGraph

java.lang.Object

org.evosuite.continuous.project.ProjectGraph

public class ProjectGraph
extends Object

Class representing the class graph. For each class (CUT and non-testable), not only we want to know its hierarchy (parents, interfaces, subclasses, etc) but also where in the project it is used by other classes as input.

For definition of CUT, see ProjectStaticData

Constructor Summary

Constructors

Constructor and Description
ProjectGraph(ProjectStaticData data) Main constructor

Method Summary

Modifier and Type	Method and Description
Set<String>	getAllCUTsParents(String aClass) Return all the CUT classes that this aClass extends/implements (ie, parent hierarchy).
Set<String>	getAllCUTsSubclasses(String aClass) Return all the child hierarchy of the aClass.
Set<String>	getCUTsDirectlyUsedAsInput(String cut, boolean includeSubclasses) Return the full qualifying names of all classes that are CUTs and that are used as input in any of the public methods of cut (but not of any of its parent hierarchy).
Set<String>	getCUTsThatUseThisCUTasInput(String cut, boolean includeSuperClasses) Calculate all the CUTs that use the given cut as input in any of their public methods
boolean	isAbstract(String className) Is the given class name representing an abstract class in the SUT?
boolean	isConcrete(String className) Is the given class name representing a concrete class in the SUT?
boolean	isInterface(String className) Is the given class name representing an interface in the SUT?
protected Set<String>	recursionToSearchDirectInputs(String aClass, boolean includeSubclasses)
protected Set<String>	recursionToSearchWhatUsesItAsInput(String aClass, boolean includeSuperClasses)

Methods inherited from class java.lang.Object

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

Constructor Detail

ProjectGraph

public ProjectGraph(ProjectStaticData data)

Main constructor

Parameters:

data -

Method Detail

getCUTsDirectlyUsedAsInput

public Set<String> getCUTsDirectlyUsedAsInput(String cut,
                                              boolean includeSubclasses)
                                       throws IllegalArgumentException

Return the full qualifying names of all classes that are CUTs and that are used as input in any of the public methods of cut (but not of any of its parent hierarchy).

If a method takes as input a reference of a non-SUT class (e.g., java.lang.Object), but then there is a cast to a CUT (e.g. a class X), then X will be added in the returned set.

If a method takes as input a reference of a SUT class X that is not a CUT (e.g., an interface with no code), then X will not be added in the returned set, although based on includeSubclasses we might add its subclasses.

Parameters:

cut - the class under test (CUT)

includeSubclasses - If a class X is in the returned set, then normally no subclass Y of X would be added in the returned set, unless Y is directly used in the CUT as input.

Returns:

a set of full qualifying names of CUTs

Throws:

IllegalArgumentException - if the input cut is not a CUT

recursionToSearchDirectInputs

protected Set<String> recursionToSearchDirectInputs(String aClass,
                                                    boolean includeSubclasses)

getCUTsThatUseThisCUTasInput

public Set<String> getCUTsThatUseThisCUTasInput(String cut,
                                                boolean includeSuperClasses)
                                         throws IllegalArgumentException

Calculate all the CUTs that use the given cut as input in any of their public methods

Parameters:

cut - the class under test (CUT)

includeSuperClasses - not only using as input the cut, but also any of its CUT ancestors/interfaces

Returns:

a set of full qualifying names of CUTs

Throws:

IllegalArgumentException - if the input cut is not a CUT

recursionToSearchWhatUsesItAsInput

protected Set<String> recursionToSearchWhatUsesItAsInput(String aClass,
                                                         boolean includeSuperClasses)

isInterface

public boolean isInterface(String className)
                    throws IllegalArgumentException

Is the given class name representing an interface in the SUT?

Parameters:

className -

Returns:

Throws:

IllegalArgumentException

isConcrete

public boolean isConcrete(String className)
                   throws IllegalArgumentException

Is the given class name representing a concrete class in the SUT?

Parameters:

className -

Returns:

Throws:

IllegalArgumentException

isAbstract

public boolean isAbstract(String className)
                   throws IllegalArgumentException

Is the given class name representing an abstract class in the SUT?

Parameters:

className -

Returns:

Throws:

IllegalArgumentException

getAllCUTsSubclasses

public Set<String> getAllCUTsSubclasses(String aClass)
                                 throws IllegalArgumentException

Return all the child hierarchy of the aClass. Include only classes that are CUTs. This aClass will not be part of the returned set, even if it is a CUT

Parameters:

aClass - a class belonging to the SUT, but not necessarily a CUT

Returns:

a set of full qualifying names of CUTs

Throws:

IllegalArgumentException - if the input aClass does not belong to the SUT

getAllCUTsParents

public Set<String> getAllCUTsParents(String aClass)
                              throws IllegalArgumentException

Return all the CUT classes that this aClass extends/implements (ie, parent hierarchy). This aClass will not be part of the returned set, even if it is a CUT

Parameters:

aClass - a class belonging to the SUT, but not necessarily a CUT

Returns:

a set of full qualifying names of CUTs

Throws:

IllegalArgumentException - if the input aClass does not belong to the SUT