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