Java Web中web.xml文件简单介绍

2022-12-09 10:05:06

参考博客: https://www.cnblogs.com/Y-oung/p/8401549.html

1、XML 声明和根元素

Java Web中web.xml文件简单介绍
<?xml version="1.0" encoding="UTF-8"?>

<!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 id="WebApp">

……

</web-app>
Java Web中web.xml文件简单介绍

和所有xml类型的文件一样，第一行是 XML 声明，它定义 XML 的版本 (1.0) 和所使用的编码 (UTF-8)。

第二行的“DOCYTPE”声明必须紧跟在XML 声明之后，这个声明会告诉服务器适用的servlet规范的版本（如2.3），并指定管理此文件其余部分内容的语法的DTD(Document Type Definition即文档类型定义)。

第三行的<web-app></web-app>标签就是此文件的根元素，web.xml文件的最主要的配置信息就包含在这个标签之内，接下来重点介绍的就是这个标签包含的内容。xml文件不仅对大小写敏感，而且还对出现在其他元素中的次序敏感。所以标签的大小写一定要使用正确，而且XML声明必须是文件中的第一项，DOCTYPE声明必须是第二项，而web- app元素必须是第三项。同样在web-app元素内，元素的次序也很重要。

2、Web 应用配置

Java Web中web.xml文件简单介绍
<icon>

     <small-icon>/images/small_icon.gif</small-icon>

     <large-icon>/images/large_icon.gif</large-icon>

</icon>

<display-name>WEB</display-name>

<desciption>WEB Example</desciption>

<context-param>

     <param-name>name</para-name>

     <param-value>value</param-value>

     <description>description</description>

</context-param>
Java Web中web.xml文件简单介绍


<icon>标签指出IDE和GUI工具用来表示Web应用的大图标和小图标的位置。
        <display-name>标签指出此Web应用的应用名称。
        <desciption>顾名思义就是对此Web应用的一些描述信息。
        <context-param>声明此应用范围内的初始化参数，这些参数可在servlet类中通过getServletContext().getInitParameter(“name”)方法获取。


3、filter过滤器




Java Web中web.xml文件简单介绍


<filter>

      <filter-name>MyFilter</filter-name>

      <filter-class>com.filter.MyFilter</filter-class>

  </filter>

  <filter-mapping>

      <filter-name>MyFilter</filter-name>

      <url-pattern> /main.jsp</url-pattern>

  </filter-mapping>

   <filter-mapping>

      <filter-name>MyFilter</filter-name>

      <url-pattern>/addProduct.jsp</url-pattern>

  </filter-mapping>


Java Web中web.xml文件简单介绍




<filter>标签内部配置过滤器，<filter-name>标签指定此过滤器的名字，<filter-class>标签指定此过滤器指向的类（MyFilter），此类必须实现javax.servlet.Filter接口。<filter-mapping>标签用来关联一个或多个servlet或jsp页面（/main.jsp和/addProduct.jsp）。注意无论有多少<filter-mapping>，他们的<filter-name>必须与前面的名字一致。


4、listener监听器




 <listener>

  <listener-class>com.channel.http.SessionListener</listener-class>

 </listener>




<listener>标签指定监听器，用于监听Web应用中某些对象、信息的创建、销毁、增加，修改，删除等动作的发生，然后作出相应的响应处理。当范围对象的状态发生变化的时候，服务器自动调用监听器对象中的方法。常用于统计在线人数和在线用户，系统加载时进行信息初始化，统计网站的访问量等等。


        5、servlet（很重要）




Java Web中web.xml文件简单介绍


<servlet>

        <servlet-name>yqzl</servlet-name>

        <servlet-class>

            com.channel.http.servlet.MainServlet

        </servlet-class>

        <init-param>

            <param-name>contextConfigLocation</param-name>

            <param-value>/WEB-INF/config/springmvc-config.xml</param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>yqzl</servlet-name>

        <url-pattern>*.action</url-pattern>

    </servlet-mapping>     


Java Web中web.xml文件简单介绍




<servlet>标签用于指定此Web应用的servlet相关配置，这个配置相当重要。<servlet-name>标签指定此servlet的名字，<servlet-class>指定servlet的类，这个类开发者可以自己写，一般会继承HttpServlet类，用来初始化整个Web项目和接受http请求并处理。<init-param>标签里面可以配置一些参数。
        <load-on-startup>标签指定当前Web应用启动时装载Servlet的次序，它的内容必须是整数，当这个数>=0时，容器会按数值从小到大依次加载。如果数值<0或没有指定，容器将在用户首次访问时加载这个servlet类。<servlet-mapping>标签可定义servlet映射，里面的<servlet-name>必须与前面的名字一致，<url-pattern>指定servlet映射的路径。
        在用Tomcat启动整个web项目时，当配置了<load-on-startup>标签并且里面的数字>=0时，会加载此servlet类，创建类的实例，调用init()方法初始化<init-param>标签里面的配置信息，此初始化在整个servlet生命周期中只会进行一次。如果未配置<load-on-startup>标签或数字<0时，Tomcat启动时不会加载此servlet类，当然也就不会调用init()方法进行初始化，当用户首次访问时会加载类并初始化，所以此时第一次访问时可能会加载很慢。这里仅简单介绍标签的作用，以后我会详细介绍这个servlet类以及与其相关的几个比较重要的类和接口。


 6、session配置




 <session-config>

  <session-timeout>10</session-timeout>

 </session-config>




