Module org.eclipse.jetty.rewrite

Package org.eclipse.jetty.rewrite.handler

Class RegexRule

java.lang.Object

org.eclipse.jetty.rewrite.handler.Rule

org.eclipse.jetty.rewrite.handler.RegexRule

Direct Known Subclasses:

HeaderRegexRule, RedirectRegexRule, RewriteRegexRule, TerminatingRegexRule

public abstract class RegexRule
extends Rule

Abstract rule that uses the regular expression syntax for path pattern matching.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.rewrite.handler.Rule

Rule.Handler, Rule.HttpURIHandler

Constructor Summary

Constructors

Constructor	Description
RegexRule()
RegexRule(String pattern)

Method Summary

Modifier and Type	Method	Description
protected abstract Rule.Handler	apply(Rule.Handler input, Matcher matcher)	Invoked after the regular expression matched the URI path to apply the rule's logic.
String	getRegex()
Rule.Handler	matchAndApply(Rule.Handler input)	Tests whether the given Request should apply, and if so the rule logic is triggered.
void	setRegex(String regex)	Sets the regular expression to match with the request path.
String	toString()	Returns the handling and terminating flag values.

Methods inherited from class org.eclipse.jetty.rewrite.handler.Rule

isTerminating, setTerminating

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

RegexRule

public RegexRule()

RegexRule

public RegexRule(String pattern)

Method Details

getRegex

public String getRegex()

Returns:

the regular expression

setRegex

public void setRegex(String regex)

Sets the regular expression to match with the request path.

Parameters:

regex - the regular expression

matchAndApply

public Rule.Handler matchAndApply(Rule.Handler input)
                           throws IOException

Description copied from class: Rule

Tests whether the given Request should apply, and if so the rule logic is triggered.

Specified by:

matchAndApply in class Rule

Parameters:

input - the input Request and Handler

Returns:

the possibly wrapped Request and Handler, or null if the rule did not match

Throws:

IOException - if applying the rule failed

apply

protected abstract Rule.Handler apply(Rule.Handler input,
 Matcher matcher)
                               throws IOException

Invoked after the regular expression matched the URI path to apply the rule's logic.

Parameters:

input - the input Request and Handler

matcher - the Matcher that matched the request path, with capture groups available for replacement.

Returns:

the possibly wrapped Request and Handler

Throws:

IOException - if applying the rule failed

toString

public String toString()

Description copied from class: Rule

Returns the handling and terminating flag values.

Overrides:

toString in class Rule