gembin

OSGi JSF Eclipse RCP

 

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 阅读(76) 评论(0)  编辑  收藏 所属分类: JavaEE


标题  
姓名  
主页
验证码 *  
内容(请不要发表任何与政治相关的内容)  
  登录  使用高级评论  新用户注册  返回页首  恢复上次提交      
 




导航

统计

常用链接

留言簿(2)

随笔分类(215)

随笔档案(207)

文章档案(1)

新闻档案(1)

相册

收藏夹(1)

Favorite Links

最新随笔

搜索

积分与排名

最新评论

阅读排行榜

评论排行榜

60天内阅读排行