<session-config>标签用于设置浏览器与服务器之间会话（交互）时长的间隔，以分钟为单位。用户访问Web项目时，会与服务器之间建立一个session，当用户长时间未与服务器信息交互而超过这个时长时，服务器会销毁这个session，释放占用的内存空间，当用户再次在原来的session访问时会失效，需要重新建立新的session。除了可以设置这个标签之外，还可通过HttpSession的setMaxInactiveInterval()方法设置单个会话对象的超时值。


7、欢迎页配置




Java Web中web.xml文件简单介绍


 <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>


Java Web中web.xml文件简单介绍




当用户访问Web应用时，如果仅给出Web应用的根访问URL，没有指定具体的文件名，容器会调用<weblcome-file- list> 标签里指定的文件。<welcome-file-list>里允许有多个<welcome-file>元素，每个元素代表一个文件。容器会按顺序寻找，先找第一个文件是否存在，如果存在则会把这个文件显示出来，不再寻找其他文件。如果不存在则寻找第二个文件，依次类推。如果所有文件都不存在，则抛出404错误。


8、其他配置


下面的这几项配置，笔者在开发中目前还没遇到过，不是特别了解，这里就不做过多解释，以免引起错误。这些内容都是参考 https://www.cnblogs.com/hafiz/p/5715523.html 的内容，有兴趣可以去这篇博客去看。




<mime-mapping></mime-mapping>




  如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。




<error-page></error-page>




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




<taglib></taglib>




  对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。




<resource-env-ref></resource-env-ref>




  声明与资源相关的一个管理对象。




<resource-ref></resource-ref>




  声明一个资源工厂使用的外部资源。




<security-constraint></security-constraint>




  制定应该保护的URL。它与login-config元素联合使用。




<login-config></login-config>




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




<security-role></security-role>




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




<env-entry></env-entry>




  声明Web应用的环境项。




<ejb-ref></ejb-ref>




  声明一个EJB的主目录的引用。




<ejb-local-ref></ejb-local-ref>




  声明一个EJB的本地主目录的应用。


以上基本上涵盖了配置web.xml文件所需要的元素以及对这些元素简单的介绍，不同元素配置的基本顺序大致如此。其中<display-name>、<desciption>、<context-param>、<filter>、<listener>、<servlet>、<servlet-mapping>、<session-config>、<welcome-file-list>这几项是笔者在开发过程中遇到最多的，尤其是和servlet相关的配置个人认为是重中之重。所以接下来的几篇中我会详细介绍servlet类以及与其相关的几个比较重要的类和接口。这些内容也是笔者根据实际工作以及参考一些资料总结而来的，当然其中难免有些错误或者遗漏，欢迎大家指正，我也在不断学习不断提高。


下面是完整的web.xml文件配置。




Java Web中web.xml文件简单介绍


<?xml version="1.0" encoding="UTF-8"?>

<!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 id="WebApp">

   <icon>

       <small-icon>/images/small_icon.gif</small-icon>

       <large-icon>/images/large_icon.gif</large-icon>

   </icon>

   <display-name>WEB</display-name>

   <desciption>WEB Example</desciption>

   <context-param>

       <param-name>name</para-name>

       <param-value>value</param-value>

       <description>description</description>

   </context-param>

   <filter>

        <filter-name>MyFilter</filter-name>

        <filter-class>com.filter.MyFilter</filter-class>

   </filter>

   <filter-mapping>

        <filter-name>MyFilter</filter-name>

        <url-pattern> /main.jsp</url-pattern>

   </filter-mapping>

   <filter-mapping>

        <filter-name>MyFilter</filter-name>

        <url-pattern>/addProduct.jsp</url-pattern>

   </filter-mapping>

   <listener>

       <listener-class>com.channel.http.SessionListener</listener-class>

   </listener>

   <servlet>

       <servlet-name>yqzl</servlet-name>

       <servlet-class>

            com.channel.http.servlet.MainServlet

       </servlet-class>

       <init-param>

            <param-name>contextConfigLocation</param-name>

            <param-value>/WEB-INF/config/springmvc-config.xml</param-value>

       </init-param>

       <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

        <servlet-name>yqzl</servlet-name>

        <url-pattern>*.action</url-pattern>

    </servlet-mapping>     

    <session-config>

        <session-timeout>10</session-timeout>

    </session-config>

    <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>

    <mime-mapping></mime-mapping>

    <error-page></error-page>

    <taglib></taglib>

    <resource-env-ref></resource-env-ref>

    <resource-ref></resource-ref>

    <security-constraint></security-constraint>

    <login-config></login-config>

    <security-role></security-role>

    <env-entry></env-entry>

    <ejb-ref></ejb-ref>

    <ejb-local-ref></ejb-local-ref>

</web-app>


Java Web中web.xml文件简单介绍


上一篇：WPF窗体程序入口 自定义窗体启动页面

下一篇：关于写ruby c ext 的一些问题（1）