filter元素

filter元素用於指定Web容器中的過濾器。在請求和回響對象被servlet處理之前或之後，可以使用過濾器對這兩個對象進行操作。利用下一節介紹的filter-mapping元素，過濾器被映射到一個servlet或一個URL模式。這個過濾器的filter元素和filter-mapping元素必須具有相同的名稱。

簡介

<!ELEMENT filter (icon?, filter-name, display-name?, description?,

filter-class, init-param*)>

<!ELEMENT filter-name (#PCDATA)>

<!ELEMENT filter-class (#PCDATA)>

icon、display-name和description元素的用法和上一節介紹的用法相同。init-param元素與context-param元素具有相同的元素描述符。filter-name元素用來定義過濾器的名稱，該名稱在整個套用中都必須是惟一的。filter-class元素指定過濾器類的完全限定的名稱。

舉例

部署描述符

下面是一個使用filter元素的部署描述符的例子：

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun. com/dtd/web-app_2_3.dtd">

<web-app>

<filter>

<filter-name>Encryption Filter</filter-name>

<filter-class>com.branysoftware.EncryptionFilter</filter-class>

</filter>

</web-app>

filter元素用來聲明filter的相關設定.filter元素除了下面介紹的的子元素之外,還包括<servlet>介紹過的<icon>,<display-name>

,<description>,<init-param>,其用途一樣.

<filter-name>Filter的名稱</filter-name>

定義Filter的名稱.

<filter-class>Filter的類名稱</filter-class>

定義Filter的類名稱.例如:com.foo.hello

</filter>

範例:

<filter>

<filter-name>setCharacterEncoding</filter-name>

<filter-class>coreservlet.javaworld. CH11.SetCharacterEncodingFilter</filter-class>

<init-param>

<param-name>encoding</param-name>

<param-value>GB2312</param-value>

</init-param>

</filter>