org.mule.module.apikit.uri

Class TokenOperatorPS

java.lang.Object

org.mule.module.apikit.uri.TokenOperatorPS

All Implemented Interfaces:

Matchable, Token

public class TokenOperatorPS
extends Object
implements Matchable

A token based on the operators used in PageSeeder.

This syntax borrows heavily from a suggestion made by Roy T. Fielding on the W3C URI list and regarding the URI Template draft specification.

  instruction   = "{" [ operator ] variable-list "}"
  operator      = "/" / "+" / ";" / "?" / op-reserve
  variable-list =  varspec *( "," varspec )
  varspec       =  [ var-type ] varname [ ":" prefix-len ] [ "=" default ]
  var-type      = "@" / "%" / type-reserve
  varname       = ALPHA *( ALPHA | DIGIT | "_" )
  prefix-len    = 1*DIGIT
  default       = *( unreserved / reserved )
  op-reserve    = <anything else that isn't ALPHA or operator>
  type-reserve  = <anything else that isn't ALPHA, ",", or operator>
 

Version:

6 November 2009

Author:

Christophe Lauret

See Also:

Re: URI Templates? from Roy T. Fielding on 2008-09-16 (uri@w3.org)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TokenOperatorPS.Operator The list of operators currently supported.

Constructor Summary

Constructors

Constructor and Description
TokenOperatorPS(TokenOperatorPS.Operator op, Variable var) Creates a new operator token for one variable only.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o) Two tokens are equals if and only if their string expression is equal.
String	expression() The expression corresponding to this token.
int	hashCode()
boolean	isResolvable() Indicates whether this token can be resolved.
boolean	match(String part) Indicates whether this token matches the specified part of a URL.
TokenOperatorPS.Operator	operator() Returns the operator part of this token.
Pattern	pattern() Returns a regular expression pattern corresponding to this object.
boolean	resolve(String expanded, Map<Variable,Object> values) Resolves the specified expanded URI part for this token.
protected static String	strip(String exp) Removes the curly brackets from the specified expression.
String	toString()
protected static List<Variable>	toVariables(String exp) Returns the variables for a given expression containing a list of variables.

Methods inherited from class java.lang.Object

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

Constructor Detail

TokenOperatorPS

public TokenOperatorPS(TokenOperatorPS.Operator op,
                       Variable var)
                throws NullPointerException

Creates a new operator token for one variable only.

Parameters:

op - The operator to use.

var - The variable for this operator.

Throws:

NullPointerException - If any of the argument is null.

Method Detail

operator

public TokenOperatorPS.Operator operator()

Returns the operator part of this token.

Returns:

the operator.

isResolvable

public boolean isResolvable()

Indicates whether this token can be resolved.

A resolvable token contains variables which can be resolved.

By default a token is resolvable if it can be matched.

Specified by:

isResolvable in interface Token

Returns:

true if variables can be resolved from the specified pattern; false otherwise.

resolve

public boolean resolve(String expanded,
                       Map<Variable,Object> values)

Resolves the specified expanded URI part for this token.

The resolution process requires all variables referenced in the token to be mapped to the value that is present in the expanded URI data.

Specified by:

resolve in interface Token

Parameters:

expanded - The part of the URI that correspond to an expanded version of the token.

values - The variables mapped to their values as a result of resolution.

Returns:

true this operation was successful; false otherwise.

match

public boolean match(String part)

Indicates whether this token matches the specified part of a URL.

Specified by:

match in interface Matchable

Parameters:

part - The part of URL to test for matching.

Returns:

true if it matches; false otherwise.

pattern

public Pattern pattern()

Returns a regular expression pattern corresponding to this object.

Specified by:

pattern in interface Matchable

Returns:

The regular expression pattern corresponding to this object.

expression

public String expression()

The expression corresponding to this token.

Specified by:

expression in interface Token

Returns:

The expression corresponding to this token.

equals

public boolean equals(Object o)

Two tokens are equals if and only if their string expression is equal.

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

strip

protected static final String strip(String exp)

Removes the curly brackets from the specified expression.

If the expression is already stripped, this method returns the same string.

Parameters:

exp - The expression to 'strip'.

Returns:

The raw expression (without the curly brackets).

toVariables

protected static final List<Variable> toVariables(String exp)
                                           throws URITemplateSyntaxException

Returns the variables for a given expression containing a list of variables.

Parameters:

exp - An expression containing a comma separated list of variables.

Returns:

A list of variables.

Throws:

URITemplateSyntaxException - If thrown by the Variable get method.