org.tuckey.web.filters.urlrewrite

类 UrlRewriteFilter

java.lang.Object

org.tuckey.web.filters.urlrewrite.UrlRewriteFilter

所有已实现的接口:

javax.servlet.Filter

public class UrlRewriteFilter
extends java.lang.Object
implements javax.servlet.Filter

Based on the popular and very useful mod_rewrite for apache, UrlRewriteFilter is a Java Web Filter for any J2EE compliant web application server (such as Resin or Tomcat), which allows you to rewrite URLs before they get to your code. It is a very powerful tool just like Apache's mod_rewrite. The main things it is used for are:

• URL Tidyness - keep URLs tidy irrespective of the underlying technology (JSPs, servlets, struts etc).
• Browser Detection - Allows you to rewrite URLs based on request HTTP headers (such as "user-agent").
• Date based rewriting - Allows you to forward or redirect to other URL's based on the date/time.

UrlRewriteFilter uses an xml file, called urlrewrite.xml (lives in the WEB-INF directory), for configuration. Most parameters can be Perl5 style Regular Expressions or Wildcards (i.e. *). This makes it very powerful indeed. Special thanks to all those who gave patches/feedback especially Vineet Kumar. Thanks also to Ralf S. Engelschall (www.engelschall.com) the inventor of mod_rewrite.

版本:

$Revision: 51 $ $Date: 2006-12-08 11:37:07 +1300 (Fri, 08 Dec 2006) $

作者:

Paul Tuckey

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	DEFAULT_MOD_REWRITE_STYLE_CONF_PATH
static java.lang.String	DEFAULT_WEB_CONF_PATH

构造器概要

构造器

构造器和说明
UrlRewriteFilter()

方法概要

限定符和类型	方法和说明
static void	addRuleUrl(java.lang.String fromPath, java.lang.String toPath)
void	destroy() Destroy is called by the application server when it unloads this filter.
void	destroyActual()
void	doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain) The main method called for each request that this filter is mapped for.
int	getConfReloadCheckInterval() The amount of seconds between reload checks.
java.util.Date	getConfReloadLastCheck()
static java.lang.String	getFullVersionString()
static UrlRewriteFilter	getInstance()
java.lang.String	getStatusPath()
void	init(javax.servlet.FilterConfig filterConfig) Init is called automatically by the application server when it creates this filter.
boolean	isConfReloadCheckEnabled()
boolean	isLoaded()
boolean	isStatusEnabled()
boolean	isTimeToReloadConf() Is it time to reload the configuration now.
java.lang.String	reCheckConfPath(java.lang.String confPath)
void	reloadConf() Forcibly reload the configuration now.
static void	removeRuleUrl(java.lang.String fromPath)

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

DEFAULT_WEB_CONF_PATH

public static final java.lang.String DEFAULT_WEB_CONF_PATH

另请参阅:

常量字段值

DEFAULT_MOD_REWRITE_STYLE_CONF_PATH

public static final java.lang.String DEFAULT_MOD_REWRITE_STYLE_CONF_PATH

另请参阅:

常量字段值

构造器详细资料

UrlRewriteFilter

public UrlRewriteFilter()

方法详细资料

getInstance

public static UrlRewriteFilter getInstance()

init

public void init(javax.servlet.FilterConfig filterConfig)
          throws javax.servlet.ServletException

Init is called automatically by the application server when it creates this filter.

指定者:

init 在接口中 javax.servlet.Filter

参数:

filterConfig - The config of the filter

抛出:

javax.servlet.ServletException

reCheckConfPath

public java.lang.String reCheckConfPath(java.lang.String confPath)

destroy

public void destroy()

Destroy is called by the application server when it unloads this filter.

指定者:

destroy 在接口中 javax.servlet.Filter

destroyActual

public void destroyActual()

doFilter

public void doFilter(javax.servlet.ServletRequest request,
                     javax.servlet.ServletResponse response,
                     javax.servlet.FilterChain chain)
              throws java.io.IOException,
                     javax.servlet.ServletException

The main method called for each request that this filter is mapped for.

指定者:

doFilter 在接口中 javax.servlet.Filter

参数:

request - the request to filter

response - the response to filter

chain - the chain for the filtering

抛出:

java.io.IOException - IOException

javax.servlet.ServletException - ServletException

isTimeToReloadConf

public boolean isTimeToReloadConf()

Is it time to reload the configuration now. Depends on is conf reloading is enabled.

返回:

boolean

reloadConf

public void reloadConf()

Forcibly reload the configuration now.

isConfReloadCheckEnabled

public boolean isConfReloadCheckEnabled()

getConfReloadCheckInterval

public int getConfReloadCheckInterval()

The amount of seconds between reload checks.

返回:

int number of millis

getConfReloadLastCheck

public java.util.Date getConfReloadLastCheck()

isStatusEnabled

public boolean isStatusEnabled()

getStatusPath

public java.lang.String getStatusPath()

isLoaded

public boolean isLoaded()

addRuleUrl

public static void addRuleUrl(java.lang.String fromPath,
                              java.lang.String toPath)

removeRuleUrl

public static void removeRuleUrl(java.lang.String fromPath)

getFullVersionString

public static java.lang.String getFullVersionString()