在每一個Web應(yīng)用程序路徑的Web-INF下和conf下存在一個Web.xml配置文件，
用來設(shè)定Web應(yīng)用程序的配置。在Web.xml中的設(shè)定非常多，
PUBLIC"-//Sun Microsystems,Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd"> PUBLIC"-//Sun Microsystems,Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd">
這是一般XML所需要做的聲明，包含定義XML的版本、編碼格式dtd來源。
Web.xml的dtd是由Sun Microsystems公司所制定的，可以在下列的網(wǎng)址獲得詳細的信息：
http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd。
下列部分描述根元素 <Web-APP>下的 Web.xml Schema 中定義的部署描述符元素。
context-param
description
display-name
distributable
ejb-ref
ejb-local-ref
env-entry
error-page
filter
filter-mapping
icon
listener
login-config
mime-mapping
resource-env-ref
resource-ref
security-constraint
security-role
Servlet
servlet-mapping
session-config
taglib
Web-app
welcome-file-list
--------------------------------------------------------------------------------
icon
icon 元素指定用于在 GUI 工具中表示 Web 應(yīng)用程序的大小圖像在 Web 應(yīng)用程序中的位置。（servlet 元素中也有一個名為 icon 的元素，用于提供在 GUI 工具中表示 servlet 的圖標。）
下表描述可以在 icon 元素中定義的元素。
元素 必需/可選 描述
-------------------------------------------------------------------------------- display-name 可選的 display-name 元素指定 Web 應(yīng)用程序的顯示名稱（可以由 GUI 工具顯示的簡短名稱）。 元素 必需/可選 描述 -------------------------------------------------------------------------------- description 可選的 description 元素提供關(guān)于 Web 應(yīng)用程序的描述性文本。 元素 必需/可選 描述 -------------------------------------------------------------------------------- distributable WebLogic Server 不使用 distributable 元素。 元素 必需/可選 描述 -------------------------------------------------------------------------------- context-param 可選的 context-param 元素中包含 Web 應(yīng)用程序的 Servlet 上下文初始化參數(shù)的聲明。下表描述 Web 應(yīng)用程序容器所使用的保留上下文參數(shù)，在 Weblogic.xml 中已不贊成使用這些參數(shù)，而提供了替換參數(shù)。 不贊成使用的參數(shù) 描述 Weblogic.xml 中的替換元素 Weblogic.httpd.inputCharset 定義非 unicode 操作的代碼集行為。 Weblogic.xml 中的 input-charset（在 charset-param 內(nèi)定義）。請參閱 input-charset。 Weblogic.httpd.servlet.reloadCheckSecs 定義 WebLogic Server 檢查 servlet 是否發(fā)生修改的頻率，如果已修改，則重新加載。值為 -1 則永不重新加載，值為 0 則始終重新加載。默認設(shè)置為 1 秒。 Weblogic.xml 中的 servlet-reload-check-secs（在 container-descriptor 中定義）。請參閱 container-descriptor。 Weblogic.httpd.servlet.classpath 設(shè)置此值后，容器會將此路徑追加到 Web 應(yīng)用程序類路徑上。不建議采用此方法，對于此方法的支持僅為向后兼容。 無替換。使用其他方法，例如清單類路徑或 Web-INF/lib 或 Web-INF/classes 或虛擬目錄。 Weblogic.httpd.defaultServlet 設(shè)置 Web 應(yīng)用程序的默認 servlet。不建議采用此方法， 對于此方法的支持僅為向后兼容。 無替換。而是使用 Web.xml 中的 servlet 和 servlet-mapping 元素定義默認 servlet。默認 servlet 的 URL 模式應(yīng)該是“/”。請參閱 servlet-mapping。有關(guān) servlet 映射的其他示例，請參閱 Servlet 映射。 以下 context-param 參數(shù)仍有效。 元素 必需/可選 描述 Weblogic.httpd. clientCertProxy optional 此特性指定 Web 應(yīng)用程序客戶端的證書由代理插件或 HttpClusterServlet所發(fā)送的特殊 WL-Proxy-Client-Cert 頭提供。 如果在代理服務(wù)器上執(zhí)行用戶身份驗證，則此設(shè)置適用 – 設(shè)置 clientCertProxy 會使代理服務(wù)器在特殊的頭 WL-Proxy-Client-Cert中將證書傳遞給群集。 WL-Proxy-Client-Cert 頭可以由能夠訪問 WebLogic Server 的任意客戶端提供。WebLogic Server 從該頭中獲取證書信息，信任它來自安全來源（該插件）并使用該信息來對用戶進行身份驗證。 出于此原因，如果您設(shè)置 clientCertProxy，請使用連接篩選器確保 WebLogic Server 僅接受來自正在運行該插件的計算機的連接。 除為單個 Web 應(yīng)用程序設(shè)置此特性外，您還可以定義此特性： 在管理控制臺中的“服務(wù)器”-->“配置”-->“常規(guī)”頁面上，為服務(wù)器示例承載的所有 Web 應(yīng)用程序設(shè)置該特性 在“群集”-->“配置”-->“常規(guī)”頁面上，為群集中服務(wù)器實例所承載的所有 Web 應(yīng)用程序設(shè)置該特性 -------------------------------------------------------------------------------- filter filter 元素定義篩選器類及其初始化特性。有關(guān)篩選器的詳細信息，請參閱配置篩選器。 下表描述可在 filter 元素中定義的元素。 元素 必需/可選 描述 當前 WebLogic Server 尚不使用此元素。 每個特性使用獨立的一組 -------------------------------------------------------------------------------- filter-mapping 下表描述可在 filter-mapping元素中定義的元素。 元素 必需/可選 描述 示例模式： /soda/grape/* /foo/* /contents *.foo URL 必須遵循 Servlet 2.3 規(guī)范中指定的規(guī)則。 -------------------------------------------------------------------------------- listener 使用 listener 元素定義應(yīng)用程序監(jiān)聽器。 元素 必需/可選 描述 有關(guān)詳細信息，請參閱配置事件監(jiān)聽器類。 -------------------------------------------------------------------------------- servlet servlet 元素中包含 servlet 的聲明性數(shù)據(jù)。 如果指定了 jsp-file 且存在 下表描述可在 servlet 元素中定義的元素。 元素 必需/可選 描述 當前 WebLogic Server 尚不使用此元素。 file>） servlet 的完全限定類名。 在 servlet 正文中僅使用 class>） Web 應(yīng)用程序中的 JSP 文件相對于 Web 應(yīng)用程序根目錄的完整路徑。 在 servlet 正文中僅使用 每個特性使用獨立的一組 <>< p=""> ref> ref> 可選 用于將 icon 這是 Servlet 內(nèi)的元素。 icon 元素指定用于在 GUI 工具中表示 servlet 的大小圖像在 Web 應(yīng)用程序中的位置。 下表描述可以在 icon 元素中定義的元素。 元素 必需/可選 描述 當前 WebLogic Server 尚不使用此元素。 當前 WebLogic Server 尚不使用此元素。 init-param 這是 Servlet 內(nèi)的元素。 可選的 init-param元素中包含用作 servlet 的初始化特性的名/值對。每個特性使用獨立的一組 init-param 標記。 您可以使用 javax.servlet.ServletConfig.getInitParameter() 方法訪問這些特性。 下表描述可在 init-param元素中定義的元素。 元素 必需/可選 描述 必需 定義此特性的名稱。 必需 為此特性定義一個 String 值。 security-role-ref 這是 Servlet 內(nèi)的元素。 security-role-ref 元素將 下表描述可在 security-role-ref元素中定義的元素。 元素 必需/可選 描述 -------------------------------------------------------------------------------- servlet-mapping servlet-mapping 元素定義 servlet 和 URL 模式之間的映射。 下表描述可在 servlet-mapping元素中定義的元素。 元素 必需/可選 描述 示例模式： /soda/grape/* /foo/* /contents *.foo URL 必須遵循 Servlet 2.3 規(guī)范中指定的規(guī)則。 有關(guān) Servlet 映射的其他示例，請參閱 Servlet 映射。 -------------------------------------------------------------------------------- session-config session-config 元素為此 Web 應(yīng)用程序定義會話特性。 下表描述可在 session-config 元素中定義的元素。 元素 必需/可選 描述 默認值：-2 最大值：Integer.MAX_VALUE ? 特殊值： -2 表示使用 Weblogic.xml的 -1 表示會話永不超時。將忽略 Weblogic.xml 的 有關(guān)詳細信息，請參閱 session-descriptor。 -------------------------------------------------------------------------------- mime-mapping mime-mapping 元素定義擴展名和 mime 類型之間的映射。 下表描述可在 mime-mapping元素中定義的元素。 元素 必需/可選 描述 -------------------------------------------------------------------------------- welcome-file-list 可選的 welcome-file-list 元素中包含 welcome-file 元素的有序列表。 當 URL 請求是一個目錄名時，WebLogic Server 將提供此元素中指定的第一個文件。如果找不到該文件，則服務(wù)器會嘗試列表中的下一個文件。 有關(guān)詳細信息，請參閱配置歡迎文件。 下表描述可在 welcome-file-list 元素中定義的元素。 元素 必需/可選 描述 -------------------------------------------------------------------------------- error-page 可選的 error-page 元素指定錯誤代碼或異常類型與 Web 應(yīng)用程序中資源路徑之間的映射。 WebLogic Server 響應(yīng) HTTP 請求的過程中發(fā)生錯誤或由于 Java 異常而發(fā)生錯誤時，WebLogic Server 會返回一個 HTML 頁面，其中顯示 HTTP 錯誤代碼或包含 Java 錯誤信息的頁面?？梢远x顯示自己的 HTML 頁面，而不顯示這些默認錯誤頁面，或響應(yīng) Java 異常。 有關(guān)詳細信息，請參閱自定義 HTTP 錯誤響應(yīng)。 下表描述可以在 error-page 元素中定義的元素。 注意： 定義 元素 必需/可選 描述 -------------------------------------------------------------------------------- taglib 可選的 taglib 元素描述 JSP 標記庫。 該元素將 JSP 標記庫描述符（Tag Library Descriptor，簡稱 TLD）與 URI 模式關(guān)聯(lián)起來。盡管您可以在相對于 Web-INF 目錄的 JSP 中指定 TLD，但部署您的 Web 應(yīng)用程序時，您仍可以使用 下表描述可在 taglib元素中定義的元素。 元素 必需/可選 描述 如果該 URI 匹配 JSP 頁面上 taglib 指令中使用的 URI 字符串，則使用此 taglib。 -------------------------------------------------------------------------------- resource-env-ref resource-env-ref 元素包含 Web 應(yīng)用程序?qū)?Web 應(yīng)用程序環(huán)境中的資源所關(guān)聯(lián)的受管理對象的引用的聲明。它包括可選的描述、資源環(huán)境引用名，還指明了 Web 應(yīng)用程序代碼所預(yù)期的資源環(huán)境引用類型。 例如： 元素 必需/可選 描述 -------------------------------------------------------------------------------- resource-ref 可選的 resource-ref 元素定義外部資源的引用查找名。這使得 servlet 代碼能夠通過“虛擬”名稱查找資源，該虛擬名稱將映射至部署時的實際位置。 使用獨立的 下表描述可在 resource-ref元素中定義的元素。 元素 必需/可選 描述 如果設(shè)置為 APPLICATION，則表明應(yīng)用程序組件代碼將以編程方式執(zhí)行資源登錄。如果設(shè)置為 CONTAINER，則 WebLogic Server 將使用隨 login-config 元素建立的安全上下文。請參閱 login-config。 有效值： Shareable（可共享） Unshareable（不可共享） -------------------------------------------------------------------------------- security-constraint security-constraint 元素定義對 <Web-RESOURCE-COLLECTION>元素所定義的資源集合的訪問權(quán)限。 有關(guān)在 Web 應(yīng)用程序中配置安全的詳細說明和示例，請參閱“確保 WebLogic 資源安全”。另外，有關(guān) WebLogic 安全的詳細信息，請參閱WebLogic 安全性編程。 下表描述可在 security-constraint 元素中定義的元素。 元素 必需/可選 描述 <Web-RESOURCE-< p> collection> collection> 必需 定義應(yīng)用此安全約束的 Web 應(yīng)用程序的組件。 <>< p=""> constraint> constraint> 可選 定義客戶端如何與服務(wù)器進行通信。 另請參閱 user-data-constraint Web-resource-collection 每個 這是 security-constraint 內(nèi)的元素。 下表描述可在 Web-resource-collection 元素中定義的元素。 元素 必需/可選 描述 <Web-RESOURCE-< p> name> name> 必需 此 Web 資源集合的名稱。 auth-constraint 這是 security-constraint 內(nèi)的元素。 可選的 auth-constraint 元素定義哪些組或委托人有權(quán)訪問在此安全約束中定義的 Web 資源集合。 下表描述可以在 auth-constraint 元素中定義的元素。 元素 必需/可選 描述 user-data-constraint 這是 security-constraint 內(nèi)的元素。 user-data-constraint元素定義客戶端如何與服務(wù)器進行通信。 下表描述可在 user-data-constraint元素中定義的元素。 元素 必需/可選 描述 <>< p=""> guarantee> guarantee> 必需 指定客戶端和服務(wù)器之間的通信。 當使用 INTEGRAL 或 CONFIDENTIAL 傳輸保證對用戶進行身份驗證時，WebLogic Server 會建立安全套接口層 (SSL) 連接。 值范圍： NONE- 應(yīng)用程序不需要任何傳輸保證。 INTEGRAL- 應(yīng)用程序要求數(shù)據(jù)在客戶端和服務(wù)器之間傳輸?shù)倪^程中不會被更改。 CONFIDENTIAL- 應(yīng)用程序要求傳輸數(shù)據(jù)以防止其他實體觀察到傳輸?shù)膬?nèi)容。 -------------------------------------------------------------------------------- login-config 使用可選的 login-config 元素配置如何對用戶進行身份驗證；應(yīng)用于此應(yīng)用程序的領(lǐng)域名稱；表單登錄機制所需要的特性。 如果使用此元素，則用戶必須經(jīng)過身份驗證才能訪問受 Web 應(yīng)用程序中所定義的 下表描述可在 login-config元素中定義的元素。 元素 必需/可選 描述 BASIC - 使用瀏覽器身份驗證。（這是默認值。） FORM - 使用用戶編寫的 HTML 表單。 CLIENT-CERT 注意： 您可以通過逗號分隔列表定義多個身份驗證方法，以便提供應(yīng)變機制。將按照在 auth-method 列表中定義值的順序嘗試進行身份驗證。請參閱“WebLogic 安全性編程”中的為身份驗證方法提供應(yīng)變機制。 注意： <>< p=""> config> config> 可選 如果您在 FORM 中配置 form-login-config 這是 login-config 內(nèi)的元素。 如果您在 FORM 中配置 . 元素 必需/可選 描述 -------------------------------------------------------------------------------- security-role 下表描述可在 security-role元素中定義的元素。 元素 必需/可選 描述 -------------------------------------------------------------------------------- env-entry 可選的 env-entry 元素聲明用于應(yīng)用程序的環(huán)境條目。每個環(huán)境條目使用獨立的元素。 下表描述可以在 env-entry 元素中定義的元素。 元素 必需/可選 描述 可以設(shè)置為下列 Java 類型之一： java.lang.Boolean java.lang.String java.lang.Integer java.lang.Double java.lang.Float -------------------------------------------------------------------------------- ejb-ref 可選的 ejb-ref 元素定義對 EJB 資源的引用。通過在 WebLogic 特定的部署描述符文件 Weblogic.xml 中定義映射，將該引用映射至部署時的 EJB 實際位置。使用獨立的 下表描述可以在 ejb-ref 元素中定義的元素。 元素 必需/可選 描述 -------------------------------------------------------------------------------- ejb-local-ref ejb-local-ref 元素用于聲明對企業(yè) Bean 本地主目錄的引用。聲明包括： 可選的描述 用于在 Web 應(yīng)用程序代碼中引用企業(yè) Bean 的 EJB 引用名稱。所引用的企業(yè) Bean 的預(yù)期類型 所引用的企業(yè) Bean 的預(yù)期本地主目錄和本地接口 可選的 ejb-link 信息，用于指定所引用的企業(yè) Bean 下表描述可以在 ejb-local-ref 元素中定義的元素。 元素 必需/可選 描述 例如： ejb-link 元素中的名稱包括一個路徑名。該路徑名指定包含所引用 EJB 的 ejb-jar，且追加了目標 Bean 的 ejb-name 并通過 # 與路徑名隔開。 該路徑名相對于包含引用 EJB 的 Web 應(yīng)用程序的 WAR 文件。因此能夠唯一標識具有相同 ejb-name 的多個 EJB。 用于：ejb-local-ref 和 ejb-ref 元素。 示例： -------------------------------------------------------------------------------- Web-app Servlet 2.4 部署描述符的 XML Schema。WebLogic Server 完全支持 HTTP Servlet，如 Sun Microsystems 的 Servlet 2.4 specification 所定義。但是，version 特性必須設(shè)置為 2.4，才能執(zhí)行 2.4 行為。 下表描述可以在 Web-app 元素中定義的元素。 元素 必需/可選 描述
