JavaWeb工程中web.xml基本配置

一.理論准備

        先說下我記得xml規則，必須有且只有一個根節點，大小寫敏感，標簽不嵌套，必須配對。

web.xml是不是必須的呢？不是的，只要你不用到里面的配置信息就好了，不過在大型web工程下使用該文件是很方便的，若是沒有也會很復雜。

        那么web.xml能做的所有事情都有那些？其實，web.xml的模式(Schema)文件中定義了多少種標簽元素，web.xml中就可以出現它的模式文件所定義的標簽元素，它就能擁有定義出來的那些功能。web.xml的模式文件是由Sun公司定義的，每個web.xml文件的根元素<web-app>中，都必須標明這個web.xml使用的是哪個模式文件。 
        來看個例子：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
  <display-name>db</display-name>
  <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>
</web-app>

 

二.標簽元素

• 指定歡迎頁面

<welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>index1.jsp</welcome-file>
</welcome-file-list>

        上面的例子指定了2個歡迎頁面，顯示時按順序從第一個找起，如果第一個存在，就顯示第一個，后面的不起作用。如果第一個不存在，就找第二個，以此類推。 
        關於歡迎頁面：訪問一個網站時，默認看到的第一個頁面就叫歡迎頁，一般情況下是由首頁來充當歡迎頁的。一般情況下，我們會在web.xml中指定歡迎頁。但web.xml並不是一個Web的必要文件，沒有web.xml，網站仍然是可以正常工作的。只不過網站的功能復雜起來后，web.xml的確有非常大用處，所以，默認創建的動態web工程在WEB-INF文件夾下面都有一個web.xml文件。 
        對於tomcat來說，當你只指定一個web的根名，沒有指定具體頁面，去訪問時一個web時，如果web.xml文件中配置了歡迎頁，那么就返回指定的那個頁面作為歡迎頁，而在文中沒有web.xml文件，或雖然有web.xml，但web.xml也沒指定歡迎頁的情況下，它默認先查找index.html文件，如果找到了，就把index.html作為歡迎頁還回給瀏覽器。如果沒找到index.html，tomcat就去找index.jsp。找到index.jsp就把它作為歡迎頁面返回。而如果index.html和index.jsp都沒找到，又沒有用web.xml文件指定歡迎頁面，那此時tomcat就不知道該返回哪個文件了，它就顯示The requested resource (/XXX) is not available(我就出現過這個問題)的頁面。其中XXX表示web的根名。但如果你指定了具體頁面，是可以正常訪問的。

• 命名與定制URL

<servlet>
    <servlet-name>servlet1</servlet-name>
    <servlet-class>net.test.TestServlet</servlet-class>
</servlet>
 
<servlet-mapping>
    <servlet-name>servlet1</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

        url-pattern的意思是所有的.do文件都會經過TestServlet處理。

• 定制初始化參數

<servlet>
    <servlet-name>servlet1</servlet-name>
    <servlet-class>net.test.TestServlet</servlet-class>
    <init-param>
          <param-name>userName</param-name>
          <param-value>Tommy</param-value>
    </init-param>
    <init-param>
          <param-name>E-mail</param-name>
          <param-value>[e-mail]</param-value>
    </init-param>
</servlet>

        經過上面的配置，在servlet中能夠調用getServletConfig().getInitParameter("param1")獲得參數名對應的值。

//上下文參數：聲明應用范圍內的初始化參數。  
<context-param>  
    <param-name>ContextParameter</para-name>  
    <param-value>test</param-value>  
    <description>It is a test parameter.</description>  
</context-param>  
//在servlet里面可以通過getServletContext().getInitParameter("context/param")

 

得到  

• 指定錯誤處理頁面，可以通過“異常類型”或“錯誤碼”來指定錯誤處理頁面。

<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>
<error-page>  
      <exception-type>java.lang.NullException</exception-type>  
      <location>/error.jsp</location>  
</error-page> 

• 設置過濾器：比如設置一個編碼過濾器，過濾所有資源

<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.設置監聽器

        web.xml中的<listener></listener>有什么用? 沒別的用處!就是配置監聽類的~，它能捕捉到服務器的啟動和停止! 在啟動和停止觸發里面的方法做相應的操作! 它必須在web.xml 中配置才能使用! web.xml 中listener元素不是只能有一個，有多個時按順序執行。

        如何在web.xml向listener中傳參數 ？

<listener> 
     <listener-class>監聽器類的完整路徑</listener-class> 
</listener> 

         監聽器中不能夠寫初始化參數; 可通過另個的途徑達到初始化參數的效果: 1.寫一個properties文件,在文件里寫好初始化參數值, 2.在監聽器中可以通得到properties文件中的值(寫在靜態塊中)。

• 設置會話(Session)過期時間，其中時間以分鍾為單位

<session-config>
     <session-timeout>60</session-timeout>
</session-config>

 

除了這些標簽元素之外，還可以往web.xml中添加那些標簽元素呢，那些標簽元素都能起什么作用呢？我們只要去查看web.xml的模式文件就能知道。直接看模式文件看不懂，可以找一些中文教程來看看。

 

 

三.遺留問題

1. 在項目中總會遇到一些關於加載的優先級問題，近期也同樣遇到過類似的，所以自己查找資 料總結了下，下面有些是轉載其他人的，畢竟人家寫的不錯，自己也就不重復造輪子了，只 是略加點了自己的修飾。 首先可以肯定的是，加載順序與它們在 web.xml 文件中的先后順序無關。即不會 因為 filter 寫在 listener 的前面而會先加載 filter。最終得出的結論是：listener -> filter -> servlet  。<session-config></session-config> 如果某個會話在一定時間內未被訪問，服務器可 以拋棄它以節省內存。可通過使用HttpSession的setMaxInactiveInterval方法明確設置單個會話對 象的超時值，或者可利用session-config元素制定缺省超時值。
2. <welcome-file-list></welcome-file-list> 指示服務器在收到引用一個目錄名而不是 文件名的URL時，使用哪個文件。
3. web.xml中怎么配置url-pattern？ 首先要知道 web.xml 中url-pattern的作用，他是給外部提供的一個訪問DoGetDemo類的接口，你可以自己隨意定義，然后在IE里面寫入這個配置內容。 可以看我給你寫的一個例子圖片，應該一下就看懂的，用 SimpleHello.java 為例，看圖片，訪問的時候，可以輸入下面的網址 http://192.168.0.67:8888/book/hello 這樣，服務器就可以通過 <url-pattern>/hello</url-pattern> 找到ch06.SimpleHello類，因此你的<url-pattern></url-pattern> 里面的內容可以自己定義。然后在應用目錄下訪問這個servlet 。       
4. web.xml中既然有url-pattern為什么還需要servlet-class呢？url-pattern是表明什么格式的的url進入這個servlet ，servlet-class  是表明哪個java類來處理這個請求 ，一個請求過來，先到servlet-mapping中去根據請求的url尋找這個url所對應的url-pattern，找到url-pattern后找到了servlet-name， 然后根據servlet-name和servlet中的servlet-name對應找到其所對應的servlet-class，具體的業務邏輯就寫在來servlet-class對應的java類中了！

四.參考資料

        csdn：http://blog.csdn.net/shanliangliuxing/article/details/7458492

原文鏈接

https://www.cnblogs.com/hxsyl/p/3435412.html

SpringMVC核心分發器DispatcherServlet分析[附帶源碼分析]

https://www.cnblogs.com/fangjian0423/p/springMVC-dispatcherServlet.html