1. 程式人生 > >web.xml檔案詳解

web.xml檔案詳解

轉載地址:https://www.cnblogs.com/LiZhiW/p/4313844.html

一、web.xml檔案介紹

1.web.xml檔案的作用 web.xml主要用來配置Filter、Listener、Servlet等。但是要說明的是web.xml並不是必須的,一個web工程可以沒有web.xml檔案。 2.WEB容器的載入過程 WEB容器的載入順序是:ServletContext -> context-param -> listener -> filter -> servlet。在web.xml檔案中最好按照這種順序配置這些元素,以相容較低版本的Tomcat。
3.WEB容器的啟動過程 WEB容器啟動時,載入過程順序如下: 1.啟動一個WEB專案的時候,WEB容器會去讀取它的配置檔案web.xml,讀取<listener>和<context-param>兩個結點。  2.緊急著,容建立一個ServletContext(servlet上下文),這個web專案的所有部分都將共享這個上下文。  3.容器將<context-param>轉換為鍵值對,並交給servletContext。  4.容器建立<listener>中的類例項,建立監聽器。 

二、web.xml配置元素

1.<web-app>根元素
web.xml的模式檔案是由Sun公司定義的,每個web.xml檔案的根元素<web-app>中,都必須標明這個 web.xml使用的是哪個模式檔案。其它的元素都放在<web-app></web-app>之中,<web-app>是根節點。
  1. <web-appversion="3.0"xmlns="http://java.sun.com/xml/ns/javaee"
  2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
  4. http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
  5. </web-app>
2.<icon>Web應用圖示 指出IDE和GUI工具用來表示Web應用的大圖示和小圖示。
  1. <icon>
  2. <small-icon>/images/app_small.gif</small-icon>
  3. <large-icon>/images/app_large.gif</large-icon>
  4. </icon>
3.<display-name>Web應用名稱 提供GUI工具可能會用來標記這個特定的Web應用的一個名稱。
  1. <display-name>Tomcat Example</display-name>
4.<disciption>Web應用描述 給出於此相關的說明性文字。
  1. <disciption>Tomcat Example servlets and JSP pages.</disciption>
5.<context-param>上下文引數 宣告應用範圍內的初始化引數。它用於向 ServletContext提供鍵值對,即應用程式上下文資訊。我們的listener, filter等在初始化時會用到這些上下文中的資訊。在servlet裡面可以通過getServletContext().getInitParameter("context/param")得到。
  1. <context-param>
  2. <param-name>ContextParameter</para-name>
  3. <param-value>test</param-value>
  4. <description>It is a test parameter.</description>
  5. </context-param>
