Class UriPatternMatcher<T>
- java.lang.Object
-
- org.apache.hc.core5.http.protocol.UriPatternMatcher<T>
-
- Type Parameters:
T
- The type of registered objects.
- All Implemented Interfaces:
LookupRegistry<T>
@Contract(threading=SAFE) public class UriPatternMatcher<T> extends java.lang.Object implements LookupRegistry<T>
Maintains a map of objects keyed by a request URI pattern.Patterns may have three formats:
*
*<uri>
<uri>*
This class can be used to resolve an object matching a particular request URI.
- Since:
- 4.0
-
-
Constructor Summary
Constructors Constructor Description UriPatternMatcher()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.util.Set<java.util.Map.Entry<java.lang.String,T>>
entrySet()
Returns aSet
view of the mappings contained in this matcher.T
lookup(java.lang.String path)
Looks up an object matching the given request path.protected boolean
matchUriRequestPattern(java.lang.String pattern, java.lang.String path)
Tests if the given request path matches the given pattern.void
register(java.lang.String pattern, T obj)
Registers the given object for URIs matching the given pattern.java.lang.String
toString()
void
unregister(java.lang.String pattern)
Removes registered object, if exists, for the given pattern.
-
-
-
Field Detail
-
map
private final java.util.Map<java.lang.String,T> map
-
-
Method Detail
-
entrySet
public java.util.Set<java.util.Map.Entry<java.lang.String,T>> entrySet()
Returns aSet
view of the mappings contained in this matcher.- Returns:
- a set view of the mappings contained in this matcher.
- Since:
- 4.4.9
- See Also:
Map.entrySet()
-
register
public void register(java.lang.String pattern, T obj)
Registers the given object for URIs matching the given pattern.- Specified by:
register
in interfaceLookupRegistry<T>
- Parameters:
pattern
- the pattern to register the handler for.obj
- the object.
-
unregister
public void unregister(java.lang.String pattern)
Removes registered object, if exists, for the given pattern.- Specified by:
unregister
in interfaceLookupRegistry<T>
- Parameters:
pattern
- the pattern to unregister.
-
lookup
public T lookup(java.lang.String path)
Looks up an object matching the given request path.- Specified by:
lookup
in interfaceLookupRegistry<T>
- Parameters:
path
- the request path- Returns:
- object or
null
if no match is found.
-
matchUriRequestPattern
protected boolean matchUriRequestPattern(java.lang.String pattern, java.lang.String path)
Tests if the given request path matches the given pattern.- Parameters:
pattern
- the patternpath
- the request path- Returns:
true
if the request URI matches the pattern,false
otherwise.
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
-