服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

使用web.xml控制web应用的行为二


  5.3 提供应用范围内的初始化参数
  
  一般,对单个地servlet或jsp页面分配初始化参数。指定的servlet或jsp页面利用servletconfig的getinitparameter方法读取这些参数。但是,在某些情形下,希望提供可由任意servlet或jsp页面借助servletcontext的getinitparameter方法读取的系统范围内的初始化参数。
  
  可利用context-param元素声明这些系统范围内的初始化值。context-param元素应该包含param-name、param-value以及可选的description子元素,如下所示:
  
  
  support-email
  blackhole@mycompany.com
  

  
  可回忆一下,为了保证可移植性,web.xml内的元素必须以正确的次序声明。但这里应该注意,context-param元素必须出现任意与文档有关的元素(icon、display-name或description)之后及filter、filter-mapping、listener或 servlet元素之前。
  
  5.4 在服务器启动时装载servlet
  
  假如servlet或jsp页面有一个要花很长时间执行的init (servlet)或jspinit(jsp)方法。例如,假如init或jspinit方法从某个数据库或resourcebundle查找产量。这种情况下,在第一个客户机请求时装载servlet的缺省行为将对第一个客户机产生较长时间的延迟。因此,可利用servlet的load-on- startup元素规定服务器在第一次启动时装载servlet。下面是一个例子。
  
  
  
  
  
  

  
  可以为此元素体提供一个整数而不是使用一个空的load-on-startup。想法是服务器应该在装载较大数目的servlet或jsp页面之前装载较少数目的servlet或jsp页面。例如,下面的servlet项(放置在web应用的web-inf目录下的web.xml文件中的web-app元素内)将指示服务器首先装载和初始化searchservlet,然后装载和初始化由位于web应用的result目录中的index.jsp文件产生的 servlet。
  
  
  search
  mypackage.searchservlet
  1
  

  
  results
  /results/index.jsp
  2
  

  
  6 声明过滤器
  
  servlet版本2.3引入了过滤器的概念。虽然所有支持servlet api版本2.3的服务器都支持过滤器,但为了使用与过滤器有关的元素,必须在web.xml中使用版本2.3的dtd。
  
  过滤器可截取和修改进入一个servlet或jsp页面的请求或从一个servlet或jsp页面发出的相应。在执行一个servlet或jsp页面之前,必须执行第一个相关的过滤器的dofilter方法。在该过滤器对其filterchain对象调用dofilter时,执行链中的下一个过滤器。如果没有其他过滤器,servlet或jsp页面被执行。过滤器具有对到来的servletrequest对象的全部访问权,因此,它们可以查看客户机名、查找到来的cookie等。为了访问servlet或jsp页面的输出,过滤器可将响应对象包裹在一个替身对象(stand-in object)中,比方说把输出累加到一个缓冲区。在调用filterchain对象的dofilter方法之后,过滤器可检查缓冲区,如有必要,就对它进行修改,然后传送到客户机。
  
  例如,程序清单5-11帝国难以了一个简单的过滤器,只要访问相关的servlet或jsp页面,它就截取请求并在标准输出上打印一个报告(开发过程中在桌面系统上运行时,大多数服务器都可以使用这个过滤器)。
  
  程序清单5-11 reportfilter.java
  
  package moreservlets;
  
  import java.io.*;
  import javax.servlet.*;
  import javax.servlet.http.*;
  import java.util.*;
  
  /** simple filter that prints a report on the standard output
  * whenever the associated servlet or jsp page is accessed.
  *


  * taken from more servlets and javaserver pages
  * from prentice hall and sun microsystems press,
  * http://www.moreservlets.com/.
  * © 2002 marty hall; may be freely used or adapted.
  */
  
  public class reportfilter implements filter {
  public void dofilter(servletrequest request,
  servletresponse response,
  filterchain chain)
  throws servletexception, ioexception {
  httpservletrequest req = (httpservletrequest)request;
  system.out.println(req.getremotehost() +
  " tried to access " +
  req.getrequesturl() +
  " on " + new date() + ".");
  chain.dofilter(request,response);
  }
  
  public void init(filterconfig config)
  throws servletexception {
  }
  
  public void destroy() {}
  }
  
  一旦建立了一个过滤器,可以在web.xml中利用filter元素以及filter-name(任意名称)、file-class(完全限定的类名)和(可选的)init-params子元素声明它。请注意,元素在web.xml的web-app元素中出现的次序不是任意的;允许服务器(但不是必需的)强制所需的次序,并且实际中有些服务器也是这样做的。但这里要注意,所有filter元素必须出现在任意filter-mapping元素之前, filter-mapping元素又必须出现在所有servlet或servlet-mapping元素之前。
  
  例如,给定上述的reportfilter类,可在web.xml中作出下面的filter声明。它把名称reporter与实际的类reportfilter(位于moreservlets程序包中)相关联。
  
  
  reporter
  moresevlets.reportfilter
  

  
  一旦命名了一个过滤器,可利用filter-mapping元素把它与一个或多个servlet或jsp页面相关联。关于此项工作有两种选择。
  
  首先,可使用filter-name和servlet-name子元素把此过滤器与一个特定的servlet名(此servlet名必须稍后在相同的 web.xml文件中使用servlet元素声明)关联。例如,下面的程序片断指示系统只要利用一个定制的url访问名为someservletname 的servlet或jsp页面,就运行名为reporter的过滤器。
  
  
  reporter
  someservletname
  

  
  其次,可利用filter-name和url-pattern子元素将过滤器与一组servlet、jsp页面或静态内容相关联。例如,相面的程序片段指示系统只要访问web应用中的任意url,就运行名为reporter的过滤器。
  
  
  reporter
  /*
  

  
  例如,程序清单5-12给出了将reportfilter过滤器与名为pagename的servlet相关联的web.xml文件的一部分。名字 pagename依次又与一个名为testpage.jsp的jsp页面以及以模式http: //host/webappprefix/urltest2/ 开头的url相关联。testpage.jsp的源代码已经jsp页面命名的谈论在前面的3节"分配名称和定制的url"中给出。事实上,程序清单5- 12中的servlet和servlet-name项从该节原封不动地拿过来的。给定这些web.xml项,可看到下面的标准输出形式的调试报告(换行是为了容易阅读)。
  
  audit.irs.gov tried to access
  http://mycompany.com/deploydemo/urltest2/business/tax-plan.html
  on tue dec 25 13:12:29 edt 2001.
  
  程序清单5-12 web.xml(说明filter用法的摘录)
  
  
    public "-//sun microsystems, inc.//dtd web application 2.3//en"
  "http://java.sun.com/dtd/web-app_2_3.dtd">
  
  
  
  reporter
  moresevlets.reportfilter
  

  
  
  reporter
  pagename
  

  
  
  pagename
  /realpage.jsp
  

  
  
   pagename
  /urltest2/*
  

  
  

  
  7 指定欢迎页
  
  假如用户提供了一个像http: //host/webappprefix/directoryname/ 这样的包含一个目录名但没有包含文件名的url,会发生什么事情呢?用户能得到一个目录表?一个错误?还是标准文件的内容?如果得到标准文件内容,是 index.html、index.jsp、default.html、default.htm或别的什么东西呢?
  
  welcome-file-list 元素及其辅助的welcome-file元素解决了这个模糊的问题。例如,下面的web.xml项指出,如果一个

扫描关注微信公众号