gembin

OSGi, Eclipse Equinox, ECF, Virgo, Gemini, Apache Felix, Karaf, Aires, Camel, Eclipse RCP

HBase, Hadoop, ZooKeeper, Cassandra

Flex4, AS3, Swiz framework, GraniteDS, BlazeDS etc.

There is nothing that software can't fix. Unfortunately, there is also nothing that software can't completely fuck up. That gap is called talent.

About Me

 

filter过滤器


从J2EE1.3开始,Servlet2.3规范中加入了对过滤器的支持。过滤器能够对目标资源的请求和响应进行截取。
Servlet2.4版本的servlet规范在部属描述符中新增加了一个<dispatcher>元素,这个元素有四个可能的值:即REQUEST, FORWARD,INCLUDE和ERROR,可以在一个<filter-mapping>元素中加入任意数目的< dispatcher>,使得filter将会作用于直接从客户端过来的request,通过forward过来的request,通过 include过来的request和通过<error-page>过来的request。如果没有指定任何< dispatcher >元素,默认值是REQUEST。
过滤器的工作方式分为四种,下面让我们分别来看看这四种过滤器的工作方式:
1、request过滤器
    这种过滤器的工作方式比较简单,大家也经常遇到,如下图所示:

以下是web.xml文件配置方式:
<filter>
    <filter-name>myFilter</filter-name>
    <filter-class>xx.MyFilter</filter-class>
</filter>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源一</servlet-name>
</filter-mapping>
下面我们更改一下web.xml文件的配置,如下方式:
<filter>
    <filter-name>myFilter</filter-name>
    <filter-class>xx.MyFilter</filter-class>
</filter>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源一</servlet-name>
</filter-mapping>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源二</servlet-name>
</filter-mapping>
也就是说此过滤器对目标资源一和目标资源二都进行过滤,然后当目标资源一被访问的时候我们将请求转发给目标资源二,那么这个时候过滤器是怎么工作的呢?如下图所示:


 我们可以看到,当我们访问目标资源一时过滤器截取了请求,然后再转发给目标资源一,然后再转发给目标资源二,从图中我们可以看到过滤器没有截取转发到目标资源二的请求,但是我们已经在web.xml文件中配置了该过滤器对目标资源二的过滤,为什么又没有起到过滤作用呢?
    答案就在于,目标资源一是客户端直接访问,而目标资源二是被转发过来的,这时过滤器就不能过滤目标资源二。如果你直接访问目标资源二,你会发现该过滤器起到了作用?
    我们上面的web.xml文件配置与以下方式等价:
<filter>myFilter</filter>
    <filter-name>myFilter</filter-name>
    <filter-class>xx.MyFilter</filte-class>
</filter>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源一</servlet-name>
  <dispatcher>REQUEST</dispatcher>
</filter-mapping>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源二</servlet-name>
  <dispatcher>REQUEST</dispatcher>
</filter-mapping>
这种方式的配置,说明只有直接访问该目标资源时该过滤器才会起作用,对转发到该目标资源的请求将忽略不处理。
    那如果我想对转发到目标资源二的请求进行过滤,那怎么办呢?答案见,下一种过滤器,forward过滤器。

2、forward过滤器
    我们将web.xml文件的配置修改如下:
<filter>myFilter</filter>
    <filter-name>myFilter</filter-name>
    <filter-class>xx.MyFilter</filter-class>
</filter>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源一</servlet-name>
  <dispatcher>REQUEST</dispatcher>
</filter-mapping>
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源二</servlet-name>
  <dispatcher>FORWARD</dispatcher>
</filter-mapping>
工作方式如下图所示:


我们看对目标资源二过滤的配置方式,这时过滤方式为forward,也就是说对转发到目标资源二的请求过滤,如果直接访问目标资源二,过滤器将不起作用。

3、include过滤器
    理解了forward过滤器之后,include过滤器就不难理解了。以下方式:
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <servlet-name>目标资源二</servlet-name>
  <dispatcher>INCLUDE</dispatcher>
</filter-mapping>
    此表示对包含了目标资源二的请求过滤,如果直接访问目标资源二,则此过滤器将不起作用。
    include包含以下语句:
    在JSP页面中的动作:<jsp:include page=.......
    在Java代码中的request.getRequestDispatcher("....").include
    注意:如果目标资源一通过<%@ include file="目标资源二"%>指令包含,这时此过滤器不工作。后面给大家介绍指令包含和动作包含的区别。

4、error过滤器
    当我们访问一个web目标资源时,如果服务器没有找到该目标资源,那么服务器就会给出一个404错误代码。如果我们给404错误代码定义一个页面,那么当404错误发生时就会调用该页面,请看以下web.xml文件的配置:
