|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.mortbay.component.AbstractLifeCycle
org.mortbay.jetty.handler.AbstractHandler
org.mortbay.jetty.handler.AbstractHandlerContainer
org.mortbay.jetty.handler.HandlerWrapper
org.mortbay.jetty.handler.rewrite.RewriteHandler
public class RewriteHandler
Rewrite handler is responsible for managing the rules. Its capabilities is not only limited for url rewrites such as RewritePatternRule or RewriteRegexRule. There is also handling for cookies, headers, redirection, setting status or error codes whenever the rule finds a match.
The rules can be matched by the ff. options: pattern matching of PathMap (class PatternRule), regular expressions (class RegexRule) or certain conditions set (e.g. MsieSslRule - the requests must be in SSL mode). Here are the list of rules:
<Set name="handler"> <New id="Handlers" class="org.mortbay.jetty.handler.RewriteHandler"> <Set name="rules"> <Array type="org.mortbay.jetty.handler.rules.Rule"> <Item> <New id="rewrite" class="org.mortbay.jetty.handler.rules.RewritePatternRule"> <Set name="pattern">/*</Set> <Set name="replacement">/test</Set> </New> </Item> <Item> <New id="response" class="org.mortbay.jetty.handler.rules.ResponsePatternRule"> <Set name="pattern">/session/</Set> <Set name="code">400</Set> <Set name="reason">Setting error code 400</Set> </New> </Item> <Item> <New id="header" class="org.mortbay.jetty.handler.rules.HeaderPatternRule"> <Set name="pattern">*.jsp</Set> <Set name="name">server</Set> <Set name="value">dexter webserver</Set> </New> </Item> <Item> <New id="header" class="org.mortbay.jetty.handler.rules.HeaderPatternRule"> <Set name="pattern">*.jsp</Set> <Set name="name">title</Set> <Set name="value">driven header purpose</Set> </New> </Item> <Item> <New id="redirect" class="org.mortbay.jetty.handler.rules.RedirectPatternRule"> <Set name="pattern">/test/dispatch</Set> <Set name="location">http://jetty.mortbay.org</Set> </New> </Item> <Item> <New id="regexRewrite" class="org.mortbay.jetty.handler.rules.RewriteRegexRule"> <Set name="regex">/test-jaas/$</Set> <Set name="replacement">/demo</Set> </New> </Item> </Array> </Set> <Set name="handler"> <New id="Handlers" class="org.mortbay.jetty.handler.HandlerCollection"> <Set name="handlers"> <Array type="org.mortbay.jetty.Handler"> <Item> <New id="Contexts" class="org.mortbay.jetty.handler.ContextHandlerCollection"/> </Item> <Item> <New id="DefaultHandler" class="org.mortbay.jetty.handler.DefaultHandler"/> </Item> <Item> <New id="RequestLog" class="org.mortbay.jetty.handler.RequestLogHandler"/> </Item> </Array> </Set> </New> </Set> </New> </Set>
Field Summary |
---|
Fields inherited from class org.mortbay.jetty.handler.AbstractHandler |
---|
_string |
Fields inherited from interface org.mortbay.jetty.Handler |
---|
ALL, DEFAULT, ERROR, FORWARD, INCLUDE, REQUEST |
Constructor Summary | |
---|---|
RewriteHandler()
|
Method Summary | |
---|---|
void |
addRewriteRule(String pattern,
String prefix)
Deprecated. |
void |
addRule(Rule rule)
Add a Rule |
String |
getOriginalPathAttribute()
|
PathMap |
getRewrite()
Deprecated. |
Rule[] |
getRules()
Returns the list of rules. |
void |
handle(String target,
HttpServletRequest request,
HttpServletResponse response,
int dispatch)
Handle a request. |
boolean |
isRewritePathInfo()
|
boolean |
isRewriteRequestURI()
|
void |
setLegacyRule(LegacyRule legacyRule)
To enable configuration from jetty.xml on rewriteRequestURI, rewritePathInfo and originalPathAttribute |
void |
setOriginalPathAttribute(String originalPathAttribte)
|
void |
setRewrite(PathMap rewrite)
Deprecated. |
void |
setRewritePathInfo(boolean rewritePathInfo)
|
void |
setRewriteRequestURI(boolean rewriteRequestURI)
|
void |
setRules(Rule[] rules)
Assigns the rules to process. |
Methods inherited from class org.mortbay.jetty.handler.HandlerWrapper |
---|
addHandler, doStart, doStop, expandChildren, getHandler, removeHandler, setHandler, setServer |
Methods inherited from class org.mortbay.jetty.handler.AbstractHandlerContainer |
---|
expandHandler, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass |
Methods inherited from class org.mortbay.jetty.handler.AbstractHandler |
---|
destroy, getServer, toString |
Methods inherited from class org.mortbay.component.AbstractLifeCycle |
---|
isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, start, stop |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.mortbay.component.LifeCycle |
---|
isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, start, stop |
Constructor Detail |
---|
public RewriteHandler()
Method Detail |
---|
public void setLegacyRule(LegacyRule legacyRule)
legacyRule
- old style rewrite rulepublic Rule[] getRules()
Rule
.public void setRules(Rule[] rules)
rules
- an array of Rule
.public void addRule(Rule rule)
rule
- The rule to add to the end of the rules arraypublic boolean isRewriteRequestURI()
HttpServletRequest.getRequestURI()
.public void setRewriteRequestURI(boolean rewriteRequestURI)
rewriteRequestURI
- true if this handler will rewrite the value
returned by HttpServletRequest.getRequestURI()
.public boolean isRewritePathInfo()
HttpServletRequest.getPathInfo()
.public void setRewritePathInfo(boolean rewritePathInfo)
rewritePathInfo
- true if this handler will rewrite the value
returned by HttpServletRequest.getPathInfo()
.public String getOriginalPathAttribute()
public void setOriginalPathAttribute(String originalPathAttribte)
originalPathAttribte
- If non null, this string will be used
as the attribute name to store the original request path.public PathMap getRewrite()
public void setRewrite(PathMap rewrite)
public void addRewriteRule(String pattern, String prefix)
public void handle(String target, HttpServletRequest request, HttpServletResponse response, int dispatch) throws IOException, ServletException
Handler
handle
in interface Handler
handle
in class HandlerWrapper
target
- The target of the request - either a URI or a name.request
- The request either as the Request
object or a wrapper of that request. The HttpConnection.getCurrentConnection()
method can be used access the Request object if required.response
- The response as the Response
object or a wrapper of that request. The HttpConnection.getCurrentConnection()
method can be used access the Response object if required.dispatch
- The dispatch mode: Handler.REQUEST
, Handler.FORWARD
, Handler.INCLUDE
, Handler.ERROR
IOException
ServletException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |