轉自https://blog.csdn.net/ee470474137/article/details/45721025


<!--該元素聲明應用範圍內的初始化參數-->
<context-param>
    <!--聲明描述信息-->
    <description></description>
    <!--用於指定上下文參數的名稱-->
    <param-name></param-name>
    <!--用於指定上下文參數的值-->
    <param-value></param-value>
 </context-param>
 

<!--聲明WEB應用的描述信息-->
<description></description>

<!--定義了WEB應用的名字-->
<display-name></display-name>

<!--用於-->
<distributable/>

<!--聲明一個EJB的本地主目錄的應用-->
<ejb-local-ref>
    <!--聲明描述信息-->
    <description></description>
<!--當前bean從一個不同jar包中引用另外一個bean的名稱。通過ejb-link元素定義的名稱必須使用"#"和bean註冊名與Web應用程序中war文件的位置相關聯-->
    <ejb-link></ejb-link>
    <!--java:comp/env的對應的EJB引用名-->
    <ejb-ref-name></ejb-ref-name>
    <!--用於聲明實體或會話的bean類型-->
    <ejb-ref-type></ejb-ref-type>
    <!--用於指定包含企業Bean本地接口的完全限定名稱-->
    <local></local>
    <!--用於指定包含企業Bean本地Home接口的完全限定名稱-->
    <local-home></local-home>
</ejb-local-ref>
 

<!--聲明一個EJB的主目錄的引用-->
<ejb-ref>
    <!--聲明描述信息-->
    <description></description>
<!--當前bean從一個不同jar包中引用另外一個bean的名稱。通過ejb-link元素定義的名稱必須使用"#"和bean註冊名與Web應用程序中war文件的位置相關聯-->
    <ejb-link></ejb-link>
    <!--java:comp/env的對應的EJB引用名-->
    <ejb-ref-name></ejb-ref-name>
    <!--用於聲明實體或會話的bean類型-->
    <ejb-ref-type></ejb-ref-type>
    <!--用於指定EJB Home接口的完全限定名稱-->
    <home></home>
    <!--bean的remote接口的完全限定名稱-->
    <remote></remote>
</ejb-ref>
 

<!--聲明Web應用的環境項-->
<env-entry>
    <!--聲明描述信息-->
    <description></description>
<!--一個相對於java:comp/env環境JNDI名-->
    <env-entry-name></env-entry-name>
<!--（java.lang程序包中一個類型的完全限定類名，java.lang.Boolean、java.lang.String等）組成-->
    <env-entry-type></env-entry-type>
<!--用於指定環境條目的值-->
    <env-entry-value></env-entry-value>
</env-entry>

<!--在返回特定HTTP狀態代碼時，或者特定類型的異常被拋出時，能夠制定將要顯示的頁面-->
<error-page>
    <!--用於指定Http的錯誤代碼-->
    <error-code></error-code>
    <!--用於指定程序中的異常(異常的完整路徑)-->
    <exception-type></exception-type>
    <!--用於指定程序出現錯誤時，跳轉到的頁面-->
    <location></location>
</error-page>

<!--過濾器元素將一個名字與一個實現javax.servlet.Filter接口的類相關聯-->
<filter>
    <!--聲明描述信息-->
    <description></description>
    <!--用於定義Web應用的名稱-->
    <display-name></display-name>
    <!--用於指定當前filter對應的類的路徑-->
    <filter-class></filter-class>
    <!--用於對當前filter取一個名稱，以便在後面的映射時使用-->
    <filter-name></filter-name>
    <!--指定應用的大圖標和小圖標-->
    <icon></icon>
    <!--用於指定當前filter的一些初始化參數-->
    <init-param></init-param>
</filter>

