Package org.eclipse.jetty.webapp

Class ClasspathPattern

java.lang.Object

java.util.AbstractCollection<String>

java.util.AbstractSet<String>

org.eclipse.jetty.webapp.ClasspathPattern

All Implemented Interfaces:

Iterable<String>, Collection<String>, Set<String>

public class ClasspathPattern
extends AbstractSet<String>

Classpath classes list performs pattern matching of a class name against an internal array of classpath pattern entries. A class pattern is a string of one of the forms:

• 'org.package.SomeClass' will match a specific class
• 'org.package.' will match a specific package hierarchy
• 'org.package.SomeClass$NestedClass ' will match a nested class exactly otherwise. Nested classes are matched by their containing class. (eg. org.example.MyClass matches org.example.MyClass$AnyNestedClass)
• 'file:///some/location/' - A file system directory from which the class was loaded
• 'file:///some/location.jar' - The URI of a jar file from which the class was loaded
• 'jrt:/modulename' - A Java9 module name
• Any of the above patterns preceded by '-' will exclude rather than include the match.

When class is initialized from a classpath pattern string, entries in this string should be separated by ':' (semicolon) or ',' (comma).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClasspathPattern.ByClass
static class	ClasspathPattern.ByLocation
static class	ClasspathPattern.ByLocationOrModule
static class	ClasspathPattern.ByModule
static class	ClasspathPattern.ByPackage
static class	ClasspathPattern.ByPackageOrName
private static class	ClasspathPattern.ClassEntry
(package private) static class	ClasspathPattern.Entry
private static class	ClasspathPattern.LocationEntry
private static class	ClasspathPattern.ModuleEntry
private static class	ClasspathPattern.PackageEntry

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Map<String,ClasspathPattern.Entry>	_entries
(package private) IncludeExcludeSet<ClasspathPattern.Entry,URI>	_locations
(package private) IncludeExcludeSet<ClasspathPattern.Entry,String>	_packageOrNamePatterns

Constructor Summary

Constructors

Constructor	Description
ClasspathPattern()
ClasspathPattern(String pattern)
ClasspathPattern(String[] patterns)

Method Summary

Modifier and Type	Method	Description
boolean	add(String pattern)
boolean	add(String... pattern)
protected boolean	add(ClasspathPattern.Entry entry)
private void	addAll(String[] classes)
void	clear()
(package private) static boolean	combine(IncludeExcludeSet<ClasspathPattern.Entry,String> names, String name, IncludeExcludeSet<ClasspathPattern.Entry,URI> locations, Supplier<URI> location)	Match a class against inclusions and exclusions by name and location.
boolean	exclude(String name)
boolean	exclude(String... name)
String[]	getPatterns()
boolean	include(String name)
boolean	include(String... name)
Iterator<String>	iterator()
boolean	match(Class<?> clazz)	Match the class name against the pattern
boolean	match(String name)	Match the class name against the pattern
boolean	match(String name, URL url)
protected ClasspathPattern.Entry	newEntry(String pattern)
protected ClasspathPattern.Entry	newEntry(String name, boolean inclusive)
boolean	remove(Object o)
private void	setAll(String[] classes)	Initialize the matcher by parsing each classpath pattern in an array
int	size()

Methods inherited from class java.util.AbstractSet

equals, hashCode, removeAll

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

addAll, contains, containsAll, isEmpty, retainAll, spliterator, toArray, toArray

Field Details

_entries

Map<String,ClasspathPattern.Entry> _entries

_packageOrNamePatterns

IncludeExcludeSet<ClasspathPattern.Entry,String> _packageOrNamePatterns

_locations

IncludeExcludeSet<ClasspathPattern.Entry,URI> _locations

Constructor Details

ClasspathPattern

public ClasspathPattern()

ClasspathPattern

public ClasspathPattern(String[] patterns)

ClasspathPattern

public ClasspathPattern(String pattern)

Method Details

include

public boolean include(String name)

include

public boolean include(String... name)

exclude

public boolean exclude(String name)

exclude

public boolean exclude(String... name)

add

public boolean add(String pattern)

Specified by:

add in interface Collection<String>

Specified by:

add in interface Set<String>

Overrides:

add in class AbstractCollection<String>

add

public boolean add(String... pattern)

newEntry

protected ClasspathPattern.Entry newEntry(String pattern)

newEntry

protected ClasspathPattern.Entry newEntry(String name,
 boolean inclusive)

add

protected boolean add(ClasspathPattern.Entry entry)

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<String>

Specified by:

remove in interface Set<String>

Overrides:

remove in class AbstractCollection<String>

clear

public void clear()

Specified by:

clear in interface Collection<String>

Specified by:

clear in interface Set<String>

Overrides:

clear in class AbstractCollection<String>

iterator

public Iterator<String> iterator()

Specified by:

iterator in interface Collection<String>

Specified by:

iterator in interface Iterable<String>

Specified by:

iterator in interface Set<String>

Specified by:

iterator in class AbstractCollection<String>

size

public int size()

Specified by:

size in interface Collection<String>

Specified by:

size in interface Set<String>

Specified by:

size in class AbstractCollection<String>

setAll

private void setAll(String[] classes)

Initialize the matcher by parsing each classpath pattern in an array

Parameters:

classes - array of classpath patterns

addAll

private void addAll(String[] classes)

Parameters:

classes - array of classpath patterns

getPatterns

public String[] getPatterns()

Returns:

array of classpath patterns

match

public boolean match(String name)

Match the class name against the pattern

Parameters:

name - name of the class to match

Returns:

true if class matches the pattern

match

public boolean match(Class<?> clazz)

Match the class name against the pattern

Parameters:

clazz - A class to try to match

Returns:

true if class matches the pattern

match

public boolean match(String name,
 URL url)

combine

static boolean combine(IncludeExcludeSet<ClasspathPattern.Entry,String> names,
 String name,
 IncludeExcludeSet<ClasspathPattern.Entry,URI> locations,
 Supplier<URI> location)

Match a class against inclusions and exclusions by name and location. Name based checks are performed before location checks. For a class to match, it must not be excluded by either name or location, and must either be explicitly included, or for there to be no inclusions. In the case where the location of the class is null, it will match if it is included by name, or if there are no location exclusions.

Parameters:

names - configured inclusions and exclusions by name

name - the name to check

locations - configured inclusions and exclusions by location

location - the location of the class (can be null)

Returns:

true if the class is not excluded but is included, or there are no inclusions. False otherwise.