java web.xml详解

来源：互联网发布：vscode 源代码管理编辑：程序博客网时间：2024/06/13 14:10

容易忘的东西，记录下来，对自己对别人都有帮助

正文

struts1 web.xml配置

web.xml文件对于配置任何Java Web应用都必需的。
（1）配置Struts的ActionServlet

<servlet>元素来声明ActionServlet
<servlet-name>元素：用来定义Servlet的名称
<servlet-class>元素:用来指定Servlet的完整类名

<servlet><servlet-name>action</servlet-name><servlet-class>org.apache.struts.action.ActionServlet</servlet-class></servlet>

还要配置<servlet-mapping>元素,它用来指定ActionServlet可以处理哪些URL

<servlet-mapping><servlet-name>action</servlet-name><url-pattern>*.do</url-pattern></servlet-mapping>

注意:(1)<servlet-mapping>和<servlet>中的<servlet- name>?</servlet-name>的要填写一致，它就是一根线，把<servlet-mapping> 和<servlet>联接在一起的。
(2)在Struts框架中只能有一个Servlet,因为Servlet支持多线程。而<servlet- class>org.apache.struts.action.ActionServlet</servlet-class>中的 ActionServlet是在Struts.jar包中的.在导入Struts包时会导入。
(3)在显示层所有以*.do为扩展名提交的URL，都会交由这个Servlet来处理。*.do可以改写成你想要的任何形式，例如:/do/* ，此时该Servlet会处理所有以"/do"为前缀的URL，如http://localhost:8080/helloapp/do /helloWord,
扩展 (1)我们可以继承 org.apache.struts.action.ActionServlet 得到我们可以扩展的子类，在子类中重写一个方法init()。这时<servlet-class>?</servlet- class>中的？是我们新建的类的路径，同样只能存在一个。
(2)声明ActionServlet的初始化参数
初始化参数用来对Servlet的运行时环境进行初始配置。<servlet>的<init-param>子元素用于配置Servlet初始化参数。

config ：以相对路径的方式指明Struts应用程序的配置文件位置,如不设置，则默认值为/WEB-INF/struts-config.xml
debug : 设置Servlet的debug级别,控制日志记录的详细程度。默认为0，记录相对最少的日志信息。
detail : 设置Digester的debug级别，Digester是Struts框架所使用的用来解析xml配置文件的一个框架，通过此设置，可以查看不同详细等级的解析日志。默认为0，记录相对最少的日志信息。
<load-on-startup>？</load-on-startup>中？号的值是此ActionServlet在服务器开启时加载的次序，数值越低，越先加载。

<servlet><servlet-name>action</servlet-name><servlet-class>org.apache.struts.action.ActionServlet</servlet-class><init-param><param-name>config</param-name><param-value>/WEB-INF/struts-config.xml</param-value></init-param><init-param><param-name>debug</param-name><param-value>3</param-value></init-param><init-param><param-name>detail</param-name><param-value>3</param-value></init-param><load-on-startup>0</load-on-startup></servlet>

扩展：(1)当服务器启动后，加载ActionServlet，而ActionServlet会调用相关的方法去，会根据它下面的参数的初始值，对这个ActionServlet中的参数时行初始化
(2)当多人协作开发项目时可以对Strutst的配置文件进行适当的扩充，但必须为config开头。如

<init-param><param-name>config/XXXXXXXXX</param-name><param-value>/WEB-INF/XXXXX.xml</param-value></init-param>

(3) 配置欢迎文件清单
当客户访问Web应用时，如果仅仅给出Web应用的Root URL,没有指定具体的文件名。Web容器会自动调用Web应用的欢迎文件。<welcome-file-list>是用来设置此项.

<welcome-file-list><welcome-file>welcome.jsp</welcome-file></welcome-file-list>

说明:在<welcome-file-list> 下可以有多个<welcom-file>。Web容器会依次寻找欢迎界面，直到找到为止。但如果不存在会向客户端返回”HTTP 404 NOT Found“错误信息。

由于在<welcome-file-list>元素中不能配置Servlet映射，则不能直接把Struts的Action作为欢迎文件。但可以通过Struts中的全局的(global)转发项来配置。
A：welcome.jsp页面(可换文件名)

<%@ taglib uri="http://jakarta.apache.org/struts/tags-logic" prefix="logic"%><html><body><logic:forward name="welcome"/></body></html>

B: web.xml

<welcome-file-list><welcome-file>welcome.jsp</welcome-file></welcome-file-list>

C: struts-config.xml

<global-forwards><forward name="welcome" path="hello.do"></global-forwards>

(4)配置错误处理
Struts框架中不能处理所有的错误或异常。当Struts框架发生不能处理所有的错误或异常时，就把错误抛给Web容器。在默认情况下，Web容器会向用户浏览器直接返回原始的错误，为了避免可以使用<error-page>。

<erro-page><error-code>4040</error-code><location>/commmon/404.jsp</location></error-page><erro-page><error-code>4040</error-code><location>/commmon/404.jsp</location></error-page>

Weg容器捕获的Java异常配置<error-page>，这时需要设置<exception-type>子元素，它用于指定Java异常类。Web容器可能捕获如下的异常:
RuntimeException 或 Error
ServletException 或它的子类
IOException　或它的子类

<error-page><exception-type>javax.servlet.ServletException</exception-type><location>/system_error.jsp</location></error-page><error-page><exception-type>java.io.IOException</exception-type><location>/system_ioerror.jsp</location></error-page>

(5)配置Struts标签库
Struts框架提供了一些实用的客户化标签标签库,如果在应用中使用可以在web.xml中配置

<taglib><taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri><taglib-location>/WEB-INF/struts-bean.tld</taglib-location></taglib>

<taglib>元素有两个子元素：<taglib-uri>和<taglib- location>.<taglib-uri>元素指定标签库的相对或绝对URI地址，WEB应用将根据这一URI来访问标签库；<taglib-location>元素指定标签库描述文件在文件资源系统中的物理位置。
此外，也可以以上方式在web.xml文件中配置用户自定义的客户化标签库，例如：

<taglib><taglib-uri>/WEB-INF/mytaglib.tld</taglib-uri><taglib-location>/WEB-INF/mytaglib.tld</taglib-location></taglib>

注意：a.不管应用中包含多少子应用，都只需要配置一个ActionServlet.有些开发者希望设置多个ActionServlet类来处理应用中不同的功能，其实这是不必要的，因为Servlet本身支持多线程。而且目前的Struts框架只允许在应用中配置一个ActionServlet。

web.xml 中的filter

Servlet API的2.3版本中最重要的一个新功能就是能够为servlet和JSP页面定义过滤器。过滤器提供了某些早期服务器所支持的非标准“servlet链接”的一种功能强大且标准的替代品。
过滤器是一个程序，它先于与之相关的servlet或JSP页面运行在服务器上。过滤器可附加到一个或多个servlet或JSP页面上，并且可以检查进入这些资源的请求信息。在这之后，过滤器可以作如下的选择：

1 以常规的方式调用资源（即，调用servlet或JSP页面）。

2 利用修改过的请求信息调用资源。

3 调用资源，但在发送响应到客户机前对其进行修改。

4 阻止该资源调用，代之以转到其他的资源，返回一个特定的状态代码或生成替换输出。

· 过滤器只在与servlet规范2.3版兼容的服务器上有作用。如果你的Web应用需要支持旧版服务器，就不能使用过滤器。
1．建立基本过滤器
建立一个过滤器涉及下列五个步骤：
1）建立一个实现Filter接口的类。这个类需要三个方法，分别是：doFilter、init和destroy。doFilter方法包含主要的过滤代码（见第2步），init方法建立设置操作，而destroy方法进行清楚。
2）在doFilter方法中放入过滤行为。doFilter方法的第一个参数为ServletRequest对象。此对象给过滤器提供了对进入的信息（包括表单数据、cookie和HTTP请求头）的完全访问。第二个参数为ServletResponse，通常在简单的过滤器中忽略此参数。最后一个参数为 FilterChain，如下一步所述，此参数用来调用servlet或JSP页。
3）调用FilterChain对象的doFilter方法。 Filter接口的doFilter方法取一个FilterChain对象作为它的一个参数。在调用此对象的doFilter方法时，激活下一个相关的过滤器。如果没有另一个过滤器与servlet或JSP页面关联，则servlet或JSP页面被激活。
4）对相应的servlet和JSP页面注册过滤器。在部署描述符文件（web.xml）中使用filter和filter-mapping元素。
5）禁用激活器servlet。防止用户利用缺省servlet URL绕过过滤器设置。
1.1 建立一个实现Filter接口的类
所有过滤器都必须实现javax.servlet.Filter。这个接口包含三个方法，分别为doFilter、init和destroy。

1、public void doFilter(ServletRequset request,ServletResponse response,FilterChain chain)thows ServletException, IOException

每当调用一个过滤器（即，每次请求与此过滤器相关的servlet或JSP页面）时，就执行其doFilter方法。正是这个方法包含了大部分过滤逻辑。
第一个参数为与传入请求有关的ServletRequest。对于简单的过滤器，大多数过滤逻辑是基于这个对象的。如果处理HTTP请求，并且需要访问诸如 getHeader或getCookies等在ServletRequest中无法得到的方法，就要把此对象构造成 HttpServletRequest。
第二个参数为ServletResponse。除了在两个情形下要使用它以外，通常忽略这个参数。首先，如果希望完全阻塞对相关servlet或JSP页面的访问。可调用response.getWriter并直接发送一个响应到客户机。第7节给出详细内容，第8节给出一个例子。其次，如果希望修改相关的servlet或JSP页面的输出，可把响应包含在一个收集所有发送到它的输出的对象中。然后，在调用 serlvet或JSP页面后，过滤器可检查输出，如果合适就修改它，之后发送到客户机。详情请参阅第9节。
DoFilter的最后一个参数为FilterChain对象。对此对象调用doFilter以激活与servlet或JSP页面相关的下一个过滤器。如果没有另一个相关的过滤器，则对doFilter的调用激活servlet或JSP本身。

2、public void init(FilterConfig config)thows ServletException

init 方法只在此过滤器第一次初始化时执行，不是每次调用过滤器都执行它。对于简单的过滤器，可提供此方法的一个空体，但有两个原因需要使用init。首先，FilterConfig对象提供对servlet环境及web.xml文件中指派的过滤器名的访问。因此，普遍的办法是利用init将 FilterConfig对象存放在一个字段中，以便doFilter方法能够访问servlet环境或过滤器名。这种处理在第3节描述。其次，FilterConfig对象具有一个getInitParameter方法，它能够访问部署描述符文件（web.xml）中分配的过滤器初始化参数。初始化参数的使用在第5节中描述。
3、public void destroy( )
此方法在利用一个给定的过滤器对象永久地终止服务器（如关闭服务器）时调用。大多数过滤器简单地为此方法提供一个空体，不过，可利用它来完成诸如关闭过滤器使用的文件或数据库连接池等清除任务。
1.2 将过滤行为放入doFilter方法
doFilter 方法为大多数过滤器地关键部分。每当调用一个过滤器时，都要执行doFilter。对于大多数过滤器来说，doFilter执行的步骤是基于传入的信息的。因此，可能要利用作为doFilter的第一个参数提供的ServletRequest。这个对象常常构造为HttpServletRequest类型，以提供对该类的更特殊方法的访问。
1.3 调用FilterChain对象的doFilter方法
Filter接口的 doFilter方法以一个FilterChain对象作为它的第三个参数。在调用该对象的doFilter方法时，激活下一个相关的过滤器。这个过程一般持续到链中最后一个过滤器为止。在最后一个过滤器调用其FilterChain对象的doFilter方法时，激活servlet或页面自身。
但是，链中的任意过滤器都可以通过不调用其FilterChain的doFilter方法中断这个过程。在这样的情况下，不再调用JSP页面的serlvet，并且中断此调用过程的过滤器负责将输出提供给客户机。详情请参阅第7节。
1.4 对适当的servlet和JSP页面注册过滤器
部署描述符文件的2.3版本引入了两个用于过滤器的元素，分别是：filter和filter-mapping。filter元素向系统注册一个过滤对象，filter-mapping元素指定该过滤对象所应用的URL。
1.filter元素
filter元素位于部署描述符文件（web.xml）的前部，所有filter-mapping、servlet或servlet-mapping元素之前。filter元素具有如下六个可能的子元素：
icon 这是一个可选的元素，它声明IDE能够使用的一个图象文件。
filter-name 这是一个必需的元素，它给过滤器分配一个选定的名字。
display-name 这是一个可选的元素，它给出IDE使用的短名称。
description 这也是一个可选的元素，它给出IDE的信息，提供文本文档。
filter-class 这是一个必需的元素，它指定过滤器实现类的完全限定名。
init-param 这是一个可选的元素，它定义可利用FilterConfig的getInitParameter方法读取的初始化参数。单个过滤器元素可包含多个init-param元素。

filter-mapping元素
filter-mapping元素位于web.xml文件中filter元素之后serlvet元素之前。它包含如下三个可能的子元素：：
l filter-name 这个必需的元素必须与用filter元素声明时给予过滤器的名称相匹配。
l url-pattern 此元素声明一个以斜杠（/）开始的模式，它指定过滤器应用的URL。所有filter-mapping元素中必须提供url-pattern或 servlet-name。但不能对单个filter-mapping元素提供多个url-pattern元素项。如果希望过滤器适用于多个模式，可重复整个filter-mapping元素。
l servlet-name 此元素给出一个名称，此名称必须与利用servlet元素给予servlet或JSP页面的名称相匹配。不能给单个filter-mapping元素提供多个servlet-name元素项。如果希望过滤器适合于多个servlet名，可重复这个filter-mapping元素。

基于以上的原理，在项目中遇到这样一个问题，用户只有登陆之后才能浏览resource目录下的资源，而这些resource的地址都是静态地址，这时候就用到了过滤器，

public void doFilter(ServletRequest req, ServletResponse res,   FilterChain chain) throws IOException, ServletException {   HttpServletRequest request = (HttpServletRequest) req;   HttpServletResponse response = (HttpServletResponse) res;   HttpSession session=request.getSession();   ServletContext application=session.getServletContext();         if(session.getAttribute("userSession")==null)      {       response.sendRedirect("error/priv_error.jsp");       return;      }      else      {       chain.doFilter(request, response);      } }

web.xml中如下配置：

<filter>      <filter-name>PrivFilter</filter-name>      <filter-class>com.myPriv.filter.PrivFilter</filter-class>   </filter><filter-mapping>    <filter-name>PrivFilter</filter-name>    <url-pattern>/resource/*</url-pattern></filter-mapping>

在过滤器程序中判断到resource目录下的请求的用户session是否为空，如果空的话就跳转出去；