一、web.xml檔案的作用
每個javaEE工程中都有web.xml檔案,那麼它的作用是什麼呢。它是每個web.xml工程都必須的嗎。
一個web中可以沒有web.xml檔案,也就是說,web.xml檔案並不是web工程必須的。 web.xml檔案是用來初始化配置資訊:比如Welcome頁面、servlet、servlet-mapping、filter、listener、啟動載入層級等。當你的web工程沒用到這些時,你可以不用web.xml檔案來配置你的Application。
每個xml檔案都有定義它書寫規則的Schema檔案,也就是說javaEE的定義web.xml所對應的xml Schema檔案中定義了多少種標籤元素,web.xml中就可以出現它所定義的標籤元素,也就具備哪些特定的功能。web.xml的模式檔案是由Sun 公司定義的,每個web.xml檔案的根項目為<web-app>中,必須標明這個web.xml使用的是哪個模式檔案。如:
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> </web-app>
web.xml的模式檔案中定義的標籤並不是定死的,模式檔案也是可以改變的,一般來說,隨著web.mxl模式檔案的版本升級,裡面定義的功能會越來越複雜,標籤元素的種類肯定也會越來越多,但有些不是很常用的,我們只需記住一些常用的並知道怎麼配置就可以了。 二、常用標籤元素及功能
下面列出web.xml我們常用的一些標籤元素及其功能: 1. 指定歡迎頁面 :
<welcome-file-list> <welcome-file>index.jsp</welcome-file> <welcome-file>index1.jsp</welcome-file> </welcome-file-list>
PS:指定了2個歡迎頁面,顯示時按順序從第一個找起,如果第一個存在,就顯示第一個,後面的不起作用。如果第一個不存在,就找第二個,以此類推。
訪問一個網站時,預設看到的第一個頁面就叫歡迎頁面,一般情況下是由首頁來充當歡迎頁面的。一般情況下,我們會在web.xml中指定歡迎頁面。但 web.xml並不是一個Web的必要檔案,沒有web.xml,網站仍然是可以正常工作的。只不過網站的功能複雜起來後,web.xml的確有非常大用處,所以,預設建立的動態web工程在WEB-INF檔案夾下面都有一個web.xml檔案。 2. 命名與定製URL:
我們可以為Servlet和JSP檔案命名並定製URL,其中定製URL是依賴命名的,命名必須在定製URL前。下面拿serlet來舉例:
1. 為Servlet命名:
<servlet> <servlet-name>servlet1</servlet-name> <servlet-class>org.whatisjava.TestServlet</servlet-class> </servlet>
為Servlet定製URL
<servlet-mapping> <servlet-name>servlet1</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
3. 定製初始化參數:
可以定製servlet、JSP、Context的初始化參數,然後可以再servlet、JSP、Context中擷取這些參數值。
下面用servlet來舉例:
<servlet> <servlet-name>servlet1</servlet-name> <servlet-class>org.whatisjava.TestServlet</servlet-class> <init-param> <param-name>userName</param-name> <param-value>Daniel</param-value> </init-param> <init-param> <param-name>E-mail</param-name> <param-value>125485762@qq.com</param-value> </init-param> </servlet>
經過上面的配置,在servlet中能夠調用getServletConfig().getInitParameter(“param1”)獲得參數名對應的值。 4. 指定錯誤處理頁面:
可以通過“異常類型”或“錯誤碼”來指定錯誤處理頁面
<error-page> <error-code>404</error-code> <location>/error404.jsp</location> </error-page> ----------------------------- <error-page> <exception-type>java.lang.Exception<exception-type> <location>/exception.jsp<location> </error-page>
5. 設定過濾器:
比如設定一個編碼過濾器,過濾所有資源
<filter> <filter-name>XXXCharaSetFilter</filter-name> <filter-class>net.test.CharSetFilter</filter-class> </filter> <filter-mapping> <filter-name>XXXCharaSetFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
6. 設定監聽器:
<listener> <listener-class>net.test.XXXLisenet</listener-class> </listener>
7. 設定會話(Session)到期時間:
其中時間以分鐘為單位,假如設定60分鐘逾時:
<session-config> <session-timeout>60</session-timeout> </session-config>
除了這些標籤元素之外,還可以往web.xml中添加很多標籤元素,由於不常用省略。 三、web.xml設定檔常用元素及其意義預覽
<web-app> <!--定義了WEB應用的名字--> <display-name></display-name> <!--聲明WEB應用的描述資訊--> <description></description> <!--context-param元素宣告應用範圍內的初始化參數--> <context-param></context-param> <!--過濾器元素將一個名字與一個實現javax.servlet.Filter介面的類相關聯--> <filter></filter> <!--一旦命名了一個過濾器,就要利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯--> <filter-mapping></filter-mapping> <!--servlet API的版本2.3增加了對事件監聽程式的支援,事件監聽程式在建立、修改和刪除會話或servlet環境時得到通知。 Listener元素指出事件監聽程式類--> <listener></listener> <!--在向servlet或JSP頁面制定初始化參數或定製URL時,必須首先命名servlet或JSP頁面。 Servlet元素就是用來完成此項任務的--> <servlet></servlet> <!--伺服器一般為servlet提供一個預設的URL:http://host/webAppPrefix/servlet/ServletName。 但是,常常會更改這個URL,以便servlet可以訪問初始化參數或更容易地處理相對URL。 在更改預設URL時,使用servlet-mapping元素--> <servlet-mapping></servlet-mapping> <!--如果某個會話在一定時間內未被訪問,伺服器可以拋棄它以節省記憶體。可通過使用HttpSession的 setMaxInactiveInterval方法明確設定單個會話對象的逾時值,或者可利用session-config元素制定預設逾時值--> <session-config></session-config> <!--如果Web應用具有想到特殊的檔案,希望能保證給他們分配特定的MIME類型,則mime-mapping元素提供這種保證--> <mime-mapping></mime-mapping> <!--指示伺服器在收到引用一個目錄名而不是檔案名稱的URL時,使用哪個檔案--> <welcome-file-list></welcome-file-list> <!--在返回特定HTTP狀態碼時,或者特定類型的異常被拋出時,能夠制定將要顯示的頁面--> <error-page></error-page> <!--對標記庫描述符檔案(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD檔案的位置, 而不用編輯使用這些檔案的JSP頁面--> <taglib></taglib> <!--聲明與資源相關的一個管理對象--> <resource-env-ref></resource-env-ref> <!--聲明一個資源工廠使用的外部資源--> <resource-ref></resource-ref> <!--制定應該保護的URL。它與login-config元素聯合使用--> <security-constraint></security-constraint> <!--指定伺服器應該怎樣給試圖訪問受保護頁面的使用者授權。它與sercurity-constraint元素聯合使用--> <login-config></login-config> <!--給出資訊安全角色的一個列表,這些角色將出現在servlet元素內的security-role-ref元素的role-name子項目中。 分別地聲明角色可使進階IDE處理安全資訊更為容易--> <security-role></security-role> <!--聲明Web應用的環境項--> <env-entry></env-entry> <!--聲明一個EJB的主目錄的引用--> <ejb-ref></ejb-ref> <!--聲明一個EJB的本地主目錄的應用--> <ejb-local-ref></ejb-local-ref> </web-app>
參考:
http://www.cnblogs.com/yqskj/articles/2233061.html
https://www.cnblogs.com/hafiz/p/5715523.html
https://blog.csdn.net/m0_37876745/article/details/78219754