com.yahoo.jdisc.application

Class UriPattern

java.lang.Object

com.yahoo.jdisc.application.UriPattern

All Implemented Interfaces:

Comparable<UriPattern>

public class UriPattern
extends Object
implements Comparable<UriPattern>

This class holds a regular expression designed so that it only matches certain URIs. The constructor of this class accepts a simplified pattern string, and turns that into something that can be used to quickly match against URIs. This class also implements Comparable in such a way that stricter patterns order before looser patterns.

Here are some examples of ordering:

• http://host/path evaluated before *://host/path
• http://host/path evaluated before http://*/path
• http://a.host/path evaluated before http://*.host/path
• http://*.host/path evaluated before http://host/path
• http://host.a/path evaluated before http://host.*/path
• http://host.*/path evaluated before http://host/path
• http://host:80/path evaluated before http://host:*/path
• http://host/path evaluated before http://host/*
• http://host/path/* evaluated before http://host/path

Author:

Simon Thoresen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UriPattern.Match This class holds the result of a match(URI) operation.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_PRIORITY
private GlobPattern	host
private GlobPattern	path
private String	pattern
private static Pattern	PATTERN
private int	port
private int	priority
private GlobPattern	scheme

Constructor Summary

Constructors

Constructor and Description
UriPattern(String uri) Creates a new instance of this class that represents the given pattern string, with a priority of 0.
UriPattern(String uri, int priority) Creates a new instance of this class that represents the given pattern string, with the given priority.

Method Summary

Modifier and Type	Method and Description
int	compareTo(UriPattern rhs)
boolean	equals(Object obj)
int	hashCode()
UriPattern.Match	match(URI uri) Attempts to match the given URI to this pattern.
private static String	resolvePatternComponent(String val)
private static int	resolvePortPattern(String str)
private static String	resolveUriComponent(String str)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PRIORITY

public static final int DEFAULT_PRIORITY

See Also:

Constant Field Values

PATTERN

private static final Pattern PATTERN

pattern

private final String pattern

scheme

private final GlobPattern scheme

host

private final GlobPattern host

port

private final int port

path

private final GlobPattern path

priority

private final int priority

Constructor Detail

UriPattern

public UriPattern(String uri)

Creates a new instance of this class that represents the given pattern string, with a priority of 0. The input string must be on the form <scheme>://<host>[:<port>]<path>, where '*' can be used as a wildcard character at any position.

Parameters:

uri - The pattern to parse.

Throws:

IllegalArgumentException - If the pattern could not be parsed.

UriPattern

public UriPattern(String uri,
                  int priority)

Creates a new instance of this class that represents the given pattern string, with the given priority. The input string must be on the form <scheme>://<host>[:<port>]<path>, where '*' can be used as a wildcard character at any position.

Parameters:

uri - The pattern to parse.

priority - The priority of this pattern.

Throws:

IllegalArgumentException - If the pattern could not be parsed.

Method Detail

match

public UriPattern.Match match(URI uri)

Attempts to match the given URI to this pattern. Note that only the scheme, host, port, and path components of the URI are used. Any query or fragment part is simply ignored.

Parameters:

uri - The URI to match.

Returns:

A UriPattern.Match object describing the match found, or null if not found.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(UriPattern rhs)

Specified by:

compareTo in interface Comparable<UriPattern>

resolveUriComponent

private static String resolveUriComponent(String str)

resolvePatternComponent

private static String resolvePatternComponent(String val)

resolvePortPattern

private static int resolvePortPattern(String str)