<!--一旦命名了一個過濾器，就要利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯-->
<filter-mapping>
<!--該元素有四個可能的值：即REQUEST(默認),FORWARD,INCLUDE和ERROR，可以在一個<filter-mapping>元素中加入任意數目的<dispatcher>，使得filter將會作用於直接從客戶端過來的request，通過forward過來的request，通過include過來的request和通過<error-page>過來的request。如果沒有指定任何< dispatcher >元素，默認值是REQUEST -->
    <dispatcher></dispatcher>
    <!--用於指定上文定義的filter名稱-->
    <filter-name></filter-name>
    <!--用於指定上文定義的servlet名稱-->
    <servlet-name></servlet-name>
    <!--描述用於解析URL的模式-->
    <url-pattern></url-pattern>
</filter-mapping>

<!--Web應用圖標：指出IDE和GUI工具用來表示Web應用的大圖標和小圖標-->
<icon>
    <!--用於指定大圖標-->
    <large-icon></large-icon>
    <!--用於指定小圖標-->
    <small-icon></small-icon>
</icon>

<!--該元素主要用來設定JSP的相關配置-->
<jsp-config>
    <!--定義了一組JSP的特性。這些特性實際上對應JSP的page directive定義的特性-->
    <jsp-property-group>
        <!--聲明描述信息-->
        <description></description>
        <!--用於定義Web應用的名稱-->
        <display-name></display-name>
        <!--若為true,表示不支持EL語法-->
        <el-ignored></el-ignored>
        <!--指定應用的大圖標和小圖標-->
        <icon></icon>
        <!--設置JSP網頁的結尾,擴展名為.jspf -->
        <include-coda></include-coda>
        <!--設置JSP網頁的擡頭,擴展名為.jspf -->
        <include-prelude></include-prelude>
