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 Hult

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

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.
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

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>