<filter-mapping>
  <filter-name>myFilter</filter-name>
  <url-pattern>/error.jsp</url-pattern>
  <dispatcher>ERROR</dispatcher>
</filter-mapping>
<error-page>
    <error-code>404</error-code>
    <location>/error.jsp</location>
</error-page>
    当我们访问一个不存在的文件时,就会访问error.jsp,但是配置了过滤器对错误页面进行过滤,所以过滤器先接受到请求,然后再转发给error.jsp。

    如果我们访问一个已经存在的页面,会不会调用error.jsp呢?如果这个页面中有response.sendError(404,"出错了!");那么该错误页面仍然会被调用,过滤器也会工作.



filter-mapping元素
filter-mapping元素用来声明Web应用中的过滤器映射。过滤器可被映射到一个servlet或一个URL模式。将过滤器映射到一个 servlet中会造成过滤器作用于servlet上。将过滤器映射到一个URL模式中则可以将过滤器应用于任何资源,只要该资源的URL与URL模式匹 配。过滤是按照部署描述符的filter-mapping元素出现的顺序执行的。

<!ELEMENT filter-mapping (filter-name, (url-pattern | servlet-name))>

<!ELEMENT filter-name (#PCDATA)>

<!ELEMENT url-pattern (#PCDATA)>

<!ELEMENT servlet-name (#PCDATA)>

filter-name值必须对应filter元素中声明的其中一个过滤器名称。下面是一个含有filter-mapping元素的部署描述符:

<?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.brainysoftware.EncryptionFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>Encryption Filter</filter-name>
<servlet-name>EncryptionFilteredServlet</servlet-name>
</filter-mapping>
</web-app>

Example:

...
6        <filter> 
7
<filter-name>helloWorld</filter-name>
8
<filter-class>com.acme.filter.HelloWorldFilter</filter-class>
9
</filter>
10
<filter>
11
<filter-name>message</filter-name>
12
<filter-class>com.acme.filter.MessageFilter</filter-class>
13
<init-param>
14
<param-name>message</param-name>
15
<param-value>A message to you!</param-value>
16
</init-param>
17
</filter>
18
<filter>
19
<filter-name>prePost</filter-name>
20
<filter-class>com.acme.filter.PrePostFilter</filter-class>
21
</filter>
22
<filter>
23
<filter-name>imageManipulator</filter-name>
24
<display-name>imageManipulator</display-name>
25
<filter-class>com.acme.filter.ImageFilter</filter-class>
26
<init-param>
27
<param-name>message</param-name>
28
<param-value>test</param-value>
29
</init-param>
30
</filter>
31
<filter>
32
<filter-name>gzip</filter-name>
33
<filter-class>com.acme.filter.GZIPFilter</filter-class>
34
</filter>
35
<filter-mapping>
36
<filter-name>helloWorld</filter-name>
37
<url-pattern>/filter.jsp</url-pattern>
38
</filter-mapping>
39
<filter-mapping>
40
<filter-name>message</filter-name>
41
<url-pattern>/filter2.jsp</url-pattern>
42
</filter-mapping>
43
<filter-mapping>
44
<filter-name>prePost</filter-name>
45
<url-pattern>/filter3.jsp</url-pattern>
46
</filter-mapping>
47
<filter-mapping>
48
<filter-name>imageManipulator</filter-name>
49
<url-pattern>/*.jpg</url-pattern>
50
</filter-mapping>
51
<filter-mapping>
52
<filter-name>gzip</filter-name>
53
<url-pattern>/*.jsp</url-pattern>
54
</filter-mapping>

posted on 2008-05-27 00:42 gembin 阅读(1905) 评论(1)  编辑  收藏 所属分类: JavaEE

评论

# re: filter过滤器 2012-03-16 17:05 zhugl

这样配置后,jsp:include的url还是经过filter.....
而且只当前jsp中include的经过,被include的jsp中如果继续include则不经过....不知道为什么,崩溃了  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航:
 

导航

统计

常用链接

留言簿(6)

随笔分类(440)

随笔档案(378)

文章档案(6)

新闻档案(1)

相册

收藏夹(9)

Adobe

Android

AS3

Blog-Links

Build

Design Pattern

Eclipse

Favorite Links

Flickr

Game Dev

HBase

Identity Management

IT resources

JEE

Language

OpenID

OSGi

SOA

Version Control

最新随笔

搜索

积分与排名

最新评论

阅读排行榜

评论排行榜

free counters