web.xml 部署描述符元素

轉自 :http://soft.zdnet.com.cn/software_zone/2007/1013/551300.shtml 

 

在每一個Web應用程序路徑的WEB-INF下和conf下存在一個Web.xml配置文件,

  用來設定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來源。

  Web.xml的dtd是由Sun Microsystems公司所制定的,可以在下列的網址獲得詳細的信息:

  http://java.sun.com/j2ee/dtds/Web-app_2_2.dtd。

  下列部分描述根元素 下的 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 元素中定義的元素。

  元素 必需/可選 描述

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

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

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

  display-name

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

  元素 必需/可選 描述

  可選 當前 WebLogic Server 尚不使用此元素。

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

  description

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

  元素 必需/可選 描述

  可選 當前 WebLogic Server 尚不使用此元素。

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

  distributable

  WebLogic Server 不使用 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 元素中定義的元素。

  元素 必需/可選 描述

  可選 指定用於在 GUI 工具中表示篩選器的大小圖像在 Web 應用程序中的位置。包含小圖標和大圖標元素。

  當前 WebLogic Server 尚不使用此元素。

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

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

  可選 篩選器的文字描述。

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

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

  每個特性使用獨立的一組 標記。

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

  filter-mapping

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

  元素 必需/可選 描述

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

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

  示例模式:

  /soda/grape/*

  /foo/*

  /contents

  *.foo

  URL 必須遵循 Servlet 2.3 規範中指定的規則。

  必需 - 或由 映射 Servlet 的名稱,如果調用它,則會執行該篩選器。

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

  listener

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

  元素 必需/可選 描述

  可選 響應 Web 應用程序事件的類的名稱。

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

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

  servlet

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

  如果指定了 jsp-file 且存在 元素,則將在 WebLogic Server 啓動時預編譯和加載該 JSP。

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

  元素 必需/可選 描述

  可選 用於在 GUI 工具中表示 servlet 的大小圖像在 Web 應用程序中的位置。包含小圖標和大圖標元素。

  當前 WebLogic Server 尚不使用此元素。

  必需 定義 servlet 的規範名稱,用於在部署描述符中的其他位置上引用 servlet 定義。

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

  可選 servlet 的文字描述。

  必需(或使用

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

  在 servlet 正文中僅使用 標記或 標記中的任意一種。

  必需(或使用

  class>) Web 應用程序中的 JSP 文件相對於 Web 應用程序根目錄的完整路徑。

  在 servlet 正文中僅使用 標記或 標記中的任意一種。

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

  每個特性使用獨立的一組 標記。

  可選 當 WebLogic Server 啓動時,WebLogic Server 將初始化此 servlet。此元素內容可選,但必須是正整數,它指明 servlet 的加載順序。指定了低整數的 servlet 將於高整數 servlet 之前加載。如果沒有指定任何值,或如果所指定的值不是正整數,則在應用程序啓動期間,WebLogic Server 可以以任意順序加載 servlet。

  可選 指定將用於 Web 應用程序執行的 run-as 標識。該元素包含可選描述和安全角色的名稱。

  

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

  icon

  這是 Servlet 內的元素。

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

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

  元素 必需/可選 描述

  可選 指定用於在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小圖像(16x16 像素)在 Web 應用程序內的位置。

  當前 WebLogic Server 尚不使用此元素。

  可選 指定用於在 GUI 工具中表示 servlet 的 .gif 或 .jpg 小圖像(32x32 像素)在 Web 應用程序內的位置。

  當前 WebLogic Server 尚不使用此元素。

  init-param

  這是 Servlet 內的元素。

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

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

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

  元素 必需/可選 描述

  必需 定義此特性的名稱。

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

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

  security-role-ref

  這是 Servlet 內的元素。

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

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

  元素 必需/可選 描述

  可選 角色的文字描述。

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

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

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

  servlet-mapping

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

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

  元素 必需/可選 描述

  必需 要將 URL 模式映射至的 servlet 的名稱。該名稱對應於您在 聲明標記中爲 servlet 分配的名稱。

  必需 描述用於解析 URL 的模式。將 http://host:port+ WebAppName 之後的 URL 部分與 WebLogic Server 的 進行比較。如果模式匹配,則將調用該元素中映射的 servlet。

  示例模式:

  /soda/grape/*

  /foo/*

  /contents

  *.foo

  URL 必須遵循 Servlet 2.3 規範中指定的規則。

  有關 Servlet 映射的其他示例,請參閱 Servlet 映射。

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

  session-config

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

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

  元素 必需/可選 描述

  可選 會話過期分鐘數,該 Web 應用程序中的會話將在此時間後過期。除非輸入此處列出的某個特殊值,否則此元素中設置的值將替代 WebLogic 特定部署描述符 weblogic.xml 中的 元素的 TimeoutSecs 特性中設置的值。

  默認值:-2

  最大值:Integer.MAX_VALUE ?

  特殊值:

  -2 表示使用 weblogic.xml的 元素中的 TimeoutSecs 設置的值。

  -1 表示會話永不超時。將忽略 weblogic.xml 的 元素中設置的值。

  有關詳細信息,請參閱 session-descriptor。

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

  mime-mapping

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

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

  元素 必需/可選 描述

  必需 描述擴展名的字符串,例如:txt。

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

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

  welcome-file-list

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

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

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

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

  元素 必需/可選 描述

  可選 用作默認歡迎文件的文件名,例如 index.html

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

  error-page

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

  WebLogic Server 響應 HTTP 請求的過程中發生錯誤或由於 Java 異常而發生錯誤時,WebLogic Server 會返回一個 HTML 頁面,其中顯示 HTTP 錯誤代碼或包含 Java 錯誤信息的頁面。可以定義顯示自己的 HTML 頁面,而不顯示這些默認錯誤頁面,或響應 Java 異常。

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

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

  注意: 定義 或 ,但兩者不能同時定義。

  元素 必需/可選 描述

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

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

  必需 爲響應錯誤而顯示的資源的位置。例如,/myErrorPg.html。

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

  taglib

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

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

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

  元素 必需/可選 描述

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

  必需 描述相對於 web.xml 文檔位置的 URI,標識 Web 應用程序中使用的標記庫。

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

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

  resource-env-ref

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

  例如:

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

  元素 必需/可選 描述

  可選 提供資源環境引用的描述。

  必需 指定資源環境引用的名稱;其值爲 Web 應用程序代碼中使用的環境條目名稱。名稱是相對於 java:comp/env 上下文的 JNDI 名稱,該名稱在 Web 應用程序中必須唯一。

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

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

  resource-ref

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

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

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

  元素 必需/可選 描述

  可選 文字描述。

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

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

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

  如果設置爲 APPLICATION,則表明應用程序組件代碼將以編程方式執行資源登錄。如果設置爲 CONTAINER,則 WebLogic Server 將使用隨 login-config 元素建立的安全上下文。請參閱 login-config。

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

  有效值:

  Shareable(可共享)

  Unshareable(不可共享)

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

  security-constraint

  security-constraint 元素定義對 元素所定義的資源集合的訪問權限。

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

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

  元素 必需/可選 描述

  

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

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

  

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

  另請參閱 user-data-constraint

  web-resource-collection

  每個 元素必須具有一個或多個 元素。它們定義應用此安全約束的 Web 應用程序的區域。

  這是 security-constraint 內的元素。

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

  元素 必需/可選 描述

  

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

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

  可選 使用一個或多個 元素聲明此安全約束將應用至的 URL 模式。如果您不使用其中至少一個元素,則 WebLogic Server 將忽略 。

  可選 使用一個或多個 元素聲明受身份驗證約束的 HTTP 方法(通常是 GET 或 POST)。如果忽略 元素,則默認行爲是向所有 HTTP 方法應用安全約束。

  auth-constraint

  這是 security-constraint 內的元素。

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

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

  元素 必需/可選 描述

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

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

  user-data-constraint

  這是 security-constraint 內的元素。

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

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

  元素 必需/可選 描述

  可選 文字描述。

  

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

  當使用 INTEGRAL 或 CONFIDENTIAL 傳輸保證對用戶進行身份驗證時,WebLogic Server 會建立安全套接口層 (SSL) 連接。

  值範圍:

  NONE- 應用程序不需要任何傳輸保證。

  INTEGRAL- 應用程序要求數據在客戶端和服務器之間傳輸的過程中不會被更改。

  CONFIDENTIAL- 應用程序要求傳輸數據以防止其他實體觀察到傳輸的內容。

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

  login-config

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

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

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

  元素 必需/可選 描述

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

  BASIC - 使用瀏覽器身份驗證。(這是默認值。)

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

  CLIENT-CERT

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

  可選 對用戶憑據進行身份驗證時所引用的領域名稱。如果忽略,則默認使用管理控制檯中的“Web 應用程序”“配置”“其他”選項卡上的“身份驗證領域名”字段中定義的領域。

  注意: 元素不引用 WebLogic Server 內的系統安全領域。該元素定義 HTTP 基本身份驗證中使用的領域名稱。系統安全領域是在服務器上執行特定操作時將檢查的安全信息的集合。servlet 安全領域是訪問頁面和使用基本身份驗證時要檢查的另外一組安全信息的集合。

  

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

  form-login-config

  這是 login-config 內的元素。

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

  .

  元素 必需/可選 描述

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

  必需 相對於文檔根目錄的 Web 資源 URI,會將它發送給用戶以響應失敗的身份驗證登錄。

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

  security-role

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

  元素 必需/可選 描述

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

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

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

  env-entry

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

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

  元素 必需/可選 描述

  可選 文字描述。

  必需 環境條目的名稱。

  必需 環境條目的值。

  必需 環境條目的類型。

  可以設置爲下列 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 應用程序中使用的 EJB 的名稱。在 WebLogic 特定的部署描述符 weblogic.xml 中,該名稱映射至 JNDI 樹。有關詳細信息,請參閱 ejb-reference-description。

  必需 所引用的 EJB 的預期 Java 類類型。

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

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

  可選 在包含的 J2EE 應用程序包中的 EJB 的 。

  可選 安全角色,其安全上下文將應用於所引用的 EJB。必須是使用 元素定義的安全角色。

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

  ejb-local-ref

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

  可選的描述

  用於在 Web 應用程序代碼中引用企業 Bean 的 EJB 引用名稱。所引用的企業 Bean 的預期類型

  所引用的企業 Bean 的預期本地主目錄和本地接口

  可選的 ejb-link 信息,用於指定所引用的企業 Bean

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

  元素 必需/可選 描述

  可選 引用的文字描述。

  必需 包含 EJB 引用的名稱。EJB 引用是 Web 應用程序環境中的一個條目,它相對於 java:comp/env 上下文。該名稱在 Web 應用程序中必須唯一。建議該名稱使用前綴 ejb/。

  例如:

  ejb/Payroll

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

  EntitySession

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

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

  可選 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 元素。

  示例:

  EmployeeRecord

  ../products/product.jar#ProductEJB

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

  web-app

  Servlet 2.4 部署描述符的 XML Schema。WebLogic Server 完全支持 HTTP Servlet,如 Sun Microsystems 的 Servlet 2.4 specification 所定義。但是,version 特性必須設置爲 2.4,才能執行 2.4 行爲。

  下表描述可以在 web-app 元素中定義的元素。

  元素 必需/可選 描述

  必需 所有 Servlet 部署描述符必須指明 2.4 版本的 Schema,以便執行 Servlet 2.4 行爲。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章