org.grouplens.grapht.context

Class ContextPattern

java.lang.Object

org.grouplens.grapht.context.ContextPattern

All Implemented Interfaces:

Serializable, ContextMatcher

public class ContextPattern
extends Object
implements ContextMatcher, Serializable

A regular pattern matching contexts.

Since:

0.7

Author:

GroupLens Research

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ContextPattern.Element An element of the context pattern.

Method Summary

Methods

Modifier and Type	Method and Description
static ContextPattern	any() Create a context pattern matching any context.
ContextPattern	append(Class<?> type) Append a type element to this pattern with multiplicity Multiplicity.ONE.
ContextPattern	append(ContextElementMatcher match) Append an element to this pattern with multiplicity Multiplicity.ONE.
ContextPattern	append(ContextElementMatcher match, Multiplicity mult) Append an element to this pattern.
ContextPattern	append(ContextPattern toAppend) Append a context pattern to this pattern.
ContextPattern	appendDotStar() Return a pattern matching any context of which the current pattern matches a prefix.
static ContextPattern	empty() Create an empty context pattern.
boolean	equals(Object o)
int	hashCode()
ContextMatch	matches(InjectionContext context) Attempt to match this context matcher against the specified context.
static ContextPattern	subsequence(Class<?>... types) Create a context matcher matching any context with the specified subsequence.
static ContextPattern	subsequence(ContextElementMatcher... matchers) Create a context matcher matching any context with a subequence matching the provided matchers.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

empty

public static ContextPattern empty()

Create an empty context pattern.

Returns:

A context pattern matching only the empty context.

any

public static ContextPattern any()

Create a context pattern matching any context.

Returns:

A context pattern matching any context.

subsequence

public static ContextPattern subsequence(Class<?>... types)

Create a context matcher matching any context with the specified subsequence.

Parameters:

types - The subsequence to match.

Returns:

A context matcher that matches any context of which types (with the default qualifier matchers) is a subsequence.

subsequence

public static ContextPattern subsequence(ContextElementMatcher... matchers)

Create a context matcher matching any context with a subequence matching the provided matchers.

Parameters:

matchers - The matchers to match a subsequence.

Returns:

A context matcher that matches any context of which types (with the default qualifier matchers) is a subsequence.

append

public ContextPattern append(ContextElementMatcher match,
                    Multiplicity mult)

Append an element to this pattern. The pattern is not modified; rather, a new pattern extended with the new matching element is returned.

Parameters:

match - The element matcher.

mult - The multiplicity of this element.

Returns:

This pattern extended by the new element.

append

public ContextPattern append(ContextElementMatcher match)

Append an element to this pattern with multiplicity Multiplicity.ONE.

Parameters:

match - The element matcher.

Returns:

This pattern extended by the new element.

append

public ContextPattern append(Class<?> type)

Append a type element to this pattern with multiplicity Multiplicity.ONE.

Parameters:

type - The type to match, passed to ContextElements.matchType(Class).

Returns:

This pattern extended by the new element.

append

public ContextPattern append(ContextPattern toAppend)

Append a context pattern to this pattern.

Parameters:

toAppend - The pattern to append.

Returns:

The concatenation of this pattern and toAppend.

appendDotStar

public ContextPattern appendDotStar()

Return a pattern matching any context of which the current pattern matches a prefix. This is accomplished by adding the .* regular expression token.

Returns:

The new pattern.

matches

public ContextMatch matches(InjectionContext context)

Description copied from interface: ContextMatcher

Attempt to match this context matcher against the specified context. If the matcher matches, it will return a ContextMatch describing the result.

Specified by:

matches in interface ContextMatcher

Parameters:

context - The context to match.

Returns:

The match information, or null if the matcher does not match.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object