org.eclipse.jetty.http
类 PathMap

java.lang.Object
  java.util.AbstractMap<K,V>
      java.util.HashMap
          org.eclipse.jetty.http.PathMap

所有已实现的接口：

Externalizable, Serializable, Cloneable, Map

public class PathMap
extends HashMap
implements Externalizable

URI path map to Object. This mapping implements the path specification recommended in the 2.2 Servlet API. Path specifications can be of the following forms:

 /foo/bar           - an exact path specification.
 /foo/*             - a prefix path specification (must end '/*').
 *.ext              - a suffix path specification.
 /                  - the default path specification.
 

Matching is performed in the following order

Exact match.

Longest prefix match.

Longest suffix match.

default. Multiple path specifications can be mapped by providing a list of specifications. By default this class uses characters ":," as path separators, unless configured differently by calling the static method @see PathMap#setPathSpecSeparators(String)

Special characters within paths such as ' and ';' are not treated specially as it is assumed they would have been either encoded in the original URL or stripped from the path.

This class is not synchronized. If concurrent modifications are possible then it should be synchronized at a higher level.

另请参见：

序列化表格

嵌套类摘要

static class

PathMap.Entry

从类 java.util.AbstractMap 继承的嵌套类/接口

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

构造方法摘要

PathMap()
Construct empty PathMap.

PathMap(boolean nodefault)
Construct empty PathMap.

PathMap(int capacity)
Construct empty PathMap.

PathMap(Map m)
Construct from dictionary PathMap.

方法摘要

void	clear()
boolean	containsMatch(String path) Return whether the path matches any entries in the PathMap, excluding the default entry
Object	getLazyMatches(String path) Get all entries matched by the path.
PathMap.Entry	getMatch(String path) Get the entry mapped by the best specification.
List	getMatches(String path) Get all entries matched by the path.
Object	match(String path) Get object matched by the path.
static boolean	match(String pathSpec, String path)
static boolean	match(String pathSpec, String path, boolean noDefault)
static String	pathInfo(String pathSpec, String path) Return the portion of a path that is after a path spec.
static String	pathMatch(String pathSpec, String path) Return the portion of a path that matches a path spec.
Object	put(Object pathSpec, Object object) Add a single path match to the PathMap.
void	readExternal(ObjectInput in)
static String	relativePath(String base, String pathSpec, String path) Relative path.
Object	remove(Object pathSpec)
static void	setPathSpecSeparators(String s) Set the path spec separator.
void	writeExternal(ObjectOutput out)

从类 java.util.HashMap 继承的方法

clone, containsKey, containsValue, entrySet, get, isEmpty, keySet, putAll, size, values

从类 java.util.AbstractMap 继承的方法

equals, hashCode, toString

从类 java.lang.Object 继承的方法

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

从接口 java.util.Map 继承的方法

equals, hashCode

构造方法详细信息

PathMap

public PathMap()

Construct empty PathMap.

PathMap

public PathMap(boolean nodefault)

Construct empty PathMap.

PathMap

public PathMap(int capacity)

Construct empty PathMap.

PathMap

public PathMap(Map m)

Construct from dictionary PathMap.

方法详细信息

setPathSpecSeparators

public static void setPathSpecSeparators(String s)

Set the path spec separator. Multiple path specification may be included in a single string if they are separated by the characters set in this string. By default this class uses ":," characters as path separators.

参数：

s - separators

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

指定者：

接口 Externalizable 中的 writeExternal

抛出：

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

指定者：

接口 Externalizable 中的 readExternal

抛出：

IOException

ClassNotFoundException

put

public Object put(Object pathSpec,
                  Object object)

Add a single path match to the PathMap.

指定者：

接口 Map 中的 put

覆盖：

类 HashMap 中的 put

参数：

pathSpec - The path specification, or comma separated list of path specifications.

object - The object the path maps to

match

public Object match(String path)

Get object matched by the path.

参数：

path - the path.

返回：

Best matched object or null.

getMatch

public PathMap.Entry getMatch(String path)

Get the entry mapped by the best specification.

参数：

path - the path.

返回：

Map.Entry of the best matched or null.

getLazyMatches

public Object getLazyMatches(String path)

Get all entries matched by the path. Best match first.

参数：

path - Path to match

返回：

LazyList of Map.Entry instances key=pathSpec

getMatches

public List getMatches(String path)

Get all entries matched by the path. Best match first.

参数：

path - Path to match

返回：

List of Map.Entry instances key=pathSpec

containsMatch

public boolean containsMatch(String path)

Return whether the path matches any entries in the PathMap, excluding the default entry

参数：

path - Path to match

返回：

Whether the PathMap contains any entries that match this

remove

public Object remove(Object pathSpec)

指定者：

接口 Map 中的 remove

覆盖：

类 HashMap 中的 remove

clear

public void clear()

指定者：

接口 Map 中的 clear

覆盖：

类 HashMap 中的 clear

match

public static boolean match(String pathSpec,
                            String path)
                     throws IllegalArgumentException

返回：

true if match.

抛出：

IllegalArgumentException

match

public static boolean match(String pathSpec,
                            String path,
                            boolean noDefault)
                     throws IllegalArgumentException

返回：

true if match.

抛出：

IllegalArgumentException

pathMatch

public static String pathMatch(String pathSpec,
                               String path)

Return the portion of a path that matches a path spec.

返回：

null if no match at all.

pathInfo

public static String pathInfo(String pathSpec,
                              String path)

Return the portion of a path that is after a path spec.

返回：

The path info string

relativePath

public static String relativePath(String base,
                                  String pathSpec,
                                  String path)

Relative path.

参数：

base - The base the path is relative to.

pathSpec - The spec of the path segment to ignore.

path - the additional path

返回：

base plus path with pathspec removed