web.xml文件的功能简介说明
转自:
http://www.java265.com/JavaProblem/202108/635.html
在java web开发,我们经常看见WEB-INF下有一个web.xml文件,那么这个文件起什么作用呢?
下文将一一道来,如下所示:
web.xml的作用
web.xml文件的作用用于配置Filter、Listener、Servlet等功能
web.xml注意事项: web.xml在一个动态web项目中,并不是必须的 即:一个Web工程,可以没有web.xml文件
WEB工程加载web.xml说明
web工程加载顺序注意事项: web.xml中元素加载的顺序同节点的顺序无关 ----------------------加载顺序----------------------------------- WEB容器(tomcat)的加载顺序是:ServletContext -> context-param -> listener -> filter -> servlet
例: 当我们启动一个web容器(tomcat)
它首先会去读取web.xml文件
然后读取<创建>和<context-param>节点
然后ServletContext(servlet上下文)
然后创建监听器
web.xml文件元素详解
schema
设置web.xml使用的模式文件,模式文件的内容将放入web-app中
在web.xml配置中,我们必须设置使用的具体模式文件
并放入<web-app></web-app>之中
例:
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> </web-app>
<icon>Web应用图标
用于设置IDE及GUI工具,用于表示web应用的大图标及小图标 <icon> <small-icon>/images/app_small.gif</small-icon> <large-icon>/images/app_large.gif</large-icon> </icon>
<display-name>用于设置Web应用名称
为GUI工具设置一个应用程序的名称
例:
<display-name>spring MVC</display-name>
<disciption>Web应用描述
对web应用程序进行相应的描述
例:
<disciption>这是一个spring mvc的样例程序</disciption>
<context-param>上下文参数
为ServletContext提供初始化参数
常采用键值对模式
例:
<context-param> <param-name>ContextParameter</para-name> <param-value>参数值</param-value> <description>参数值描述</description> </context-param>
<filter>过滤器
为应用程序设置过滤器
<filter> <filter-name>setCharacterEncoding</filter-name> <filter-class>com.myTest.setCharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>setCharacterEncoding</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
<listener>监听器
<listener> <listerner-class>com.listener.SessionListener</listener-class> </listener>
<servlet>
servlet:web项目的核心,用于处理前台的请求
<servlet></servlet>
servlet包含以下元素:
<servlet-name></servlet-name> 指定servlet的名称 <servlet-class></servlet-class> 指定servlet的类名称 <jsp-file></jsp-file> 指定web站台中的某个JSP网页的完整路径 <init-param></init-param> 用来定义参数,可有多个init-param。在servlet类中通过getInitParamenter(String name)方法访问初始化参数 <load-on-startup></load-on-startup>指定当Web应用启动时,装载Servlet的次序。当值为正数或零时:Servlet容器先加载数值小的servlet,再依次加载其他数值大的servlet。当值为负或未定义:Servlet容器将在Web客户首次访问这个servlet时加载它。 <servlet-mapping></servlet-mapping> 用来定义servlet所对应的URL,包含两个子元素 <servlet-name></servlet-name> 指定servlet的名称 <url-pattern></url-pattern> 指定servlet所对应的URL <!-- 基本配置 --> <servlet> <servlet-name>s1</servlet-name> <servlet-class>s1Servelet</servlet-class> </servlet> <servlet-mapping> <servlet-name>s1</servlet-name> <url-pattern>/webPageUrl</url-pattern> </servlet-mapping> <!-- 高级配置 --> <servlet> <servlet-name>s2</servlet-name> <servlet-class>s2Servlet</servlet-class> <init-param> <param-name>par1</param-name> <param-value>vale1</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>s2</servlet-name> <url-pattern>/web2</url-pattern> </servlet-mapping>
<session-config>会话超时配置
单位:分钟
<session-config> <session-timeout>120</session-timeout> </session-config>
<mime-mapping>
mime映射设置
<mime-mapping> <extension>htm</extension> <mime-type>text/html</mime-type> </mime-mapping>
<welcome-file-list>欢迎页设置
<welcome-file-list> <welcome-file>index.jsp</welcome-file> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> </welcome-file-list>
<error-page>错误页配置
<!-- 1、通过错误码来配置error-page。当系统发生×××错误时,跳转到错误处理页面。 --> <error-page> <error-code>404</error-code> <location>/NotFound.jsp</location> </error-page> <!-- 2、通过异常的类型配置error-page。当系统发生java.lang.NullException(即空指针异常)时,跳转到错误处理页面。 --> <error-page> <exception-type>java.lang.NullException</exception-type> <location>/error.jsp</location> </error-page>
<jsp-config>设置jsp
<jsp-config> 包括 <taglib> 和 <jsp-property-group> 两个子元素
其中<taglib> 元素在JSP 1.2 时就已经存在
而<jsp-property-group> 是JSP 2.0 新增的元素
<jsp-property-group> 元素主要有八个子元素,它们分别为:
<description>:设定的说明 <display-name>:设定名称 <url-pattern>:设定值所影响的范围,如: /CH2 或 /*.jsp <el-ignored>:若为 true,表示不支持 EL 语法 <scripting-invalid>:若为 true,表示不支持 <% scripting %>语法 <page-encoding>:设定 JSP 网页的编码 <include-prelude>:设置 JSP 网页的抬头,扩展名为 .jspf <include-coda>:设置 JSP 网页的结尾,扩展名为 .jspf <jsp-config> <taglib> <taglib-uri>Taglib</taglib-uri> <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location> </taglib> <jsp-property-group> <description>Special property group for JSP Configuration JSP example.</description> <display-name>JSPConfiguration</display-name> <url-pattern>/jsp/* </url-pattern> <el-ignored>true</el-ignored> <page-encoding>GB2312</page-encoding> <scripting-invalid>true</scripting-invalid> <include-prelude>/include/prelude.jspf</include-prelude> <include-coda>/include/coda.jspf</include-coda> </jsp-property-group> </jsp-config>
Mapping规则
mapping转发规则:
当一个请求达到servlet容器时,
此时请求的url会转换为uri,
然后同web.xml中的serverMapping进行匹配
匹配成功后,进入相应的servlet对应的class进行处理
servermapping匹配规则按照以下顺序匹配:
- 精确路径匹配:servletA 的url-pattern为 /test,servletB的url-pattern为 /* ,当访问的url为http://localhost/test 会匹配servletA对应的Class
- 最长路径匹配:servletA的url-pattern为/test/*,而servletB的url-pattern为/test/a/*,当访问http://localhost/test/a时,会匹配servletB对应的Class
- 扩展路径匹配:servletA的url-pattern:*.do,当我们访问http://local/test.do时,则会匹配servletA对应的Class