史上最全web.xml配置檔案元素詳解(轉載防丟)
阿新 • • 發佈:2019-01-21
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類全路徑