web.xml 部署描述符元素

在每個Web應用程序路徑的WEB-INF/下和conf/下存在一個Web.xml配置文件，
用來設定Web應用程序的配置。在Web.xml中的設定很是多，
接下來分段來講明它的各項設定：
<?xml version=1.0 encoding="ISO-8859-1"?>
<!DOCTYPE Web-app
     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公司所制定的，能夠在下列的網址得到詳細的信息：
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 元素中也有一個名爲 icon 的元素，用於提供在 GUI 工具中表示 servlet 的圖標。） 

下表描述能夠在 icon 元素中定義的元素。

元素 必需/可選 描述 
<small-icon> 可選 用於在 GUI 工具中表示 Web 應用程序的 .gif 或 .jpg 小圖像（16x16 像素）的位置。當前 WebLogic Server 尚不使用此元素。 
<large-icon> 可選 用於在 GUI 工具中表示 Web 應用程序的 .gif 或 .jpg 大圖像（32x32 像素）的位置。當前 WebLogic Server 尚不使用此元素。 


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

display-name 
可選的 display-name 元素指定 Web 應用程序的顯示名稱（能夠由 GUI 工具顯示的簡短名稱）。 


元素 必需/可選 描述 
<display-name> 可選 當前 WebLogic Server 尚不使用此元素。 


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

description 
可選的 description 元素提供關於 Web 應用程序的描述性文本。 


元素 必需/可選 描述 
<description> 可選 當前 WebLogic Server 尚不使用此元素。 


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

distributable 
WebLogic Server 不使用 distributable 元素。

元素 必需/可選 描述 
<distributable> 可選 當前 WebLogic Server 尚不使用此元素。 


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

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 是否發生修改的頻率，若是已修改，則從新加載。值爲 -1 則永不從新加載，值爲 0 則始終從新加載。默認設置爲 1 秒。 weblogic.xml 中的 servlet-reload-check-secs（在 Container-descriptor 中定義）。請參閱 container-descriptor。 
weblogic.httpd.servlet.classpath 設置此值後，容器會將此路徑追加到 Web 應用程序類路徑上。不建議採用此方法，對於此方法的支持僅爲向後兼容。 無替換。使用其餘方法，例如清單類路徑或 WEB-INF/lib 或 WEB-INF/classes 或虛擬目錄。 
weblogic.httpd.defaultServlet 設置 Web 應用程序的默認 servlet。不建議採用此方法，
對於此方法的支持僅爲向後兼容。 無替換。而是使用 web.xml 中的 servlet 和 servlet-mapping 元素定義默認 servlet。默認 servlet 的 URL 模式應該是「/」。請參閱 servlet-mapping。有關 servlet 映射的其餘示例，請參閱 Servlet 映射。 


如下 context-param 參數仍有效。 


元素 必需/可選 描述 
weblogic.httpd.
clientCertProxy optional 此特性指定 Web 應用程序客戶端的證書由代理插件或 HttpClusterServlet所發送的特殊 WL-Proxy-Client-Cert 頭提供。 
若是在代理服務器上執行用戶身份驗證，則此設置適用 – 設置 clientCertProxy 會使代理服務器在特殊的頭 WL-Proxy-Client-Cert中將證書傳遞給羣集。 
WL-Proxy-Client-Cert 頭能夠由可以訪問 WebLogic Server 的任意客戶端提供。WebLogic Server 從該頭中獲取證書信息，信任它來自安全來源（該插件）並使用該信息來對用戶進行身份驗證。 
出於此緣由，若是您設置 clientCertProxy，請使用鏈接篩選器確保 WebLogic Server 僅接受來自正在運行該插件的計算機的鏈接。 
除爲單個 Web 應用程序設置此特性外，您還能夠定義此特性： 
在管理控制檯中的「服務器」-->「配置」-->「常規」頁面上，爲服務器示例承載的全部 Web 應用程序設置該特性 
在「羣集」-->「配置」-->「常規」頁面上，爲羣集中服務器實例所承載的全部 Web 應用程序設置該特性 



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

