web.xml的元素
首先注意 xml是大小寫敏感的
1、 web.xml的頭和根元素
必須以一個XML頭開始。這個頭聲明可以使用的XML版本并給出文件的字符編碼。
DOCYTPE聲明必須立即出現在此頭之后。這個聲明告訴服務器適用的servlet規范的版本(如2.2或2.3)并指定管理此文件其余部分內容的語法的DTD(Document Type Definition,文檔類型定義)。
所有部署描述符文件的頂層(根)元素為web-app。
例(紅色部分是可選項):
--------------------------------------------------------------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "?? <web-app id="WebApp">
?? </web-app>
--------------------------------------------------------------------------------------------------------------------------
?2、元素
以下元素幾乎都是可選項,不過要注意它們是有順序的。雖然有些服務器要求寬松些,但某些服務器會拒絕執行順序不正確的web應用。所以還是按順序寫好
--------------------------------------------------------------------------------------------------------------------------
· icon icon元素指出IDE和GUI工具用來表示Web應用的一個和兩個圖像文件的位置。
· display-name display-name元素提供GUI工具可能會用來標記這個特定的Web應用的一個名稱。
· description description元素給出與此有關的說明性文本。
· context-param context-param元素聲明應用范圍內的初始化參數。
· filter 過濾器元素將一個名字與一個實現javax.servlet.Filter接口的類相關聯。
· filter-mapping 一旦命名了一個過濾器,就要利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯。
· listener servlet API的版本2.3增加了對事件監聽程序的支持,事件監聽程序在建立、修改和刪除會話或servlet環境時得到通知。Listener元素指出事件監聽程序類。
· servlet 在向servlet或JSP頁面制定初始化參數或定制URL時,必須首先命名servlet或JSP頁面。Servlet元素就是用來完成此項任務的。
· servlet-mapping服務器一般為servlet提供一個缺省的URL:http://host/webAppPrefix/servlet/ServletName。但是,常常會更改這個URL,以便servlet可以訪問初始化參數或更容易地處理相對URL。在更改缺省URL時,使用servlet-mapping元素。
·session-config如果某個會話在一定時間內未被訪問,服務器可以拋棄它以節省內存。可通過使用HttpSession的setMaxInactiveInterval方法明確設置單個會話對象的超時值,或者可利用session-config元素制定缺省超時值。
· mime-mapping 如果Web應用具有想到特殊的文件,希望能保證給他們分配特定的MIME類型,則mime-mapping元素提供這種保證。
· welcom-file-list welcome-file-list元素指示服務器在收到引用一個目錄名而不是文件名的URL時,使用哪個文件。
· error-page error-page元素使得在返回特定HTTP狀態代碼時,或者特定類型的異常被拋出時,能夠制定將要顯示的頁面。
· taglib taglib元素對標記庫描述符文件(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD文件的位置,而不用編輯使用這些文件的JSP頁面。
· resource-env-ref resource-env-ref元素聲明與資源相關的一個管理對象。
· resource-ref resource-ref元素聲明一個資源工廠使用的外部資源。
· security-constraint security-constraint元素制定應該保護的URL。它與login-config元素聯合使用
· login-config 用login-config元素來指定服務器應該怎樣給試圖訪問受保護頁面的用戶授權。它與sercurity-constraint元素聯合使用。
· security-role security-role元素給出安全角色的一個列表,這些角色將出現在servlet元素內的security-role-ref元素的role-name子元素中。分別地聲明角色可使高級IDE處理安全信息更為容易。
· env-entry env-entry元素聲明Web應用的環境項。
· ejb-ref ejb-ref元素聲明一個EJB的主目錄的引用。
· ejb-local-ref ejb-local-ref元素聲明一個EJB的本地主目錄的應用。
posted on 2007-08-28 18:00
Robin's Programming World 閱讀(1792)
評論(0) 編輯 收藏 所屬分類:
轉載