java學習記錄（11）

java web專案的部署描述檔案–web.xml

提綱

1. web.xml是什麼
2. java web專案的啟動過程
3. web.xml中的一些標籤的含義
4. 專案中的web.xml的解釋

1 web.xml是什麼

   java web專案用部署描述檔案來決定URLS與servlets的對映，哪些URLS需要進行驗證等。這個部署描述檔案是web.xml，它在java web專案打包war下面的WEB-INF目錄下面，是java web專案中serverlet標準的一個部分。

2 java web專案的啟動過程

   web.xml有多項標籤，在其載入的過程中順序依次為：context-param >> listener >> fileter >> servlet​。（同類多個節點以出現順序依次載入）
1. ​web.xml先讀取context-param和listener這兩種節點；
2. 然後容器建立一個ServletContext(上下文)，應用於整個專案；
​3. 容器會將讀取到的context-param轉化為鍵值對並存入servletContext；
​4. 根據listener建立監聽；
5. 容器會讀取，根據指定的類路徑來例項化過濾器；
6. 此時專案初始化完成；
7. 在發起第一次請求是，servlet節點才會被載入例項化。​

3 web.xml中的一些標籤的含義

（1） XML文件有效性檢查

   不同的版本的web.xml文件書寫有不同的格式。下面是3.1版本的部署描述符的書寫格式。

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
 

         version="3.1">
</web-app>

（2）display-name

   定義了web相應的名稱，在把war檔案放入到tomcat中在manager中就可以檢視到對應的web名稱。

<display-name>sshTest</display-name>

（3）context-param

   1 context-param 定義了程式執行的上下文的一些引數，這裡定義的是applicationContext.xml的檔案路徑。

<context-param>
        <param
 
-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext*.xml</param-value>
</context-param>

   2 context-param值的獲取，例如上例中的contextConfigLocation，可以在aciton中通過ServletActionContext來獲取相關的引數。

String param_name=ServletActionContext.getServletContext().getInitParameter("contextConfigLocation");
        System.out.println(param_name);

   3 context-param的使用

什麼情況下使用，為什麼使用context-param：
比如：定義一個管理員email地址用來從程式傳送錯誤，或者與你整個應用程式有關的其他設定。使用自己定義的設定檔案需要額外的程式碼和管理；直接在你的程式中使用硬編碼（Hard-coding）引數值會給你之後修改程式帶來麻煩，更困難的是，要根據不同的部署使用不同的設定；通過這種辦法，可以讓其他開發人員更容易找到相關的引數，因為它是一個用於設定這種引數的標準位置。
   4 spring的配置
配置Spring，必須需要listener，而context-param>可有可無，如果在web.xml中不寫context-param>配置資訊，預設的路徑是/WEB-INF/applicationContext.xml，在WEB-INF目錄下建立的xml檔案的名稱必須是applicationContext.xml。如果是要自定義檔名可以在web.xml里加入contextConfigLocation這個context引數：在param-value>裡指定相應的xml檔名，如果有多個xml檔案，可以寫在一起並以“,”號分隔，比如在business-client工程中，我們採用了自定義配置方式，context-param配置如下：

<!-- spring -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext*.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

（4）listener

listener 為web應用程式定義監聽器，監聽器用來監聽各種事件，比如：application和session事件，所有的監聽器按照相同的方式定義，功能取決去它們各自實現的介面，常用的Web事件介面有如下幾個：
1） ServletContextListener：用於監聽Web應用的啟動和關閉；
2） ServletContextAttributeListener：用於監聽ServletContext範圍（application）內屬性的改變；
3） ServletRequestListener：用於監聽使用者的請求；
ServletRequestAttributeListener：用於監聽ServletRequest範圍（request）內屬性的改變；
4） HttpSessionListener：用於監聽使用者session的開始和結束；
5） HttpSessionAttributeListener：用於監聽HttpSession範圍（session）內屬性的改變。
listener主要用於監聽Web應用事件，其中有兩個比較重要的WEB應用事件：應用的啟動和停止（starting up or shutting down）和Session的建立和失效（created or destroyed）。應用啟動事件發生在應用第一次被Servlet容器裝載和啟動的時候；停止事件發生在Web應用停止的時候。Session建立事件發生在每次一個新的session建立的時候，類似地Session失效事件發生在每次一個Session失效的時候。為了使用這些Web應用事件做些有用的事情，我們必須建立和使用一些特殊的“監聽類”。它們是實現了以下兩個介面中任何一個介面的簡單java類：javax.servlet.ServletContextListener或javax.servlet.http.HttpSessionListener，如果想讓你的類監聽應用的啟動和停止事件，你就得實現ServletContextListener介面；想讓你的類去監聽Session的建立和失效事件，那你就得實現HttpSessionListener介面。

<listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener> 

（5）filter

<!-- struts2 -->
    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>struts2</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

（6）welcome-file-list

   初始頁，包含多個以此嘗試

<welcome-file-list>
    <!-- /WEB-INF/jsp/login.jsp -->

        <welcome-file>/index.html</welcome-file>
    </welcome-file-list>

參考連結