filter 
filter 元素定義篩選器類及其初始化特性。有關篩選器的詳細信息，請參閱配置篩選器。 

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

元素 必需/可選 描述 
<icon> 可選 指定用於在 GUI 工具中表示篩選器的大小圖像在 Web 應用程序中的位置。包含小圖標和大圖標元素。
當前 WebLogic Server 尚不使用此元素。 
<filter-name> 必需 定義篩選器的名稱，用於在部署描述符中的其餘位置上引用篩選器定義。 
<display-name> 可選 但願由 GUI 工具顯示的簡短名稱。 
<description> 可選 篩選器的文字描述。 
<filter-class> 必需 篩選器的徹底限定類名。 
<init-param> 可選 包含名/值對並用做篩選器的初始化特性。 
每一個特性使用獨立的一組 <init-param> 標記。 


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

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

元素 必需/可選 描述 
<filter-name> 必需 要將 URL 模式或 servlet 映射至的篩選器的名稱。該名稱對應於使用 <filter-name> 元素在 <filter> 元素中分配的名稱。 
<url-pattern> 必需 - 或由 <servlet>映射 描述用於解析 URL 的模式。將 http://host:port + ContextPath 以後的 URL 部分與 WebLogic Server 的 <url-pattern> 進行比較。若是模式匹配，則將調用該元素中映射的篩選器。 
示例模式： 
/soda/grape/*
/foo/* 
/contents
*.foo 
URL 必須遵循 Servlet 2.3 規範中指定的規則。 
<servlet> 必需 - 或由 <url-pattern>映射 Servlet 的名稱，若是調用它，則會執行該篩選器。 


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

listener 
使用 listener 元素定義應用程序監聽器。

元素 必需/可選 描述 
<listener-class> 可選 響應 Web 應用程序事件的類的名稱。 


有關詳細信息，請參閱配置事件監聽器類。 

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

servlet 
servlet 元素中包含 servlet 的聲明性數據。 

若是指定了 jsp-file 且存在 <load-on-startup> 元素，則將在 WebLogic Server 啓動時預編譯和加載該 JSP。 

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

元素 必需/可選 描述 
<icon> 可選 用於在 GUI 工具中表示 servlet 的大小圖像在 Web 應用程序中的位置。包含小圖標和大圖標元素。 
當前 WebLogic Server 尚不使用此元素。 
<servlet-name> 必需 定義 servlet 的規範名稱，用於在部署描述符中的其餘位置上引用 servlet 定義。 
<display-name> 可選 但願由 GUI 工具顯示的簡短名稱。 
<description> 可選 servlet 的文字描述。 
<servlet-class> 必需（或使用 <jsp-
file>） servlet 的徹底限定類名。 
在 servlet 正文中僅使用 <servlet-class> 標記或 <jsp-file> 標記中的任意一種。 
<jsp-file> 必需（或使用 <servlet-
class>） Web 應用程序中的 JSP 文件相對於 Web 應用程序根目錄的完整路徑。 
在 servlet 正文中僅使用 <servlet-class> 標記或 <jsp-file> 標記中的任意一種。 
<init-param> 可選 包含名/值對並用做 servlet 的初始化特性。 
每一個特性使用獨立的一組 <init-param> 標記。 
<load-on-startup> 可選 當 WebLogic Server 啓動時，WebLogic Server 將初始化此 servlet。此元素內容可選，但必須是正整數，它指明 servlet 的加載順序。指定了低整數的 servlet 將於高整數 servlet 以前加載。若是沒有指定任何值，或若是所指定的值不是正整數，則在應用程序啓動期間，WebLogic Server 能夠以任意順序加載 servlet。
<run-as> 可選 指定將用於 Web 應用程序執行的 run-as 標識。該元素包含可選描述和安全角色的名稱。 
<security-role-
ref> 可選 用於將 <security-role>所定義的安全角色名連接到使用 Servlet 邏輯進行硬編碼的備用角色名。使用此附加提取層，能夠在部署時配置 Servlet，且沒必要更改 Servlet 代碼。 


icon 
這是 Servlet 內的元素。 

icon 元素指定用於在 GUI 工具中表示 servlet 的大小圖像在 Web 應用程序中的位置。 

下表描述能夠在 icon 元素中定義的元素。

元素 必需/可選 描述 
<small-icon> 可選 指定用於在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小圖像（16x16 像素）在 Web 應用程序內的位置。 
當前 WebLogic Server 尚不使用此元素。 
<large-icon> 可選 指定用於在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小圖像（32x32 像素）在 Web 應用程序內的位置。 
當前 WebLogic Server 尚不使用此元素。 


init-param 
這是 Servlet 內的元素。 

可選的 init-param元素中包含用做 servlet 的初始化特性的名/值對。每一個特性使用獨立的一組 init-param 標記。 

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

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

元素 必需/可選 描述 
<param-name> 必需 定義此特性的名稱。 
<param-value> 必需 爲此特性定義一個 String 值。 
<description> 可選 初始化特性的文字描述。 


security-role-ref 
這是 Servlet 內的元素。 

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

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

元素 必需/可選 描述 
<description> 可選 角色的文字描述。 
<role-name> 必需 定義在 Servlet 代碼中使用的安全角色或委託人的名稱。 
<role-link> 必需 定義稍後將在部署描述符中的 <security-role> 元素中定義的安全角色的名稱。 


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

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

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

元素 必需/可選 描述 
<servlet-name> 必需 要將 URL 模式映射至的 servlet 的名稱。該名稱對應於您在 <servlet> 聲明標記中爲 servlet 分配的名稱。 
<url-pattern> 必需 描述用於解析 URL 的模式。將 http://host:port + WebAppName 以後的 URL 部分與 WebLogic Server 的 <url-pattern> 進行比較。若是模式匹配，則將調用該元素中映射的 servlet。 
示例模式： 
/soda/grape/*
/foo/* 
/contents
*.foo 
URL 必須遵循 Servlet 2.3 規範中指定的規則。 
有關 Servlet 映射的其餘示例，請參閱 Servlet 映射。 


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

session-config 
session-config 元素爲此 Web 應用程序定義會話特性。 

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

元素 必需/可選 描述 
<session-timeout> 可選 會話過時分鐘數，該 Web 應用程序中的會話將在此時間後過時。除非輸入此處列出的某個特殊值，不然此元素中設置的值將替代 WebLogic 特定部署描述符 weblogic.xml 中的 <session-descriptor> 元素的 TimeoutSecs 特性中設置的值。 
默認值：-2 
最大值：Integer.MAX_VALUE  
特殊值： 
-2 表示使用 weblogic.xml的 <session-descriptor> 元素中的 TimeoutSecs 設置的值。 
-1 表示會話永不超時。將忽略 weblogic.xml 的 <session-descriptor> 元素中設置的值。 
有關詳細信息，請參閱 session-descriptor。 


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

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

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

元素 必需/可選 描述 
<extension> 必需 描述擴展名的字符串，例如：txt。 
<mime-type> 必需 描述定義的 mime 類型的字符串，例如：text/plain。 


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

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

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

有關詳細信息，請參閱配置歡迎文件。 

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

元素 必需/可選 描述 
<welcome-file> 可選 用做默認歡迎文件的文件名，例如 index.html 


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

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

WebLogic Server 響應 HTTP 請求的過程當中發生錯誤或因爲 Java 異常而發生錯誤時，WebLogic Server 會返回一個 HTML 頁面，其中顯示 HTTP 錯誤代碼或包含 Java 錯誤信息的頁面。能夠定義顯示本身的 HTML 頁面，而不顯示這些默認錯誤頁面，或響應 Java 異常。 

有關詳細信息，請參閱自定義 HTTP 錯誤響應。 

下表描述能夠在 error-page 元素中定義的元素。 

注意： 定義 <error-code> 或 <exception-type>，但二者不能同時定義。 
元素 必需/可選 描述 
<error-code> 可選 有效的 HTTP 錯誤代碼，例如 404。 
<exception-type> 可選 Java 異常類型的徹底限定類名，例如 java.lang.string 
<location> 必需 爲響應錯誤而顯示的資源的位置。例如，/myErrorPg.html。 


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

taglib 
可選的 taglib 元素描述 JSP 標記庫。 

該元素將 JSP 標記庫描述符（Tag Library Descriptor，簡稱 TLD）與 URI 模式關聯起來。儘管您能夠在相對於 WEB-INF 目錄的 JSP 中指定 TLD，但部署您的 Web 應用程序時，您仍可使用 <taglib> 標記配置 TLD。每一個 TLD 使用獨立的元素。 

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

元素 必需/可選 描述 
<taglib-location> 必需 給出相對於 Web 應用程序根目錄的標記庫描述符的文件名。將標記庫描述符文件存儲在 WEB-INF 目錄下是一個好主意，這樣能夠避免經過 HTTP 請求公開提供該文件。 
<taglib-uri> 必需 描述相對於 web.xml 文檔位置的 URI，標識 Web 應用程序中使用的標記庫。 
若是該 URI 匹配 JSP 頁面上 taglib 指令中使用的 URI 字符串，則使用此 taglib。 


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

resource-env-ref 
resource-env-ref 元素包含 Web 應用程序對 Web 應用程序環境中的資源所關聯的受管理對象的引用的聲明。它包括可選的描述、資源環境引用名，還指明瞭 Web 應用程序代碼所預期的資源環境引用類型。 

例如： 

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

元素 必需/可選 描述 
<description> 可選 提供資源環境引用的描述。 
<resource-env-ref-name> 必需 指定資源環境引用的名稱；其值爲 Web 應用程序代碼中使用的環境條目名稱。名稱是相對於 java:comp/env 上下文的 JNDI 名稱，該名稱在 Web 應用程序中必須惟一。 
<resource-env-ref-type> 必需 指定資源環境引用的類型。它是 Java 語言類或接口的徹底限定名稱。 


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

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

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

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

元素 必需/可選 描述 
<description> 可選 文字描述。 
<res-ref-name> 必需 JNDI 樹中使用的資源的名稱。Web 應用程序中的 Servlet 使用此名稱查找資源引用。 
<res-type> 必需 與引用名稱相對應的資源的 Java 類型。使用 Java 類型的完整包名。 
<res-auth> 必需 用於控制資源安全登陸。 
若是設置爲 APPLICATION，則代表應用程序組件代碼將以編程方式執行資源登陸。若是設置爲 CONTAINER，則 WebLogic Server 將使用隨 login-config 元素創建的安全上下文。請參閱 login-config。 
<res-sharing-scope> 可選 指定是否能夠共享經過給定資源管理器鏈接工廠引用獲取的鏈接。 
有效值： 
Shareable（可共享） 
Unshareable（不可共享） 


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

security-constraint 
security-constraint 元素定義對 <web-resource-collection> 元素所定義的資源集合的訪問權限。 

有關在 Web 應用程序中配置安全的詳細說明和示例，請參閱「確保 WebLogic 資源安全」。另外，有關 WebLogic 安全的詳細信息，請參閱WebLogic 安全性編程。 

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

元素 必需/可選 描述 
<web-resource-
collection> 必需 定義應用此安全約束的 Web 應用程序的組件。 
<auth-constraint> 可選 定義哪些組或委託人能夠訪問此安全約束內定義的 Web 資源集合。另請參閱 auth-constraint。 
<user-data-
constraint> 可選 定義客戶端如何與服務器進行通訊。 
另請參閱 user-data-constraint 


web-resource-collection 
每一個 <security-constraint> 元素必須具備一個或多個 <web-resource-collection> 元素。它們定義應用此安全約束的 Web 應用程序的區域。 

這是 security-constraint 內的元素。 

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

元素 必需/可選 描述 
<web-resource-
name> 必需 此 Web 資源集合的名稱。 
<description> 可選 此安全約束的文字描述。 
<url-pattern> 可選 使用一個或多個 <url-pattern> 元素聲明此安全約束將應用至的 URL 模式。若是您不使用其中至少一個元素，則 WebLogic Server 將忽略 <web-resource-collection>。 
<http-method> 可選 使用一個或多個 <http-method> 元素聲明受身份驗證約束的 HTTP 方法（一般是 GET 或 POST）。若是忽略 <http-method> 元素，則默認行爲是向全部 HTTP 方法應用安全約束。 


auth-constraint 
這是 security-constraint 內的元素。 

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

下表描述能夠在 auth-constraint 元素中定義的元素。

元素 必需/可選 描述 
<description> 可選 此安全約束的文字描述。 
<role-name> 可選 定義哪些安全角色能夠訪問在此安全約束中定義的資源。安全角色名映射至使用 security-role-ref 的委託人。請參閱 security-role-ref。 


user-data-constraint 
這是 security-constraint 內的元素。 

user-data-constraint元素定義客戶端如何與服務器進行通訊。 

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

元素 必需/可選 描述 
<description> 可選 文字描述。 
<transport-
guarantee> 必需 指定客戶端和服務器之間的通訊。 
當使用 INTEGRAL 或 CONFIDENTIAL 傳輸保證對用戶進行身份驗證時，WebLogic Server 會創建安全套接口層 (SSL) 鏈接。 
值範圍： 
NONE- 應用程序不須要任何傳輸保證。 
INTEGRAL- 應用程序要求數據在客戶端和服務器之間傳輸的過程當中不會被更改。 
CONFIDENTIAL- 應用程序要求傳輸數據以防止其餘實體觀察到傳輸的內容。 


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

login-config 
使用可選的 login-config 元素配置如何對用戶進行身份驗證；應用於此應用程序的領域名稱；表單登陸機制所須要的特性。 

若是使用此元素，則用戶必須通過身份驗證才能訪問受 Web 應用程序中所定義的 <security-constraint> 約束的全部資源。一旦經過身份驗證，則能夠受權用戶訪問具備訪問權限的其餘資源。 

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

元素 必需/可選 描述 
<auth-method> 可選 指定用於對用戶進行身份驗證的方法。可能的值： 
BASIC - 使用瀏覽器身份驗證。（這是默認值。）
FORM - 使用用戶編寫的 HTML 表單。
CLIENT-CERT 
注意： 您能夠經過逗號分隔列表定義多個身份驗證方法，以便提供應變機制。將按照在 auth-method 列表中定義值的順序嘗試進行身份驗證。請參閱「WebLogic 安全性編程」中的爲身份驗證方法提供應變機制。 


<realm-name> 可選 對用戶憑據進行身份驗證時所引用的領域名稱。若是忽略，則默認使用管理控制檯中的「Web 應用程序」「配置」「其餘」選項卡上的「身份驗證領域名」字段中定義的領域。 
注意： <realm-name> 元素不引用 WebLogic Server 內的系統安全領域。該元素定義 HTTP 基自己份驗證中使用的領域名稱。系統安全領域是在服務器上執行特定操做時將檢查的安全信息的集合。servlet 安全領域是訪問頁面和使用基自己份驗證時要檢查的另一組安全信息的集合。 


<form-login-
config> 可選 若是您在 FORM 中配置 <auth-method>，請使用此元素。請參閱 form-login-config。 


form-login-config 
這是 login-config 內的元素。 

若是您在 FORM 中配置 <auth-method>，請使用 <form-login-config> 元素。 

.

元素 必需/可選 描述 
<form-login-page> 必需 相對於文檔根目錄的 Web 資源 URI，用於對用戶進行身份驗證。這能夠是 HTML 頁面、JSP 或 HTTP servlet，且必須返回一個包含符合特定命名約定的、基於 FORM 的身份驗證的 HTML 頁面。 
<form-error-page> 必需 相對於文檔根目錄的 Web 資源 URI，會將它發送給用戶以響應失敗的身份驗證登陸。 


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

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

元素 必需/可選 描述 
<description> 可選 此安全角色的文字描述。 
<role-name> 必需 角色名。此處使用的名稱在 WebLogic 特定的部署描述符 weblogic.xml 中必須有對應的條目，該部署描述符將角色映射到安全領域中的委託人。有關詳細信息，請參閱 security-role-assignment。 

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

env-entry 
可選的 env-entry 元素聲明用於應用程序的環境條目。每一個環境條目使用獨立的元素。 

下表描述能夠在 env-entry 元素中定義的元素。

元素 必需/可選 描述 
<description> 可選 文字描述。 
<env-entry-name> 必需 環境條目的名稱。 
<env-entry-value> 必需 環境條目的值。 
<env-entry-type> 必需 環境條目的類型。 
能夠設置爲下列 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 名稱。 

下表描述能夠在 ejb-ref 元素中定義的元素。

元素 必需/可選 描述 
<description> 可選 引用的文字描述。 
<ejb-ref-name> 必需 Web 應用程序中使用的 EJB 的名稱。在 WebLogic 特定的部署描述符 weblogic.xml 中，該名稱映射至 JNDI 樹。有關詳細信息，請參閱 ejb-reference-description。 
<ejb-ref-type> 必需 所引用的 EJB 的預期 Java 類類型。 
<home> 必需 EJB Home 接口的徹底限定類名。 
<remote> 必需 EJB 遠程接口的徹底限定類名。 
<ejb-link> 可選 在包含的 J2EE 應用程序包中的 EJB 的 <ejb-name>。 
<run-as> 可選 安全角色，其安全上下文將應用於所引用的 EJB。必須是使用 <security-role> 元素定義的安全角色。 


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

ejb-local-ref 
ejb-local-ref 元素用於聲明對企業 Bean 本地主目錄的引用。聲明包括： 

可選的描述 
用於在 Web 應用程序代碼中引用企業 Bean 的 EJB 引用名稱。所引用的企業 Bean 的預期類型 
所引用的企業 Bean 的預期本地主目錄和本地接口 
可選的 ejb-link 信息，用於指定所引用的企業 Bean 
下表描述能夠在 ejb-local-ref 元素中定義的元素。

元素 必需/可選 描述 
<description> 可選 引用的文字描述。 
<ejb-ref-name> 必需 包含 EJB 引用的名稱。EJB 引用是 Web 應用程序環境中的一個條目，它相對於 java:comp/env 上下文。該名稱在 Web 應用程序中必須惟一。建議該名稱使用前綴 ejb/。 
例如： 
<ejb-ref-name>ejb/Payroll</ejb-ref-name> 
<ejb-ref-type> 必需 ejb-ref-type 元素包含所引用企業 Bean 的預期類型。ejb-ref-type 元素必須是如下某項： 
<ejb-ref-type>Entity</ejb-ref-type><ejb-ref-type>Session</ejb-ref-type> 
<local-home> 必需 包含企業 Bean 的本地 Home 接口的徹底限定名稱。 
<local> 必需 包含企業 Bean 的本地接口的徹底限定名稱。 
<ejb-link> 可選 ejb-link 元素用於 ejb-ref 或 ejb-local-ref 元素中以指定 EJB 上連接一個 EJB 引用。 
ejb-link 元素中的名稱包括一個路徑名。該路徑名指定包含所引用 EJB 的 ejb-jar，且追加了目標 Bean 的 ejb-name 並經過 # 與路徑名隔開。 
該路徑名相對於包含引用 EJB 的 Web 應用程序的 WAR 文件。所以可以惟一標識具備相同 ejb-name 的多個 EJB。
用於：ejb-local-ref 和 ejb-ref 元素。 
示例： 
<ejb-link>EmployeeRecord</ejb-link> 
<ejb-link>../products/product.jar#ProductEJB</ejb-link> 


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

web-app 
Servlet 2.4 部署描述符的 XML Schema。WebLogic Server 徹底支持 HTTP Servlet，如 Sun Microsystems 的 Servlet 2.4 specification 所定義。可是，version 特性必須設置爲 2.4，才能執行 2.4 行爲。 

下表描述能夠在 web-app 元素中定義的元素。

元素 必需/可選 描述 
<version> 必需 全部 Servlet 部署描述符必須指明 2.4 版本的 Schema，以便執行 Servlet 2.4 行爲。