無線&移動(dòng)互聯(lián)網(wǎng)技術(shù)研發(fā)

http://blog.csdn.net/SDMRauquin/archive/2008/12/23/3590844.aspx

http://www.hackhome.com/InfoView/Article_120872.html

今天心血來潮，想系統(tǒng)復(fù)習(xí)一下web.xml，隨即在網(wǎng)上查查，摘了下文：

　　在每一個(gè)Web應(yīng)用程序路徑的Web-INF下和conf下存在一個(gè)Web.xml配置文件，

　　用來設(shè)定Web應(yīng)用程序的配置。在Web.xml中的設(shè)定非常多，

　　接下來分段來說明它的各項(xiàng)設(shè)定：

　　下列部分描述根元素 <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 元素中也有一個(gè)名為 icon 的元素，用于提供在 GUI 工具中表示 servlet 的圖標(biāo)。）

　　下表描述可以在 icon 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 用于在 GUI 工具中表示 Web 應(yīng)用程序的 .gif 或 .jpg 小圖像（16x16 像素）的位置。當(dāng)前 WebLogic Server 尚不使用此元素。

　　可選 用于在 GUI 工具中表示 Web 應(yīng)用程序的 .gif 或 .jpg 大圖像（32x32 像素）的位置。當(dāng)前 WebLogic Server 尚不使用此元素。

　　--------------------------------------------------------------------------------

　　display-name

　　可選的 display-name 元素指定 Web 應(yīng)用程序的顯示名稱（可以由 GUI 工具顯示的簡短名稱）。

　　元素 必需/可選 描述

　　可選 當(dāng)前 WebLogic Server 尚不使用此元素。

　　--------------------------------------------------------------------------------

　　description

　　可選的 description 元素提供關(guān)于 Web 應(yīng)用程序的描述性文本。

　　元素 必需/可選 描述

　　可選 當(dāng)前 WebLogic Server 尚不使用此元素。

　　--------------------------------------------------------------------------------

　　distributable

　　WebLogic Server 不使用 distributable 元素。

　　元素 必需/可選 描述

　　可選 當(dāng)前 WebLogic Server 尚不使用此元素。

　　--------------------------------------------------------------------------------

　　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)定義）。請(qǐng)參閱 input-charset。

　　Weblogic.httpd.servlet.reloadCheckSecs 定義 WebLogic Server 檢查 servlet 是否發(fā)生修改的頻率，如果已修改，則重新加載。值為 -1 則永不重新加載，值為 0 則始終重新加載。默認(rèn)設(shè)置為 1 秒。 Weblogic.xml 中的 servlet-reload-check-secs（在 container-descriptor 中定義）。請(qǐng)參閱 container-descriptor。

　　Weblogic.httpd.servlet.classpath 設(shè)置此值后，容器會(huì)將此路徑追加到 Web 應(yīng)用程序類路徑上。不建議采用此方法，對(duì)于此方法的支持僅為向后兼容。 無替換。使用其他方法，例如清單類路徑或 Web-INF/lib 或 Web-INF/classes 或虛擬目錄。

　　Weblogic.httpd.defaultServlet 設(shè)置 Web 應(yīng)用程序的默認(rèn) servlet。不建議采用此方法，

　　對(duì)于此方法的支持僅為向后兼容。 無替換。而是使用 Web.xml 中的 servlet 和 servlet-mapping 元素定義默認(rèn) servlet。默認(rèn) servlet 的 URL 模式應(yīng)該是“/”。請(qǐng)參閱 servlet-mapping。有關(guān) servlet 映射的其他示例，請(qǐng)參閱 Servlet 映射。

　　以下 context-param 參數(shù)仍有效。

　　元素 必需/可選 描述

　　Weblogic.httpd.

　　clientCertProxy optional 此特性指定 Web 應(yīng)用程序客戶端的證書由代理插件或 HttpClusterServlet所發(fā)送的特殊 WL-Proxy-Client-Cert 頭提供。