<!--如果節點值為：true則表示這個文件為jsp文檔（xml格式），如果為false，則表示為標準的jsp文件-->
        <is-xml></is-xml>
        <!--設定JSP網頁的編碼-->
        <page-encoding></page-encoding>
        <!--若為true表示不支持<%scription%>語法-->
        <scripting-invalid></scripting-invalid>
        <!--設定值所影響的範圍,如:/CH2 或者/*.jsp -->
        <url-pattern></url-pattern>
    </jsp-property-group>
    <!--用來設定JSP網頁用到的Tag Library路徑-->
    <taglib>
        <!--用於指定TLD文件對應Web站臺的存放位置-->
        <taglib-location></taglib-location>
<!--用於指定TLD文件的URI,JSP網頁的taglib指令可以由這個URI存取到TLD文件-->
        <taglib-uri></taglib-uri>
    </taglib>
 </jsp-config>

<!--servlet API的版本2.3增加了對事件監聽程序的支持，事件監聽程序在建立、修改和刪除會話或servlet環境時得到通知。Listener元素指出事件監聽程序類-->
<listener>
    <!--聲明描述信息-->
    <description></description>
    <!--用於定義Web應用的名稱-->
    <display-name></display-name>
    <!--指定應用的大圖標和小圖標-->
    <icon></icon>
    <!--用於指定監聽器的類(完整路徑)-->
    <listener-class></listener-class>
</listener>

<!--該元素用來設置各種Locale和字符集編碼之間的映射關系的集合-->
<locale-encoding-mapping-list>
    <!--該元素用來設置各種Locale和字符集編碼之間的映射關系-->
    <locale-encoding-mapping>
        <!--該元素用來指定其Locale的名稱，如：zh-CN-->
        <locale></locale>
        <!--該元素用來指定其編碼方式-->
        <encoding></encoding>
    </locale-encoding-mapping>
</locale-encoding-mapping-list>

<!--指定服務器應該怎樣給試圖訪問受保護頁面的用戶授權。它與sercurity-constraint元素聯合使用-->
<login-config>
    <!--指定對用戶身份驗證的方法。可能值：
BASIC:使用瀏覽器進行身份驗證(默認)，
FORM：使用用戶編寫的HTML表單-->
    <auth-method></auth-method>
<!--指定必需相對於文檔根目錄的web資源的URI，用於對用戶進行身份驗證。這個可以是HTML頁面、JSP或者HTTP Servlet，且必須返回-->
    <form-login-config></form-login-config>
    <!--用於對用戶憑據進行身份驗證時所引用的領域名稱-->
    <realm-name></realm-name>
</login-config>

<!--元素指定了一個邏輯目標消息，後者映射到服務器特有部署描述文件中的物理目標信息-->
<message-destination>
    <!--聲明描述信息-->
    <description></description>
    <!--用於定義Web應用的名稱-->
    <display-name></display-name>
    <!--指定應用的大圖標和小圖標-->
    <icon></icon>
    <!--為一個目標信息指定一個唯一的名稱(僅限於web.xml中)-->
    <message-destination-name></message-destination-name>
</message-destination>

<!--用於指出將引用與web.xml中聲明資源相關聯的信息地址-->
<message-destination-ref>
    <!--聲明描述信息-->
    <description></description>
<!--用來連接對一個目標消息的引用。它的值必須通過web.xml文件或者在同一個J2EE應用單元的部署描述文件中message-destination元素的message-destination-name子元素來聲明-->
    <message-destination-link></message-destination-link>
<!--定義一個信息地址引用的JNDI名(相對於java:comp/env上下文)。在web.xml中，這個名稱必須唯一-->
    <message-destination-ref-name></message-destination-ref-name>
<!--素聲明了目標的類型，可以是javax.jms.Queue或javax.jms.Topic-->
    <message-destination-type></message-destination-type>
<!--說明引用所指定的目標信息的使用情況。它的值指出是使用目標信息中的消息，還是產生目標信息，亦或兩者兼有(有效值為Consumes，Produces或ConsumesProduces)-->
    <message-destination-usage></message-destination-usage>
</message-destination-ref>

<!--如果Web應用具有想到特殊的文件，希望能保證給他們分配特定的MIME類型，則mime-mapping元素提供這種保證-->
<mime-mapping>
    <!--用於指定其擴展名名稱-->
    <extension></extension>
    <!--用於指定MIME的格式-->
    <mime-type></mime-type>
</mime-mapping>

<!--聲明與資源相關的一個管理對象-->
<resource-env-ref>
    <!--聲明描述信息-->
    <description></description>
<!--指定資源環境引用的名稱，其它值為web應用程序代碼中使用的環境條目名稱。名稱是相對於java:comp/env上下文的JNDI名稱，該名稱在web應用程序中必須唯一-->
    <resource-env-ref-name></resource-env-ref-name>
    <!--指定資源環境引用的類型，它是java語言的類或者接口的完全限定名稱-->
    <resource-env-ref-type></resource-env-ref-type>
</resource-env-ref>

<!--聲明一個資源工廠使用的外部資源-->
<resource-ref>
    <!--聲明描述信息-->
    <description></description>
    <!--用於指定資源由Application或Container來許可-->
    <res-auth></res-auth>
    <!--用於指定資源名稱 -->
    <res-ref-name></res-ref-name>
    <!--用於指定資源是否可以共享.默認值為 Shareable -->
    <res-sharing-scope></res-sharing-scope>
    <!--用於指定資源種類-->
    <res-type></res-type> 
</resource-ref>

<!--制定應該保護的URL。它與login-config元素聯合使用-->
<security-constraint>
    <!--用於定義那些組或委托人可以訪問此安全約束內定義的web資源集合-->
    <auth-constraint></auth-constraint>
    <!--用於定義Web應用的名稱-->
    <display-name></display-name>
    <!--用於定義客戶端如何與服務器進行通信-->
    <user-data-constraint></user-data-constraint>
    <!--用於定義用此安全約束的web應用程序的區域-->
    <web-resource-collection></web-resource-collection>
</security-constraint>

<!--給出安全角色的一個列表，這些角色將出現在servlet元素內的security-role-ref元素的role-name子元素中。分別地聲明角色可使高級IDE處理安全信息更為容易-->
<security-role>
    <!--聲明描述信息-->
    <description></description>
    <!--用於定義那些安全角色可以訪問在此安全約束中定義的資源-->
    <role-name></role-name>
</security-role>

<!--該元素聲明一個對Web服務的引用-->
<service-ref>
    <!--聲明描述信息-->
    <description></description>
    <!--用於定義Web應用的名稱-->
    <display-name></display-name>
<!--元素為端口組件聲明處理器。它包含一個必需的handler-name和handlerclass和可選的init-param，soap-header，soap-role和port-name元素。handler-name元素定義了處理器的名稱(在web.xml中是唯一的)。handler-class定義了處理器所實現類的完全限定名-->
    <handler></handler>
    <!--指定應用的大圖標和小圖標-->
    <icon></icon>
<!--該元素包含將WSDL定義映射到服務終端接口和服務接口的那個文件的位置-->
    <jaxrpc-mapping-file></jaxrpc-mapping-file>
<!--該元素聲明了一個在容器中解析服務終端接口到一個WSDL端口的客戶端依賴關系。它使用一個特別的端口組件選擇性地關聯服務終端接口-->
    <port-component-ref></port-component-ref>
    <!--該元素指定Web應用所依賴的JAX-RPC完全限定接口名-->
    <service-interface></service-interface>
<!--該元素與其兩個子元素(namespaceURI和localpart)聲明了正在引用的WSDL服務元素。如果不指定wsdl-file元素或者WSDL文件只包含一個服務-->
    <service-qname></service-qname>
<!--該元素定義的Web服務(與java:comp/env上下文對應的)-->
    <service-ref-name></service-ref-name>
<!--該元素包含Web服務描述語言文件的位置(相對於Web應用程序的根目錄)。這個文件必須放在WEB-INF/wsdl目錄中-->
    <wsdl-file></wsdl-file>
</service-ref>

<!--在向servlet或JSP頁面制定初始化參數或定制URL時，必須首先命名servlet或JSP頁面。Servlet元素就是用來完成此項任務的-->
<servlet>
    <!--聲明描述信息-->
    <description></description>
    <!--用於定義Web應用的名稱-->
    <display-name></display-name>
    <!--指定應用的大圖標和小圖標-->
    <icon></icon>
    <!--用於指定servlet的一些初始化參數-->
    <init-param></init-param>
    <!--用於指定一個jsp頁面來對該servlet進行初始化-->
    <jsp-file></jsp-file>
<!--用於指定應用啟動時加載的優先級-->
    <load-on-startup></load-on-startup>
    <!--該元素指定了該web應用程序運行時所需用的運行身份-->
    <run-as></run-as>
<!--該元素將 <security-role> 定義的安全角色名鏈接到使用Servlet邏輯進行硬編碼的備用角色名。使用此附加提取層，可以在部署時配置Servlet，且不必更改Servlet 代碼-->
    <security-role-ref></security-role-ref>
    <!--用於指定當前servlet對應的類的路徑-->
    <servlet-class></servlet-class>
    <!--用於對當前servlet取一個名稱，以便在後面的映射時使用-->
    <servlet-name></servlet-name>
</servlet>

<!--服務器一般為servlet提供一個缺省的URL：http://host/webAppPrefix/servlet/ServletName。 但是，常常會更改這個URL，以便servlet可以訪問初始化參數或更容易地處理相對URL。在更改缺省URL時，使用servlet-mapping元素-->
<servlet-mapping>
    <!--用於指定上文配置的servlet的名稱-->
    <servlet-name></servlet-name>
<!--描述用於解析URL的模式-->
    <url-pattern></url-pattern>
</servlet-mapping>

<!--如果某個會話在一定時間內未被訪問，服務器可以拋棄它以節省內存。可通過使用HttpSession的setMaxInactiveInterval方法明確設置單個會話對象的超時值，或者可利用session-config元素制定缺省超時值-->
<session-config>
    <!--用於session的超時時間-->
    <session-timeout></session-timeout>
</session-config>

<!--指示服務器在收到引用一個目錄名而不是文件名的URL時，使用哪個文件-->
<welcome-file-list>
    <!--用於指定歡迎頁面的路徑-->
    <welcome-file></welcome-file>
</welcome-file-list>

web.xml標簽詳解