servlet中的web.xml配置详解_java servlet web.xml-优快云博客

本文链接：https://blog.youkuaiyun.com/woniu_li/article/details/109045009

本文详细解读了web.xml配置文件中的核心元素，如servlet声明、url-pattern映射、过滤器设置及会话管理，帮助理解如何组织和管理Web应用的逻辑结构。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

<web-app>

这是整个配置文件的根标签，所有的其他标签都要写在此标签内。另外必须声明web.xml使用的是哪个模式文件。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    
</web-app>

<display-name>

它标注了该web项目的名字，提供GUI工具可能会用来标记这个特定的Web应用的一个名称，是servlet的描述性说明文字，没有实质性意义，可以不写。

<display-name>myTest</display-name>

<description>

声明WEB应用的描述信息

<welcome-file-list>

定义服务器打开时自动跳转的首页

<welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>

<servlet>

用来声明一个servlet的数据，主要有以下子元素：

<servlet-name> ：指定servlet的名称（描述节点）
<servlet-class> ：指定servlet的类的全限定名（包名+类名）
<jsp-file> ：指定web站台中的某个JSP网页的完整路径
<init-param> ：用来定义初始化参数，可有多个init-param。在servlet类中通过ServletConfig对象传入init函数，通过- getInitParamenter(String name)方法访问初始化参数。

例如使用<init-param>来初始化数据库连接参数

<servlet>
    <servlet-name>jk</servlet-name>
    <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
    
    <!-- 初始化数据库连接参数 -->
    <init-param>
        <param-name>driver</param-name>
        <param-value>com.mysql.jdbc.Driver</param-value>
    </init-param>
    <init-param>
        <param-name>url</param-name>
        <param-value>jdbc:mysql://localhost:3306/kgcnews</param-value>
    </init-param>
    <init-param>
        <param-name>username</param-name>
        <param-value>zhangsan</param-value>
    </init-param>
    <init-param>
        <param-name>passwd</param-name>
        <param-value>123456</param-value>
    </init-param>
</servlet>

<servlet-mapping>

用来定义servlet所对应的URL，包含两个子元素

<servlet-name> ：指定servlet的名称（需要注意的是这个名字必须和上边的<servlet>标签下的<servlet-name>的名字相同）
<&url-patterngt; ：指定servlet所对应的URL（是我们在访问Servlet在浏览器地址栏后面输入的那个信息，例如我的映射路径命名为/druid，在地址栏中输入http://localhost/端口号/druid）
url-pattern匹配规则

按照优先级从高到低排列：
精确匹配：类似于/druid的精确路径
通配符匹配：/*
扩展名匹配：*.html，*.jpg ，.do ，.action之类的
默认匹配（/）——当之前匹配都不成功时

当servlet收到来自客户端的url请求时，先把请求url减去当前项目上下文路径，然后再与url-pattern进行匹配，匹配按照上面列出的优先级顺序进行，只要有一个匹配成功就停止，不再继续匹配其他的。（注：/*.html这种匹配方式是错误的，容器无法识别同时拥有两种匹配规则的 url-pattern）

    <servlet-mapping>
        <servlet-name>jk</servlet-name>
        <url-pattern>/druid</url-pattern>
    </servlet-mapping>

<load-on-startup>

指定当Web应用启动时，装载Servlet的次序。当值为正数或零时：Servlet容器先加载数值小的servlet，再依次加载其他数值大的servlet。当值为负或未定义：Servlet容器将在Web客户首次访问这个servlet时加载它。

<filter>

过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。

<listener>

Listener元素指出事件监听程序类

<session-config>

配置会话超时，单位是分钟
如果某个会话在一定时间内未被访问，服务器可以舍弃它以节省内存。

<session-config>
    <session-timeout>30</session-timeout>
</session-config>

<error-page>

在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。

<login-config>

指定服务器应该怎样给试图访问受保护页面的用户授权。它与<security-role>元素联合使用。

<security-role>

给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。