Package org.apache.maven.surefire.testset

Class TestListResolver

java.lang.Object

org.apache.maven.surefire.testset.TestListResolver

All Implemented Interfaces:

GenericTestPattern<ResolvedTest,String,String>, TestFilter<String,String>

public class TestListResolver
extends Object
implements GenericTestPattern<ResolvedTest,String,String>

Resolved multi pattern filter e.g. -Dtest=MyTest#test,!AnotherTest#otherTest into an object model composed of included and excluded tests.
The methods shouldRun(String, String) are filters easily used in JUnit filter or TestNG. This class is independent of JUnit and TestNG API.
It is accessed by Java Reflection API in SurefireReflector using specific ClassLoader.

Field Summary

Fields

Modifier and Type	Field	Description
private static final TestListResolver	EMPTY
private final Set<ResolvedTest>	excludedPatterns
private final boolean	hasExcludedMethodPatterns
private final boolean	hasIncludedMethodPatterns
private final Set<ResolvedTest>	includedPatterns
private static final String	JAVA_CLASS_FILE_EXTENSION
private static final TestListResolver	WILDCARD

Constructor Summary

Constructors

Modifier	Constructor	Description
private	TestListResolver(boolean hasIncludedMethodPatterns, boolean hasExcludedMethodPatterns, Set<ResolvedTest> includedPatterns, Set<ResolvedTest> excludedPatterns)	Used only in method filter.
	TestListResolver(String csvTests)
	TestListResolver(Collection<String> tests)
	TestListResolver(Collection<String> included, Collection<String> excluded)

Method Summary

Modifier and Type	Method	Description
private static String	aggregatedTest(String testPrefix, Set<ResolvedTest> tests)
TestFilter<String,String>	and(TestListResolver another)
boolean	equals(Object o)
static TestListResolver	getEmptyTestListResolver()
Set<ResolvedTest>	getExcludedPatterns()
Set<ResolvedTest>	getIncludedPatterns()
String	getPluginParameterTest()
static TestListResolver	getWildcard()
boolean	hasExcludedMethodPatterns()
int	hashCode()
boolean	hasIncludedMethodPatterns()
boolean	hasMethodPatterns()
private static boolean	haveMethodPatterns(Set<ResolvedTest> patterns)
boolean	isEmpty()
(package private) static boolean	isRegexMinLength(String pattern)
(package private) static boolean	isRegexPrefixedPattern(String pattern)
final boolean	isWildcard()
private static Collection<String>	mergeIncludedAndExcludedTests(Collection<String> included, Collection<String> excluded)
static TestListResolver	newTestListResolver(Set<ResolvedTest> includedPatterns, Set<ResolvedTest> excludedPatterns)
(package private) static void	nonRegexClassAndMethods(String clazz, String methods, boolean isExcluded, IncludedExcludedPatterns patterns, Collection<ResolvedTest> includedFilters, Collection<ResolvedTest> excludedFilters)
static TestListResolver	optionallyWildcardFilter(TestListResolver resolver)
TestFilter<String,String>	or(TestListResolver another)
(package private) static String	removeExclamationMark(String s)
(package private) static void	resolveTestRequest(String request, IncludedExcludedPatterns patterns, Collection<ResolvedTest> includedFilters, Collection<ResolvedTest> excludedFilters)	Requires trimmed request been not equal to "!".
boolean	shouldRun(Class<?> testClass, String methodName)
boolean	shouldRun(String testClassFile, String methodName)	Returns true if satisfies testClassFile and methodName filter.
static String	toClassFileName(Class<?> test)
static String	toClassFileName(String fullyQualifiedTestClass)
String	toString()
(package private) static String[]	unwrap(String request)
(package private) static String[]	unwrapRegex(String regex)
private static void	updatedFilters(boolean isExcluded, ResolvedTest test, IncludedExcludedPatterns patterns, Collection<ResolvedTest> includedFilters, Collection<ResolvedTest> excludedFilters)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

JAVA_CLASS_FILE_EXTENSION

private static final String JAVA_CLASS_FILE_EXTENSION

See Also:

• Constant Field Values

WILDCARD

private static final TestListResolver WILDCARD

EMPTY

private static final TestListResolver EMPTY

includedPatterns

private final Set<ResolvedTest> includedPatterns

excludedPatterns

private final Set<ResolvedTest> excludedPatterns

hasIncludedMethodPatterns

private final boolean hasIncludedMethodPatterns

hasExcludedMethodPatterns

