com.jdon.util

类 SetCharacterEncodingFilter

java.lang.Object

com.jdon.util.SetCharacterEncodingFilter

所有已实现的接口:

javax.servlet.Filter

public class SetCharacterEncodingFilter
extends Object
implements javax.servlet.Filter

Filter that sets the character encoding to be used in parsing the incoming request, either unconditionally or only if the client did not specify a character encoding. Configuration of this filter is based on the following initialization parameters:

• encoding - The character encoding to be configured for this request, either conditionally or unconditionally based on the ignore initialization parameter. This parameter is required, so there is no default.
• ignore - If set to "true", any character encoding specified by the client is ignored, and the value returned by the selectEncoding() method is set. If set to "false, selectEncoding() is called only if the client has not already specified an encoding. By default, this parameter is set to "true".

Although this filter can be used unchanged, it is also easy to subclass it and make the selectEncoding() method more intelligent about what encoding to choose, based on characteristics of the incoming request (such as the values of the Accept-Language and User-Agent headers, or a value stashed in the current user's session.

版本:

$Id: SetCharacterEncodingFilter.java,v 1.1.1.1 2004/12/26 09:07:46 jdon Exp $

作者:

John Wong

字段概要

字段

限定符和类型	字段和说明
protected String	encoding The default character encoding to set for requests that pass through this filter.
protected javax.servlet.FilterConfig	filterConfig The filter configuration object we are associated with.
protected boolean	ignore Should a character encoding specified by the client be ignored?

构造器概要

构造器

构造器和说明
SetCharacterEncodingFilter()

方法概要

限定符和类型	方法和说明
void	destroy() Take this filter out of service.
void	doFilter(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, javax.servlet.FilterChain chain) Select and set (if specified) the character encoding to be used to interpret request parameters for this request.
void	init(javax.servlet.FilterConfig filterConfig) Place this filter into service.
protected String	selectEncoding(javax.servlet.ServletRequest request) Select an appropriate character encoding to be used, based on the characteristics of the current request and/or filter initialization parameters.

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

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

字段详细资料

encoding

protected String encoding

The default character encoding to set for requests that pass through this filter.

filterConfig

protected javax.servlet.FilterConfig filterConfig

The filter configuration object we are associated with. If this value is null, this filter instance is not currently configured.

ignore

protected boolean ignore

Should a character encoding specified by the client be ignored?

构造器详细资料

SetCharacterEncodingFilter

public SetCharacterEncodingFilter()

方法详细资料

destroy

public void destroy()

Take this filter out of service.

指定者:

destroy 在接口中 javax.servlet.Filter

doFilter

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

Select and set (if specified) the character encoding to be used to interpret request parameters for this request.

指定者:

doFilter 在接口中 javax.servlet.Filter

参数:

request - The servlet request we are processing

result - The servlet response we are creating

chain - The filter chain we are processing

抛出:

IOException - if an input/output error occurs

javax.servlet.ServletException - if a servlet error occurs

init

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

Place this filter into service.

指定者:

init 在接口中 javax.servlet.Filter

参数:

filterConfig - The filter configuration object

抛出:

javax.servlet.ServletException

selectEncoding

protected String selectEncoding(javax.servlet.ServletRequest request)

Select an appropriate character encoding to be used, based on the characteristics of the current request and/or filter initialization parameters. If no character encoding should be set, return null.

The default implementation unconditionally returns the value configured by the encoding initialization parameter for this filter.

参数:

request - The servlet request we are processing