org.eclipse.jetty.rewrite.handler

Class RedirectRegexRule

java.lang.Object

org.eclipse.jetty.rewrite.handler.Rule

org.eclipse.jetty.rewrite.handler.RegexRule

org.eclipse.jetty.rewrite.handler.RedirectRegexRule

public class RedirectRegexRule
extends RegexRule

Issues a (3xx) Redirect response whenever the rule finds a match via regular expression.

The replacement string may use $n" to replace the nth capture group.

All redirects are part of the 3xx Redirection status code set.

Defaults to 302 Found

Nested Class Summary

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

Rule.ApplyURI

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_replacement

Fields inherited from class org.eclipse.jetty.rewrite.handler.RegexRule

_regex

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

_handling, _terminating

Constructor Summary

Constructors

Constructor and Description
RedirectRegexRule()

Method Summary

Modifier and Type	Method and Description
protected String	apply(String target, HttpServletRequest request, HttpServletResponse response, Matcher matcher) Apply this rule to the request/response pair.
void	setReplacement(String replacement) Whenever a match is found, it replaces with this value.
void	setStatusCode(int statusCode) Sets the redirect status code.
String	toString() Returns the redirect status code and replacement.

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

getRegex, matchAndApply, setRegex

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

isHandling, isTerminating, setHandling, setTerminating

Methods inherited from class java.lang.Object

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

Field Detail

_replacement

protected String _replacement

Constructor Detail

RedirectRegexRule

public RedirectRegexRule()

Method Detail

setReplacement

public void setReplacement(String replacement)

Whenever a match is found, it replaces with this value.

Parameters:

replacement - the replacement string.

setStatusCode

public void setStatusCode(int statusCode)

Sets the redirect status code.

Parameters:

statusCode - the 3xx redirect status code

apply

protected String apply(String target,
                       HttpServletRequest request,
                       HttpServletResponse response,
                       Matcher matcher)
                throws IOException

Description copied from class: RegexRule

Apply this rule to the request/response pair. Called by RegexRule.matchAndApply(String, HttpServletRequest, HttpServletResponse) if the regex matches.

Specified by:

apply in class RegexRule

Parameters:

target - field to attempt match

request - request object

response - response object

matcher - The Regex matcher that matched the request (with capture groups available for replacement).

Returns:

The target (possible updated).

Throws:

IOException - exceptions dealing with operating on request or response objects

toString

public String toString()

Returns the redirect status code and replacement.

Overrides:

toString in class RegexRule