　　如果在代理服務(wù)器上執(zhí)行用戶身份驗(yàn)證，則此設(shè)置適用 – 設(shè)置 clientCertProxy 會(huì)使代理服務(wù)器在特殊的頭 WL-Proxy-Client-Cert中將證書傳遞給群集。

　　WL-Proxy-Client-Cert 頭可以由能夠訪問 WebLogic Server 的任意客戶端提供。WebLogic Server 從該頭中獲取證書信息，信任它來自安全來源（該插件）并使用該信息來對(duì)用戶進(jìn)行身份驗(yàn)證。

　　出于此原因，如果您設(shè)置 clientCertProxy，請(qǐng)使用連接篩選器確保 WebLogic Server 僅接受來自正在運(yùn)行該插件的計(jì)算機(jī)的連接。

　　除為單個(gè) Web 應(yīng)用程序設(shè)置此特性外，您還可以定義此特性：

　　在管理控制臺(tái)中的“服務(wù)器”-->“配置”-->“常規(guī)”頁面上，為服務(wù)器示例承載的所有 Web 應(yīng)用程序設(shè)置該特性

　　在“群集”-->“配置”-->“常規(guī)”頁面上，為群集中服務(wù)器實(shí)例所承載的所有 Web 應(yīng)用程序設(shè)置該特性

　　--------------------------------------------------------------------------------

　　filter

　　filter 元素定義篩選器類及其初始化特性。有關(guān)篩選器的詳細(xì)信息，請(qǐng)參閱配置篩選器。

　　下表描述可在 filter 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 指定用于在 GUI 工具中表示篩選器的大小圖像在 Web 應(yīng)用程序中的位置。包含小圖標(biāo)和大圖標(biāo)元素。

　　當(dāng)前 WebLogic Server 尚不使用此元素。

　　必需 定義篩選器的名稱，用于在部署描述符中的其他位置上引用篩選器定義。

　　可選 希望由 GUI 工具顯示的簡短名稱。

　　可選 篩選器的文字描述。

　　必需 篩選器的完全限定類名。

　　可選 包含名/值對(duì)并用作篩選器的初始化特性。

　　每個(gè)特性使用獨(dú)立的一組 標(biāo)記。

　　--------------------------------------------------------------------------------

　　filter-mapping

　　下表描述可在 filter-mapping元素中定義的元素。

　　元素 必需/可選 描述

　　必需 要將 URL 模式或 servlet 映射至的篩選器的名稱。該名稱對(duì)應(yīng)于使用 元素在 元素中分配的名稱。

　　必需 - 或由 映射 描述用于解析 URL 的模式。將 http://host:port+ ContextPath 之后的 URL 部分與 WebLogic Server 的 進(jìn)行比較。如果模式匹配，則將調(diào)用該元素中映射的篩選器。

　　示例模式：

