Class ValidUrlRule

java.lang.Object

org.eclipse.jetty.rewrite.handler.Rule

org.eclipse.jetty.rewrite.handler.ValidUrlRule

public class ValidUrlRule
extends Rule

This rule can be used to protect against invalid unicode characters in a url making it into applications.

The logic is as follows.

• if decoded uri character is an iso control character return code/reason
• if no UnicodeBlock is found for character return code/reason
• if character is in UnicodeBlock.SPECIALS return code/reason

Nested Class Summary

Nested classes/interfaces inherited from class Rule

Rule.ApplyURI

Field Summary

Fields

Modifier and Type	Field	Description
(package private) String	_code
(package private) String	_reason
private static final Logger	LOG

Fields inherited from class Rule

_handling, _terminating

Constructor Summary

Constructors

Constructor	Description
ValidUrlRule()

Method Summary

Modifier and Type	Method	Description
protected boolean	isValidChar(int codepoint)
String	matchAndApply(String target, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)	This method calls tests the rule against the request/response pair and if the Rule applies, then the rule's action is triggered.
void	setCode(String code)	Sets the response status code.
void	setReason(String reason)	Sets the reason for the response status code.
String	toString()	Returns the handling and terminating flag values.

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

LOG

private static final Logger LOG

_code

String _code

_reason

String _reason

Constructor Details

ValidUrlRule

public ValidUrlRule()

Method Details

setCode

public void setCode(String code)

Sets the response status code.

Parameters:

code - response code

setReason

public void setReason(String reason)

Sets the reason for the response status code. Reasons will only reflect if the code value is greater or equal to 400.

Parameters:

reason - the reason

matchAndApply

public String matchAndApply(String target,
 javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.HttpServletResponse response)
                     throws IOException

Description copied from class: Rule

This method calls tests the rule against the request/response pair and if the Rule applies, then the rule's action is triggered.

Specified by:

matchAndApply in class Rule

Parameters:

target - The target of the request

request - the request

response - the response

Returns:

The new target if the rule has matched, else null

Throws:

IOException - if unable to match the rule

isValidChar

protected boolean isValidChar(int codepoint)

toString

public String toString()

Description copied from class: Rule

Returns the handling and terminating flag values.

Overrides:

toString in class Rule