public class UriPattern
extends java.lang.Object
| Modifier and Type | Field and Description |
|---|---|
static UriPattern |
EMPTY
The empty URI pattern that matches the null or empty URI path
|
| Modifier | Constructor and Description |
|---|---|
protected |
UriPattern()
Construct an empty pattern.
|
|
UriPattern(java.util.regex.Pattern regexPattern)
Construct a new URI pattern.
|
|
UriPattern(java.util.regex.Pattern regexPattern,
int[] groupIndexes)
Construct a new URI pattern.
|
|
UriPattern(java.lang.String regex)
Construct a new URI pattern.
|
|
UriPattern(java.lang.String regex,
int[] groupIndexes)
Construct a new URI pattern.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
equals(java.lang.Object obj) |
int[] |
getGroupIndexes()
Get the group indexes.
|
java.lang.String |
getRegex()
Get the regular expression.
|
int |
hashCode() |
java.util.regex.MatchResult |
match(java.lang.CharSequence uri)
Match a URI against the pattern.
|
boolean |
match(java.lang.CharSequence uri,
java.util.List<java.lang.String> groupValues)
Match a URI against the pattern.
|
boolean |
match(java.lang.CharSequence uri,
java.util.List<java.lang.String> groupNames,
java.util.Map<java.lang.String,java.lang.String> groupValues)
Match a URI against the pattern.
|
java.lang.String |
toString() |
public static final UriPattern EMPTY
protected UriPattern()
public UriPattern(java.lang.String regex)
regex - the regular expression. If the expression is null or an
empty string then the pattern will only match a null or empty
URI path.java.util.regex.PatternSyntaxException - if the
regular expression could not be compiledpublic UriPattern(java.lang.String regex,
int[] groupIndexes)
regex - the regular expression. If the expression is null or an
empty string then the pattern will only match a null or empty
URI path.groupIndexes - the array of group indexes to capturing groups.java.util.regex.PatternSyntaxException - if the
regular expression could not be compiledpublic UriPattern(java.util.regex.Pattern regexPattern)
regexPattern - the regular expression patternjava.lang.IllegalArgumentException - if the regexPattern is null.public UriPattern(java.util.regex.Pattern regexPattern,
int[] groupIndexes)
regexPattern - the regular expression patterngroupIndexes - the array of group indexes to capturing groups.java.lang.IllegalArgumentException - if the regexPattern is null.public final java.lang.String getRegex()
public final int[] getGroupIndexes()
public final java.util.regex.MatchResult match(java.lang.CharSequence uri)
uri - the uri to match against the template.public final boolean match(java.lang.CharSequence uri,
java.util.List<java.lang.String> groupValues)
If the URI matches against the pattern then the capturing group values (if any) will be added to a list passed in as parameter.
uri - the uri to match against the template.groupValues - the list to add the values of a pattern's
capturing groups if matching is successful. The values are added
in the same order as the pattern's capturing groups. The list
is cleared before values are added.java.lang.IllegalArgumentException - if the uri or
capturingGroupValues is null.public final boolean match(java.lang.CharSequence uri,
java.util.List<java.lang.String> groupNames,
java.util.Map<java.lang.String,java.lang.String> groupValues)
If the URI matches against the pattern then the capturing group values (if any) will be added to a map passed in as parameter.
uri - the uri to match against the template.groupNames - the list names associated with a pattern's
capturing groups. The names MUST be in the same order as the
pattern's capturing groups and the size MUST be equal to or
less than the number of capturing groups.groupValues - the map to add the values of a pattern's
capturing groups if matching is successful. A values is put
into the map using the group name associated with the
capturing group. The map is cleared before values are added.java.lang.IllegalArgumentException - if the uri or
capturingGroupValues is null.public final int hashCode()
hashCode in class java.lang.Objectpublic final boolean equals(java.lang.Object obj)
equals in class java.lang.Objectpublic final java.lang.String toString()
toString in class java.lang.ObjectCopyright © 2016 Oracle Corporation. All Rights Reserved.