程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> 關於ASP.NET >> web.xml的詳細配置

web.xml的詳細配置

編輯:關於ASP.NET

1 定義頭和根元素

部署描述符文件就像所有XML文件一樣,必須以一個XML頭開始。這個頭聲明可以使用的XML版本並給出文件的字符編碼。

DOCYTPE聲明必須立即出現在此頭之後。這個聲明告訴服務器適用的servlet規范的版本(如2.2或2.3)並指定管理此文件其余部分內容的語法的DTD(Document Type Definition,文檔類型定義)。

所有部署描述符文件的頂層(根)元素為web-app。

請注意,XML元素不像HTML,他們是大小寫敏感的。因此,web-App和WEB-APP都是不合法的,web-app必須用小寫。

2 部署描述符文件內的元素次序

XML 元素不僅是大小寫敏感的,而且它們還對出現在其他元素中的次序敏感。例如,XML頭必須是文件中的第一項,DOCTYPE聲明必須是第二項,而web- app元素必須是第三項。在web-app元素內,元素的次序也很重要。服務器不一定強制要求這種次序,但它們允許(實際上有些服務器就是這樣做的)完全拒絕執行含有次序不正確的元素的Web應用。這表示使用非標准元素次序的web.xml文件是不可移植的。

下面的列表給出了所有可直接出現在web-app元素內的合法元素所必需的次序。例如,此列表說明servlet元素必須出現在所有servlet-mapping元素之前。請注意,所有這些元素都是可選的。因此,可以省略掉某一元素,但不能把它放於不正確的位置。

icon :指出IDE和GUI工具用來表示Web應用的一個和兩個圖像文件的位置。

display-name :提供GUI工具可能會用來標記這個特定的Web應用的一個名稱。

description :給出與此有關的說明性文本。

distributable 元素為空標簽,它的存在與否可以指定站台是否可分布式處理.如果web.xml中出現這個元素,則代表站台在開發時已經

被設計為能在多個JSP Container 之間分散執行.

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 :指示服務器在收到引用一個目錄名而不是文件名的URL時,使用哪個文件。

error-page:使得在返回特定HTTP狀態代碼時,或者特定類型的異常被拋出時,能夠制定將要顯示的頁面。

taglib :對標記庫描述符文件(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD文件的位置,而不用編輯使用這些文件的JSP頁面。

resource-env-ref :聲明與資源相關的一個管理對象。

resource-ref :聲明一個資源工廠使用的外部資源。

security-constraint :制定應該保護的URL。它與login-config元素聯合使用

login-config :用login-config元素來指定服務器應該怎樣給試圖訪問受保護頁面的用戶授權。它與sercurity-constraint元素聯合使用。

security-role :給出安全角色的一個列表,這些角色將出現在servlet元素內的security-role-ref元素的role-name子元素中。分別地聲明角色可使高級IDE處理安全信息更為容易。

env-entry :聲明Web應用的環境項。

ejb-ref :聲明一個EJB的主目錄的引用。

ejb-local-ref :聲明一個EJB的本地主目錄的應用。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved