無線&移動互聯(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)上查查，摘了下文：

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

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

　　接下來分段來說明它的各項設(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 元素中也有一個名為 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)定義）。請參閱 input-charset。

　　Weblogic.httpd.servlet.reloadCheckSecs 定義 WebLogic Server 檢查 servlet 是否發(fā)生修改的頻率，如果已修改，則重新加載。值為 -1 則永不重新加載，值為 0 則始終重新加載。默認(rèn)設(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)用程序的默認(rèn) servlet。不建議采用此方法，

　　對于此方法的支持僅為向后兼容。 無替換。而是使用 Web.xml 中的 servlet 和 servlet-mapping 元素定義默認(rèn) servlet。默認(rèn) 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 元素中定義的元素。

　　元素 必需/可選 描述

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

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

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

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

　　可選 篩選器的文字描述。

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

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

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

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

　　filter-mapping

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

　　元素 必需/可選 描述

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

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

　　示例模式：

　　/soda/grape/*

　　/foo/*

　　/contents

　　*.foo

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

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

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

　　listener

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

　　元素 必需/可選 描述

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

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

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

　　servlet

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

　　如果指定了 jsp-file 且存在 元素，則將在 WebLogic Server 啟動時預(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 文件相對于 Web 應(yīng)用程序根目錄的完整路徑。

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

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

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

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

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

　　

ref>　　ref> 可選 用于將 所定義的安全角色名鏈接到使用 Servlet 邏輯進行硬編碼的備用角色名。使用此附加提取層，可以在部署時配置 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 的初始化特性的名/值對。每個特性使用獨立的一組 init-param 標(biāo)記。

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

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

　　元素 必需/可選 描述

　　必需 定義此特性的名稱。

　　必需 為此特性定義一個 String 值。

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

　　security-role-ref

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

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

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

　　元素 必需/可選 描述

　　可選 角色的文字描述。

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

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

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

　　servlet-mapping

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

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

　　元素 必需/可選 描述

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

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

　　示例模式：

　　/soda/grape/*

　　/foo/*

　　/contents

　　*.foo

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

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

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

　　session-config

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

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

　　元素 必需/可選 描述

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

　　默認(rèn)值：-2

　　最大值：Integer.MAX_VALUE ?

　　特殊值：

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

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

　　有關(guān)詳細信息，請參閱 session-descriptor。

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

　　mime-mapping

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

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

　　元素 必需/可選 描述

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

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

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

　　welcome-file-list

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

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

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

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

　　元素 必需/可選 描述

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

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

　　error-page

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

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

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

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

　　注意： 定義 或 ，但兩者不能同時定義。

　　元素 必需/可選 描述

　　可選 有效的 HTTP 錯誤代碼，例如 404。

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

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

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

　　taglib

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

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

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

　　元素 必需/可選 描述

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

　　必需 描述相對于 Web.xml 文檔位置的 URI，標(biāo)識 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)的受管理對象的引用的聲明。它包括可選的描述、資源環(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)境條目名稱。名稱是相對于 java:comp/env 上下文的 JNDI 名稱，該名稱在 Web 應(yīng)用程序中必須唯一。

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

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

　　resource-ref

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

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

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

　　元素 必需/可選 描述

　　可選 文字描述。

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

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

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

　　如果設(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)用程序的組件。

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

　　

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

　　另請參閱 user-data-constraint

　　Web-resource-collection

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

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

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

　　元素 必需/可選 描述

　　<Web-RESOURCE-< p>

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

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

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

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

　　auth-constraint

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

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

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

　　元素 必需/可選 描述

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

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

　　user-data-constraint

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

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

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

　　元素 必需/可選 描述

　　可選 文字描述。

　　

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

　　當(dāng)使用 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)用程序中所定義的 約束的所有資源。一旦通過身份驗證，則可以授權(quán)用戶訪問具有訪問權(quán)限的其他資源。

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

　　元素 必需/可選 描述

　　可選 指定用于對用戶進行身份驗證的方法。可能的值：

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

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

　　CLIENT-CERT

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

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

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

　　

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

　　form-login-config

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

　　如果您在 FORM 中配置 ，請使用 元素。

　　.

　　元素 必需/可選 描述

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

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

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

　　security-role

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

　　元素 必需/可選 描述

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

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

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

　　env-entry

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

　　下表描述可以在 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 元素定義對 EJB 資源的引用。通過在 WebLogic 特定的部署描述符文件 Weblogic.xml 中定義映射，將該引用映射至部署時的 EJB 實際位置。使用獨立的 元素定義每個引用 EJB 名稱。

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

　　元素 必需/可選 描述

　　可選 引用的文字描述。

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

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

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

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

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

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

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

　　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 引用的名稱。EJB 引用是 Web 應(yīng)用程序環(huán)境中的一個條目，它相對于 java:comp/env 上下文。該名稱在 Web 應(yīng)用程序中必須唯一。建議該名稱使用前綴 ejb/。

　　例如：

　　ejb/Payroll

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

　　EntitySession

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

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

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

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

　　該路徑名相對于包含引用 EJB 的 Web 應(yīng)用程序的 WAR 文件。因此能夠唯一標(biāo)識具有相同 ejb-name 的多個 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 行為。