1. 程式人生 > >史上最全web.xml配置檔案元素詳解(轉載防丟)

史上最全web.xml配置檔案元素詳解(轉載防丟)

web.xml配置檔案常用元素及其意義預覽

 1 <web-app>
 2 
 3      <!--定義了WEB應用的名字-->
 4      <display-name></display-name>
 5 
 6      <!--宣告WEB應用的描述資訊-->
 7      <description></description>
 8 
 9      <!--context-param元素宣告應用範圍內的初始化引數-->
10      <context-param></
context-param> 11 12 <!--過濾器元素將一個名字與一個實現javax.servlet.Filter介面的類相關聯--> 13 <filter></filter> 14 15 <!--一旦命名了一個過濾器,就要利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯--> 16 <filter-mapping></filter-mapping> 17 18 <!--servlet API的版本2.3增加了對事件監聽程式的支援,事件監聽程式在建立、修改和刪除會話或servlet環境時得到通知。
19 Listener元素指出事件監聽程式類--> 20 <listener></listener> 21 22 <!--在向servlet或JSP頁面制定初始化引數或定製URL時,必須首先命名servlet或JSP頁面。 23 Servlet元素就是用來完成此項任務的--> 24 <servlet></servlet> 25 26 <!--伺服器一般為servlet提供一個預設的URL:http://host/webAppPrefix/servlet/ServletName。
27 但是,常常會更改這個URL,以便servlet可以訪問初始化引數或更容易地處理相對URL。 28 在更改預設URL時,使用servlet-mapping元素--> 29 <servlet-mapping></servlet-mapping> 30 31 <!--如果某個會話在一定時間內未被訪問,伺服器可以拋棄它以節省記憶體。可通過使用HttpSession的 32 setMaxInactiveInterval方法明確設定單個會話物件的超時值,或者可利用session-config元素制定預設超時值--> 33 <session-config></session-config> 34 35 <!--如果Web應用具有想到特殊的檔案,希望能保證給他們分配特定的MIME型別,則mime-mapping元素提供這種保證--> 36 <mime-mapping></mime-mapping> 37 38 <!--指示伺服器在收到引用一個目錄名而不是檔名的URL時,使用哪個檔案--> 39 <welcome-file-list></welcome-file-list> 40 41 <!--在返回特定HTTP狀態程式碼時,或者特定型別的異常被丟擲時,能夠制定將要顯示的頁面--> 42 <error-page></error-page> 43 44 <!--對標記庫描述符檔案(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD檔案的位置, 45 而不用編輯使用這些檔案的JSP頁面--> 46 <taglib></taglib> 47 48 <!--宣告與資源相關的一個管理物件--> 49 <resource-env-ref></resource-env-ref> 50 51 <!--宣告一個資源工廠使用的外部資源--> 52 <resource-ref></resource-ref> 53 54 <!--制定應該保護的URL。它與login-config元素聯合使用--> 55 <security-constraint></security-constraint> 56 57 <!--指定伺服器應該怎樣給試圖訪問受保護頁面的使用者授權。它與sercurity-constraint元素聯合使用--> 58 <login-config></login-config> 59 60 <!--給出安全形色的一個列表,這些角色將出現在servlet元素內的security-role-ref元素的role-name子元素中。 61 分別地宣告角色可使高階IDE處理安全資訊更為容易--> 62 <security-role></security-role> 63 64 <!--宣告Web應用的環境項--> 65 <env-entry></env-entry> 66 67 <!--宣告一個EJB的主目錄的引用--> 68 <ejb-ref></ejb-ref> 69 70 <!--宣告一個EJB的本地主目錄的應用--> 71 <ejb-local-ref></ejb-local-ref> 72 73 </web-app>

二、各個配置元素詳解

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

2.Web 應用名稱:提供GUI工具可能會用來標記這個特定的Web應用的一個名稱

1 <display-name>Tomcat Example</display-name>

3.Web 應用描述:給出於此相關的說明性文字

1 <disciption>Tomcat Example servlets and JSP pages.</disciption>

4.上下文引數:宣告應用範圍內的初始化引數

1 <context-param>
2      <param-name>引數名</para-name>
3      <param-value>引數值</param-value>
4      <description>引數描述</description>
5  </context-param>

在servlet裡面可以通過 getServletContext().getInitParameter(“context/param”)得到

5.過濾器配置:將一個名字與一個實現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>GB2312</param-value>
 7      </init-param>
 8  </filter>
 9  <filter-mapping>
10      <filter-name>setCharacterEncoding</filter-name>
11      <url-pattern>/*</url-pattern>
12  </filter-mapping>

6.監聽器配置

1 <listener>
2      <listerner-class>org.springframework.web.context.ContextLoaderListener</listener-class>
3  </listener>

7.Servlet配置

 1 <servlet>
 2    <servlet-name>servlet名稱</servlet-name>
 3    <servlet-class>servlet類全路徑