　　/soda/grape/*

　　/foo/*

　　/contents

　　*.foo

　　URL 必須遵循 Servlet 2.3 規(guī)范中指定的規(guī)則。

　　必需 - 或由 映射 Servlet 的名稱，如果調(diào)用它，則會(huì)執(zhí)行該篩選器。

　　--------------------------------------------------------------------------------

　　listener

　　使用 listener 元素定義應(yīng)用程序監(jiān)聽器。

　　元素 必需/可選 描述

　　可選 響應(yīng) Web 應(yīng)用程序事件的類的名稱。

　　有關(guān)詳細(xì)信息，請(qǐng)參閱配置事件監(jiān)聽器類。

　　--------------------------------------------------------------------------------

　　servlet

　　servlet 元素中包含 servlet 的聲明性數(shù)據(jù)。

　　如果指定了 jsp-file 且存在 元素，則將在 WebLogic Server 啟動(dòng)時(shí)預(yù)編譯和加載該 JSP。

　　下表描述可在 servlet 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 用于在 GUI 工具中表示 servlet 的大小圖像在 Web 應(yīng)用程序中的位置。包含小圖標(biāo)和大圖標(biāo)元素。

　　當(dāng)前 WebLogic Server 尚不使用此元素。

　　必需 定義 servlet 的規(guī)范名稱，用于在部署描述符中的其他位置上引用 servlet 定義。

　　可選 希望由 GUI 工具顯示的簡短名稱。

　　可選 servlet 的文字描述。

　　必需（或使用

　　file>） servlet 的完全限定類名。

　　在 servlet 正文中僅使用 標(biāo)記或 標(biāo)記中的任意一種。

　　必需（或使用

　　class>） Web 應(yīng)用程序中的 JSP 文件相對(duì)于 Web 應(yīng)用程序根目錄的完整路徑。

　　在 servlet 正文中僅使用 標(biāo)記或 標(biāo)記中的任意一種。

　　可選 包含名/值對(duì)并用作 servlet 的初始化特性。

　　每個(gè)特性使用獨(dú)立的一組 標(biāo)記。

　　可選 當(dāng) WebLogic Server 啟動(dòng)時(shí)，WebLogic Server 將初始化此 servlet。此元素內(nèi)容可選，但必須是正整數(shù)，它指明 servlet 的加載順序。指定了低整數(shù)的 servlet 將于高整數(shù) servlet 之前加載。如果沒有指定任何值，或如果所指定的值不是正整數(shù)，則在應(yīng)用程序啟動(dòng)期間，WebLogic Server 可以以任意順序加載 servlet。

　　可選 指定將用于 Web 應(yīng)用程序執(zhí)行的 run-as 標(biāo)識(shí)。該元素包含可選描述和安全角色的名稱。

　　

ref>　　ref> 可選 用于將 所定義的安全角色名鏈接到使用 Servlet 邏輯進(jìn)行硬編碼的備用角色名。使用此附加提取層，可以在部署時(shí)配置 Servlet，且不必更改 Servlet 代碼。

　　icon

　　這是 Servlet 內(nèi)的元素。

　　icon 元素指定用于在 GUI 工具中表示 servlet 的大小圖像在 Web 應(yīng)用程序中的位置。

　　下表描述可以在 icon 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 指定用于在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小圖像（16x16 像素）在 Web 應(yīng)用程序內(nèi)的位置。

　　當(dāng)前 WebLogic Server 尚不使用此元素。

　　可選 指定用于在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小圖像（32x32 像素）在 Web 應(yīng)用程序內(nèi)的位置。

　　當(dāng)前 WebLogic Server 尚不使用此元素。

　　init-param

　　這是 Servlet 內(nèi)的元素。

　　可選的 init-param元素中包含用作 servlet 的初始化特性的名/值對(duì)。每個(gè)特性使用獨(dú)立的一組 init-param 標(biāo)記。

　　您可以使用 javax.servlet.ServletConfig.getInitParameter() 方法訪問這些特性。

　　下表描述可在 init-param元素中定義的元素。

　　元素 必需/可選 描述

　　必需 定義此特性的名稱。

　　必需 為此特性定義一個(gè) String 值。

　　可選 初始化特性的文字描述。

　　security-role-ref

　　這是 Servlet 內(nèi)的元素。

　　security-role-ref 元素將 定義的安全角色名鏈接到使用 Servlet 邏輯進(jìn)行硬編碼的備用角色名。使用此附加提取層，可以在部署時(shí)配置 Servlet，且不必更改 Servlet 代碼。

　　下表描述可在 security-role-ref元素中定義的元素。

　　元素 必需/可選 描述

　　可選 角色的文字描述。

　　必需 定義在 Servlet 代碼中使用的安全角色或委托人的名稱。

　　必需 定義稍后將在部署描述符中的 元素中定義的安全角色的名稱。

　　--------------------------------------------------------------------------------

　　servlet-mapping

　　servlet-mapping 元素定義 servlet 和 URL 模式之間的映射。

　　下表描述可在 servlet-mapping元素中定義的元素。

　　元素 必需/可選 描述

　　必需 要將 URL 模式映射至的 servlet 的名稱。該名稱對(duì)應(yīng)于您在 聲明標(biāo)記中為 servlet 分配的名稱。

　　必需 描述用于解析 URL 的模式。將 http://host:port+ WebAppName 之后的 URL 部分與 WebLogic Server 的 進(jìn)行比較。如果模式匹配，則將調(diào)用該元素中映射的 servlet。

　　示例模式：

　　/soda/grape/*

　　/foo/*

　　/contents

　　*.foo

　　URL 必須遵循 Servlet 2.3 規(guī)范中指定的規(guī)則。

　　有關(guān) Servlet 映射的其他示例，請(qǐng)參閱 Servlet 映射。

　　--------------------------------------------------------------------------------

　　session-config

　　session-config 元素為此 Web 應(yīng)用程序定義會(huì)話特性。

　　下表描述可在 session-config 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 會(huì)話過期分鐘數(shù)，該 Web 應(yīng)用程序中的會(huì)話將在此時(shí)間后過期。除非輸入此處列出的某個(gè)特殊值，否則此元素中設(shè)置的值將替代 WebLogic 特定部署描述符 Weblogic.xml 中的 元素的 TimeoutSecs 特性中設(shè)置的值。

　　默認(rèn)值：-2

　　最大值：Integer.MAX_VALUE ?

　　特殊值：

　　-2 表示使用 Weblogic.xml的 元素中的 TimeoutSecs 設(shè)置的值。

　　-1 表示會(huì)話永不超時(shí)。將忽略 Weblogic.xml 的 元素中設(shè)置的值。

　　有關(guān)詳細(xì)信息，請(qǐng)參閱 session-descriptor。

　　--------------------------------------------------------------------------------

　　mime-mapping

　　mime-mapping 元素定義擴(kuò)展名和 mime 類型之間的映射。

　　下表描述可在 mime-mapping元素中定義的元素。

　　元素 必需/可選 描述

　　必需 描述擴(kuò)展名的字符串，例如：txt。

　　必需 描述定義的 mime 類型的字符串，例如：text/plain。

　　--------------------------------------------------------------------------------

　　welcome-file-list

　　可選的 welcome-file-list 元素中包含 welcome-file 元素的有序列表。

　　當(dāng) URL 請(qǐng)求是一個(gè)目錄名時(shí)，WebLogic Server 將提供此元素中指定的第一個(gè)文件。如果找不到該文件，則服務(wù)器會(huì)嘗試列表中的下一個(gè)文件。

　　有關(guān)詳細(xì)信息，請(qǐng)參閱配置歡迎文件。

　　下表描述可在 welcome-file-list 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 用作默認(rèn)歡迎文件的文件名，例如 index.html

　　--------------------------------------------------------------------------------

　　error-page

　　可選的 error-page 元素指定錯(cuò)誤代碼或異常類型與 Web 應(yīng)用程序中資源路徑之間的映射。

　　WebLogic Server 響應(yīng) HTTP 請(qǐng)求的過程中發(fā)生錯(cuò)誤或由于 Java 異常而發(fā)生錯(cuò)誤時(shí)，WebLogic Server 會(huì)返回一個(gè) HTML 頁面，其中顯示 HTTP 錯(cuò)誤代碼或包含 Java 錯(cuò)誤信息的頁面。可以定義顯示自己的 HTML 頁面，而不顯示這些默認(rèn)錯(cuò)誤頁面，或響應(yīng) Java 異常。

　　有關(guān)詳細(xì)信息，請(qǐng)參閱自定義 HTTP 錯(cuò)誤響應(yīng)。

　　下表描述可以在 error-page 元素中定義的元素。

　　注意： 定義 或 ，但兩者不能同時(shí)定義。

　　元素 必需/可選 描述

　　可選 有效的 HTTP 錯(cuò)誤代碼，例如 404。

　　可選 Java 異常類型的完全限定類名，例如 java.lang.string

　　必需 為響應(yīng)錯(cuò)誤而顯示的資源的位置。例如，/myErrorPg.html。

　　--------------------------------------------------------------------------------

　　taglib

　　可選的 taglib 元素描述 JSP 標(biāo)記庫。

　　該元素將 JSP 標(biāo)記庫描述符（Tag Library Descriptor，簡稱 TLD）與 URI 模式關(guān)聯(lián)起來。盡管您可以在相對(duì)于 Web-INF 目錄的 JSP 中指定 TLD，但部署您的 Web 應(yīng)用程序時(shí)，您仍可以使用 標(biāo)記配置 TLD。每個(gè) TLD 使用獨(dú)立的元素。

　　下表描述可在 taglib元素中定義的元素。

　　元素 必需/可選 描述

　　必需 給出相對(duì)于 Web 應(yīng)用程序根目錄的標(biāo)記庫描述符的文件名。將標(biāo)記庫描述符文件存儲(chǔ)在 Web-INF 目錄下是一個(gè)好主意，這樣可以避免通過 HTTP 請(qǐng)求公開提供該文件。

　　必需 描述相對(duì)于 Web.xml 文檔位置的 URI，標(biāo)識(shí) Web 應(yīng)用程序中使用的標(biāo)記庫。

　　如果該 URI 匹配 JSP 頁面上 taglib 指令中使用的 URI 字符串，則使用此 taglib。

　　--------------------------------------------------------------------------------

　　resource-env-ref

　　resource-env-ref 元素包含 Web 應(yīng)用程序?qū)?Web 應(yīng)用程序環(huán)境中的資源所關(guān)聯(lián)的受管理對(duì)象的引用的聲明。它包括可選的描述、資源環(huán)境引用名，還指明了 Web 應(yīng)用程序代碼所預(yù)期的資源環(huán)境引用類型。

　　例如：

　　jms/StockQueue javax.jms.Queue下表描述可在 resource-env-ref 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 提供資源環(huán)境引用的描述。

　　必需 指定資源環(huán)境引用的名稱；其值為 Web 應(yīng)用程序代碼中使用的環(huán)境條目名稱。名稱是相對(duì)于 java:comp/env 上下文的 JNDI 名稱，該名稱在 Web 應(yīng)用程序中必須唯一。

　　必需 指定資源環(huán)境引用的類型。它是 Java 語言類或接口的完全限定名稱。

　　--------------------------------------------------------------------------------

　　resource-ref

　　可選的 resource-ref 元素定義外部資源的引用查找名。這使得 servlet 代碼能夠通過“虛擬”名稱查找資源，該虛擬名稱將映射至部署時(shí)的實(shí)際位置。

　　使用獨(dú)立的 元素定義每個(gè)外部資源名稱。在 WebLogic 特定部署描述符 Weblogic.xml 中，外部資源名稱映射至部署時(shí)的資源實(shí)際位置名稱。

　　下表描述可在 resource-ref元素中定義的元素。

　　元素 必需/可選 描述

　　可選 文字描述。

　　必需 JNDI 樹中使用的資源的名稱。Web 應(yīng)用程序中的 Servlet 使用此名稱查找資源引用。

　　必需 與引用名稱相對(duì)應(yīng)的資源的 Java 類型。使用 Java 類型的完整包名。

　　必需 用于控制資源安全登錄。

　　如果設(shè)置為 APPLICATION，則表明應(yīng)用程序組件代碼將以編程方式執(zhí)行資源登錄。如果設(shè)置為 CONTAINER，則 WebLogic Server 將使用隨 login-config 元素建立的安全上下文。請(qǐng)參閱 login-config。

　　可選 指定是否可以共享通過給定資源管理器連接工廠引用獲取的連接。

　　有效值：

　　Shareable（可共享）

　　Unshareable（不可共享）

　　--------------------------------------------------------------------------------

　　security-constraint

　　security-constraint 元素定義對(duì) <Web-RESOURCE-COLLECTION>元素所定義的資源集合的訪問權(quán)限。

　　有關(guān)在 Web 應(yīng)用程序中配置安全的詳細(xì)說明和示例，請(qǐng)參閱“確保 WebLogic 資源安全”。另外，有關(guān) WebLogic 安全的詳細(xì)信息，請(qǐng)參閱WebLogic 安全性編程。

　　下表描述可在 security-constraint 元素中定義的元素。

　　元素 必需/可選 描述

　　<Web-RESOURCE-< p>

collection>　　collection> 必需 定義應(yīng)用此安全約束的 Web 應(yīng)用程序的組件。

　　可選 定義哪些組或委托人可以訪問此安全約束內(nèi)定義的 Web 資源集合。另請(qǐng)參閱 auth-constraint。

　　

constraint>　　constraint> 可選 定義客戶端如何與服務(wù)器進(jìn)行通信。

　　另請(qǐng)參閱 user-data-constraint

　　Web-resource-collection

　　每個(gè) 元素必須具有一個(gè)或多個(gè) <Web-RESOURCE-COLLECTION>元素。它們定義應(yīng)用此安全約束的 Web 應(yīng)用程序的區(qū)域。

　　這是 security-constraint 內(nèi)的元素。

　　下表描述可在 Web-resource-collection 元素中定義的元素。

　　元素 必需/可選 描述

　　<Web-RESOURCE-< p>

name>　　name> 必需 此 Web 資源集合的名稱。

　　可選 此安全約束的文字描述。

　　可選 使用一個(gè)或多個(gè) 元素聲明此安全約束將應(yīng)用至的 URL 模式。如果您不使用其中至少一個(gè)元素，則 WebLogic Server 將忽略 <Web-RESOURCE-COLLECTION>。

　　可選 使用一個(gè)或多個(gè) 元素聲明受身份驗(yàn)證約束的 HTTP 方法（通常是 GET 或 POST）。如果忽略 元素，則默認(rèn)行為是向所有 HTTP 方法應(yīng)用安全約束。

　　auth-constraint

　　這是 security-constraint 內(nèi)的元素。

　　可選的 auth-constraint 元素定義哪些組或委托人有權(quán)訪問在此安全約束中定義的 Web 資源集合。

　　下表描述可以在 auth-constraint 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 此安全約束的文字描述。

　　可選 定義哪些安全角色可以訪問在此安全約束中定義的資源。安全角色名映射至使用 security-role-ref 的委托人。請(qǐng)參閱 security-role-ref。

　　user-data-constraint

　　這是 security-constraint 內(nèi)的元素。

　　user-data-constraint元素定義客戶端如何與服務(wù)器進(jìn)行通信。

　　下表描述可在 user-data-constraint元素中定義的元素。

　　元素 必需/可選 描述

　　可選 文字描述。

　　

guarantee>　　guarantee> 必需 指定客戶端和服務(wù)器之間的通信。

　　當(dāng)使用 INTEGRAL 或 CONFIDENTIAL 傳輸保證對(duì)用戶進(jìn)行身份驗(yàn)證時(shí)，WebLogic Server 會(huì)建立安全套接口層 (SSL) 連接。

　　值范圍：

　　NONE- 應(yīng)用程序不需要任何傳輸保證。

　　INTEGRAL- 應(yīng)用程序要求數(shù)據(jù)在客戶端和服務(wù)器之間傳輸?shù)倪^程中不會(huì)被更改。

　　CONFIDENTIAL- 應(yīng)用程序要求傳輸數(shù)據(jù)以防止其他實(shí)體觀察到傳輸?shù)膬?nèi)容。

　　--------------------------------------------------------------------------------

　　login-config

　　使用可選的 login-config 元素配置如何對(duì)用戶進(jìn)行身份驗(yàn)證；應(yīng)用于此應(yīng)用程序的領(lǐng)域名稱；表單登錄機(jī)制所需要的特性。

　　如果使用此元素，則用戶必須經(jīng)過身份驗(yàn)證才能訪問受 Web 應(yīng)用程序中所定義的 約束的所有資源。一旦通過身份驗(yàn)證，則可以授權(quán)用戶訪問具有訪問權(quán)限的其他資源。

　　下表描述可在 login-config元素中定義的元素。

　　元素 必需/可選 描述

　　可選 指定用于對(duì)用戶進(jìn)行身份驗(yàn)證的方法。可能的值：

　　BASIC - 使用瀏覽器身份驗(yàn)證。（這是默認(rèn)值。）

　　FORM - 使用用戶編寫的 HTML 表單。

　　CLIENT-CERT

　　注意： 您可以通過逗號(hào)分隔列表定義多個(gè)身份驗(yàn)證方法，以便提供應(yīng)變機(jī)制。將按照在 auth-method 列表中定義值的順序嘗試進(jìn)行身份驗(yàn)證。請(qǐng)參閱“WebLogic 安全性編程”中的為身份驗(yàn)證方法提供應(yīng)變機(jī)制。

　　可選 對(duì)用戶憑據(jù)進(jìn)行身份驗(yàn)證時(shí)所引用的領(lǐng)域名稱。如果忽略，則默認(rèn)使用管理控制臺(tái)中的“Web 應(yīng)用程序”“配置”“其他”選項(xiàng)卡上的“身份驗(yàn)證領(lǐng)域名”字段中定義的領(lǐng)域。

　　注意： 元素不引用 WebLogic Server 內(nèi)的系統(tǒng)安全領(lǐng)域。該元素定義 HTTP 基本身份驗(yàn)證中使用的領(lǐng)域名稱。系統(tǒng)安全領(lǐng)域是在服務(wù)器上執(zhí)行特定操作時(shí)將檢查的安全信息的集合。servlet 安全領(lǐng)域是訪問頁面和使用基本身份驗(yàn)證時(shí)要檢查的另外一組安全信息的集合。

　　

config>　　config> 可選 如果您在 FORM 中配置 ，請(qǐng)使用此元素。請(qǐng)參閱 form-login-config。

　　form-login-config

　　這是 login-config 內(nèi)的元素。

　　如果您在 FORM 中配置 ，請(qǐng)使用 元素。

　　.

　　元素 必需/可選 描述

　　必需 相對(duì)于文檔根目錄的 Web 資源 URI，用于對(duì)用戶進(jìn)行身份驗(yàn)證。這可以是 HTML 頁面、JSP 或 HTTP servlet，且必須返回一個(gè)包含符合特定命名約定的、基于 FORM 的身份驗(yàn)證的 HTML 頁面。

　　必需 相對(duì)于文檔根目錄的 Web 資源 URI，會(huì)將它發(fā)送給用戶以響應(yīng)失敗的身份驗(yàn)證登錄。

　　--------------------------------------------------------------------------------

　　security-role

　　下表描述可在 security-role元素中定義的元素。

　　元素 必需/可選 描述

　　可選 此安全角色的文字描述。

　　必需 角色名。此處使用的名稱在 WebLogic 特定的部署描述符 Weblogic.xml 中必須有對(duì)應(yīng)的條目，該部署描述符將角色映射到安全領(lǐng)域中的委托人。有關(guān)詳細(xì)信息，請(qǐng)參閱 security-role-assignment。

　　--------------------------------------------------------------------------------

　　env-entry

　　可選的 env-entry 元素聲明用于應(yīng)用程序的環(huán)境條目。每個(gè)環(huán)境條目使用獨(dú)立的元素。

　　下表描述可以在 env-entry 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 文字描述。

　　必需 環(huán)境條目的名稱。

　　必需 環(huán)境條目的值。

　　必需 環(huán)境條目的類型。

　　可以設(shè)置為下列 Java 類型之一：

　　java.lang.Boolean

　　java.lang.String

　　java.lang.Integer

　　java.lang.Double

　　java.lang.Float

　　--------------------------------------------------------------------------------

　　ejb-ref

　　可選的 ejb-ref 元素定義對(duì) EJB 資源的引用。通過在 WebLogic 特定的部署描述符文件 Weblogic.xml 中定義映射，將該引用映射至部署時(shí)的 EJB 實(shí)際位置。使用獨(dú)立的 元素定義每個(gè)引用 EJB 名稱。

　　下表描述可以在 ejb-ref 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 引用的文字描述。

　　必需 Web 應(yīng)用程序中使用的 EJB 的名稱。在 WebLogic 特定的部署描述符 Weblogic.xml 中，該名稱映射至 JNDI 樹。有關(guān)詳細(xì)信息，請(qǐng)參閱 ejb-reference-description。

　　必需 所引用的 EJB 的預(yù)期 Java 類類型。

　　必需 EJB Home 接口的完全限定類名。

　　必需 EJB 遠(yuǎn)程接口的完全限定類名。

　　可選 在包含的 J2EE 應(yīng)用程序包中的 EJB 的 。

　　可選 安全角色，其安全上下文將應(yīng)用于所引用的 EJB。必須是使用 元素定義的安全角色。

　　--------------------------------------------------------------------------------

　　ejb-local-ref

　　ejb-local-ref 元素用于聲明對(duì)企業(yè) Bean 本地主目錄的引用。聲明包括：

　　可選的描述

　　用于在 Web 應(yīng)用程序代碼中引用企業(yè) Bean 的 EJB 引用名稱。所引用的企業(yè) Bean 的預(yù)期類型

　　所引用的企業(yè) Bean 的預(yù)期本地主目錄和本地接口

　　可選的 ejb-link 信息，用于指定所引用的企業(yè) Bean

　　下表描述可以在 ejb-local-ref 元素中定義的元素。

　　元素 必需/可選 描述

　　可選 引用的文字描述。

　　必需 包含 EJB 引用的名稱。EJB 引用是 Web 應(yīng)用程序環(huán)境中的一個(gè)條目，它相對(duì)于 java:comp/env 上下文。該名稱在 Web 應(yīng)用程序中必須唯一。建議該名稱使用前綴 ejb/。

　　例如：

　　ejb/Payroll

　　必需 ejb-ref-type 元素包含所引用企業(yè) Bean 的預(yù)期類型。ejb-ref-type 元素必須是以下某項(xiàng)：

　　EntitySession

　　必需 包含企業(yè) Bean 的本地 Home 接口的完全限定名稱。

　　必需 包含企業(yè) Bean 的本地接口的完全限定名稱。

　　可選 ejb-link 元素用于 ejb-ref 或 ejb-local-ref 元素中以指定 EJB 上鏈接一個(gè) EJB 引用。

　　ejb-link 元素中的名稱包括一個(gè)路徑名。該路徑名指定包含所引用 EJB 的 ejb-jar，且追加了目標(biāo) Bean 的 ejb-name 并通過 # 與路徑名隔開。

　　該路徑名相對(duì)于包含引用 EJB 的 Web 應(yīng)用程序的 WAR 文件。因此能夠唯一標(biāo)識(shí)具有相同 ejb-name 的多個(gè) EJB。

　　用于：ejb-local-ref 和 ejb-ref 元素。

　　示例：

　　EmployeeRecord

　　../products/product.jar#ProductEJB

　　--------------------------------------------------------------------------------

　　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 元素中定義的元素。

　　元素 必需/可選 描述

　　必需 所有 Servlet 部署描述符必須指明 2.4 版本的 Schema，以便執(zhí)行 Servlet 2.4 行為。