private final boolean hasExcludedMethodPatterns

Constructor Details

TestListResolver

public TestListResolver(Collection<String> tests)

TestListResolver

public TestListResolver(String csvTests)

TestListResolver

public TestListResolver(Collection<String> included,
 Collection<String> excluded)

TestListResolver

private TestListResolver(boolean hasIncludedMethodPatterns,
 boolean hasExcludedMethodPatterns,
 Set<ResolvedTest> includedPatterns,
 Set<ResolvedTest> excludedPatterns)

Used only in method filter.

Method Details

newTestListResolver

public static TestListResolver newTestListResolver(Set<ResolvedTest> includedPatterns,
 Set<ResolvedTest> excludedPatterns)

hasIncludedMethodPatterns

public boolean hasIncludedMethodPatterns()

Specified by:

hasIncludedMethodPatterns in interface GenericTestPattern<ResolvedTest,String,String>

hasExcludedMethodPatterns

public boolean hasExcludedMethodPatterns()

Specified by:

hasExcludedMethodPatterns in interface GenericTestPattern<ResolvedTest,String,String>

hasMethodPatterns

public boolean hasMethodPatterns()

Specified by:

hasMethodPatterns in interface GenericTestPattern<ResolvedTest,String,String>

optionallyWildcardFilter

public static TestListResolver optionallyWildcardFilter(TestListResolver resolver)

Parameters:

resolver - filter possibly having method patterns

Returns:

resolver if resolver.hasMethodPatterns() returns true; Otherwise wildcard filter *.class is returned.

getWildcard

public static TestListResolver getWildcard()

getEmptyTestListResolver

public static TestListResolver getEmptyTestListResolver()

isWildcard

public final boolean isWildcard()

and

public TestFilter<String,String> and(TestListResolver another)

or

public TestFilter<String,String> or(TestListResolver another)

shouldRun

public boolean shouldRun(Class<?> testClass,
 String methodName)

shouldRun

public boolean shouldRun(String testClassFile,
 String methodName)

Returns true if satisfies testClassFile and methodName filter.

Specified by:

shouldRun in interface TestFilter<String,String>

Parameters:

testClassFile - format must be e.g. "my/package/MyTest.class" including class extension; or null

methodName - real test-method name; or null

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface GenericTestPattern<ResolvedTest,String,String>

getPluginParameterTest

public String getPluginParameterTest()

Specified by:

getPluginParameterTest in interface GenericTestPattern<ResolvedTest,String,String>

getIncludedPatterns

public Set<ResolvedTest> getIncludedPatterns()

Specified by:

getIncludedPatterns in interface GenericTestPattern<ResolvedTest,String,String>

getExcludedPatterns

public Set<ResolvedTest> getExcludedPatterns()

Specified by:

getExcludedPatterns in interface GenericTestPattern<ResolvedTest,String,String>

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

toClassFileName

public static String toClassFileName(Class<?> test)

toClassFileName

public static String toClassFileName(String fullyQualifiedTestClass)

removeExclamationMark

static String removeExclamationMark(String s)

updatedFilters

private static void updatedFilters(boolean isExcluded,
 ResolvedTest test,
 IncludedExcludedPatterns patterns,
 Collection<ResolvedTest> includedFilters,
 Collection<ResolvedTest> excludedFilters)

aggregatedTest

private static String aggregatedTest(String testPrefix,
 Set<ResolvedTest> tests)

mergeIncludedAndExcludedTests

private static Collection<String> mergeIncludedAndExcludedTests(Collection<String> included,
 Collection<String> excluded)

isRegexPrefixedPattern

static boolean isRegexPrefixedPattern(String pattern)

isRegexMinLength

static boolean isRegexMinLength(String pattern)

unwrapRegex

static String[] unwrapRegex(String regex)

unwrap

static String[] unwrap(String request)

nonRegexClassAndMethods

static void nonRegexClassAndMethods(String clazz,
 String methods,
 boolean isExcluded,
 IncludedExcludedPatterns patterns,
 Collection<ResolvedTest> includedFilters,
 Collection<ResolvedTest> excludedFilters)

resolveTestRequest

static void resolveTestRequest(String request,
 IncludedExcludedPatterns patterns,
 Collection<ResolvedTest> includedFilters,
 Collection<ResolvedTest> excludedFilters)

Requires trimmed request been not equal to "!".

haveMethodPatterns

private static boolean haveMethodPatterns(Set<ResolvedTest> patterns)