6.<filter>過濾器 將一個名字與一個實現javaxs.servlet.Filter介面的類相關聯。
  1. <filter>
  2. <filter-name>setCharacterEncoding</filter-name>
  3. <filter-class>com.myTest.setCharacterEncodingFilter</filter-class>
  4. <init-param>
  5. <param-name>encoding</param-name>
  6. <param-value>UTF-8</param-value>
  7. </init-param>
  8. </filter>
  9. <filter-mapping>
  10. <filter-name>setCharacterEncoding</filter-name>
  11. <url-pattern>/*</url-pattern>
  12. </filter-mapping>
7.<listener>監聽器
  1. <listener>
  2. <listener-class>com.listener.SessionListener</listener-class>
  3. </listener>
8.<servlet>
  1. <servlet> 用來宣告一個servlet的資料,主要有以下子元素:
  2. <servlet-name> 指定servlet的名稱
  3. <servlet-class> 指定servlet的類名稱
  4. <jsp-file> 指定web站臺中的某個JSP網頁的完整路徑
  5. <init-param> 用來定義引數,可有多個init-param。
  6. <load-on-startup> 當值為正數或零時,從小到大載入。否則第一次訪問時載入。
  7. <servlet-mapping> 用來定義servlet所對應的URL,包含兩個子元素
  8. <servlet-name> 指定servlet的名稱
  9. <url-pattern> 指定servlet所對應的URL
  1. <!-- 基本配置 -->
  2. <servlet>
  3. <servlet-name>snoop</servlet-name>
  4. <servlet-class>SnoopServlet</servlet-class>
  5. </servlet>
  6. <servlet-mapping>
  7. <servlet-name>snoop</servlet-name>
  8. <url-pattern>/snoop</url-pattern>
  9. </servlet-mapping>
  10. <!-- 高階配置 -->
  11. <servlet>
  12. <servlet-name>snoop</servlet-name>
  13. <servlet-class>SnoopServlet</servlet-class>
  14. <init-param>
  15. <param-name>foo</param-name>
  16. <param-value>bar</param-value>
  17. </init-param>
  18. <run-as>
  19. <description>Security role for anonymous access</description>
  20. <role-name>tomcat</role-name>
  21. </run-as>
  22. </servlet>
  23. <servlet-mapping>
  24. <servlet-name>snoop</servlet-name>
  25. <url-pattern>/snoop</url-pattern>
  26. </servlet-mapping>
9.<session-config>會話超時配置
  1. <session-config>
  2. <session-timeout>120</session-timeout><!-- 單位為分鐘 -->
  3. </session-config>
10.<mime-mapping>
  1. <mime-mapping>
  2. <extension>htm</extension>
  3. <mime-type>text/html</mime-type>
  4. </mime-mapping>
11.<welcome-file-list>歡迎檔案頁
  1. <welcome-file-list>
  2. <welcome-file>index.jsp</welcome-file>
  3. <welcome-file>index.html</welcome-file>
  4. </welcome-file-list>
12.<error-page>錯誤頁面
  1. <!-- 1、通過錯誤碼來配置error-page。當系統發生×××錯誤時,跳轉到錯誤處理頁面。 -->
  2. <error-page>
  3. <error-code>404</error-code>
  4. <location>/NotFound.jsp</location>
  5. </error-page>
  6. <!-- 2、通過異常的型別配置error-page。(即空指標異常)時,跳轉到錯誤處理頁面。 -->
  7. <error-page>
  8. <exception-type>java.lang.NullException</exception-type>
  9. <location>/error.jsp</location>
  10. </error-page>
13.<jsp-config>設定jsp
  1. <jsp-config> 包括 <taglib><jsp-property-group>兩個子元素。其中<taglib>元素在JSP1.2時就已經存在;而<jsp-property-group> 是JSP 2.0 新增的元素。
  2. <jsp-property-group> 元素主要有八個子元素,它們分別為:
  3. <description> 設定的說明
  4. <display-name> 設定名稱
  5. <url-pattern> 設定值所影響的範圍,如: /CH2 或 /*.jsp
  6. <el-ignored> 若為 true,表示不支援 EL 語法
  7. <scripting-invalid> 若為 true,表示不支援 <% scripting %>語法
  8. <page-encoding> 設定 JSP 網頁的編碼
  9. <include-prelude> 設定 JSP 網頁的擡頭,副檔名為 .jspf
  10. <include-coda> 設定 JSP 網頁的結尾,副檔名為 .jspf
  1. <jsp-config>
  2. <taglib>
  3. <taglib-uri>Taglib</taglib-uri>
  4. <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location>
  5. </taglib>
  6. <jsp-property-group>
  7. <description>Special property group for JSP Configuration JSP example.</description>
  8. <display-name>JSPConfiguration</display-name>
  9. <url-pattern>/jsp/* </url-pattern>
  10. <el-ignored>true</el-ignored>
  11. <page-encoding>GB2312</page-encoding>
  12. <scripting-invalid>true</scripting-invalid>
  13. <include-prelude>/include/prelude.jspf</include-prelude>
  14. <include-coda>/include/coda.jspf</include-coda>
  15. </jsp-property-group>
  16. </jsp-config>
對於Web 應用程式來說,Scriptlet 是個不樂意被見到的東西,因為它會使得HTML 與Java 程式碼交相混雜,對於程式的維護來說相當的麻煩,必要的時候,可以在web.xml 中加上<script-invalid> 標籤,設定所有的JSP 網頁都不可以使用Scriptlet。