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 Rule

Rule.ApplyURI

Field Summary

Fields

Modifier and Type	Field	Description
protected String	_location
private int	_statusCode

Fields inherited from class RegexRule

_regex

Fields inherited from class Rule

_handling, _terminating

Constructor Summary

Constructors

Constructor	Description
RedirectRegexRule()
RedirectRegexRule(String regex, String location)

Method Summary

Modifier and Type	Method	Description
protected String	apply(String target, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Matcher matcher)	Apply this rule to the request/response pair.
void	setLocation(String location)	Sets the redirect location.
void	setReplacement(String replacement)	Deprecated. use setLocation(String) instead.
void	setStatusCode(int statusCode)	Sets the redirect status code.
String	toString()	Returns the redirect status code and replacement.

Methods inherited from class RegexRule

getRegex, matchAndApply, setRegex

Methods inherited from class Rule

isHandling, isTerminating, setHandling, setTerminating

Methods inherited from class Object

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

Field Details

_location

protected String _location

_statusCode

private int _statusCode

Constructor Details

RedirectRegexRule

public RedirectRegexRule()

RedirectRegexRule

public RedirectRegexRule(@Name("regex")
 String regex,
 @Name("location")
 String location)

Method Details

setReplacement

@Deprecated
public void setReplacement(String replacement)

Deprecated.

use setLocation(String) instead.

Parameters:

replacement - the URI to redirect to

setLocation

public void setLocation(String location)

Sets the redirect location.

Parameters:

location - the URI to redirect to

setStatusCode

public void setStatusCode(int statusCode)

Sets the redirect status code.

Parameters:

statusCode - the 3xx redirect status code

apply

protected String apply(String target,
 javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.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