無線&移動互聯網技術研發

          換位思考·····
          posts - 19, comments - 53, trackbacks - 0, articles - 283
            BlogJava :: 首頁 :: 新隨筆 :: 聯系 :: 聚合  :: 管理

          關于 web.xml 全面解析

          Posted on 2009-07-27 22:33 Gavin.lee 閱讀(445) 評論(0)  編輯  收藏 所屬分類: web 積累(前端 + 后臺)
          http://blog.csdn.net/SDMRauquin/archive/2008/12/23/3590844.aspx

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

          今天心血來潮,想系統復習一下web.xml,隨即在網上查查,摘了下文:

          <?xml version="1.0" encoding="UTF-8"?>
          <web-app version="2.4" 
              xmlns
          ="http://java.sun.com/xml/ns/j2ee" 
              xmlns:xsi
          ="http://www.w3.org/2001/XMLSchema-instance" 
              xsi:schemaLocation
          ="http://java.sun.com/xml/ns/j2ee 
              http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
          >
            
          <welcome-file-list>
              
          <welcome-file>index.jsp</welcome-file>
            
          </welcome-file-list>
            
            
          <context-param>
                
          <description></description>
                
          <param-name>context</param-name>
                
          <param-value>try</param-value>
            
          </context-param>
            
            
          <description>
            
          </description>
            
            
          <display-name></display-name>
            
            
          <filter>
                
          <filter-name>fileter</filter-name>
                
          <filter-class>com.yixun.wap.tools</filter-class>
            
          </filter>
            
          <filter-mapping>
                
          <filter-name></filter-name>
                
          <url-pattern></url-pattern>
                
          <dispatcher></dispatcher>      
            
          </filter-mapping>
            
            
          <listener>
                
          <description></description>
                
          <display-name></display-name>
                
          <icon></icon>
                
          <listener-class></listener-class>
            
          </listener>
            
            
          <servlet>
                
          <servlet-name></servlet-name>
                
          <servlet-class></servlet-class>
            
          </servlet>
            
          <servlet-mapping>
                
          <servlet-name></servlet-name>
                
          <url-pattern></url-pattern>
            
          </servlet-mapping>
            
            
          <session-config>
                
          <session-timeout></session-timeout>
            
          </session-config>
          </web-app>

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

            用來設定Web應用程序的配置。在Web.xml中的設定非常多,

            接下來分段來說明它的各項設定:

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

            元素 必需/可選 描述

            可選 用于在 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-RESOURCE-COLLECTION>元素所定義的資源集合的訪問權限。

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

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

            元素 必需/可選 描述

            <Web-RESOURCE-< p>

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

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

            

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

            另請參閱 user-data-constraint

            Web-resource-collection

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

            這是 security-constraint 內的元素。

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

            元素 必需/可選 描述

            <Web-RESOURCE-< p>

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

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

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

            可選 使用一個或多個 元素聲明受身份驗證約束的 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 行為。

          主站蜘蛛池模板: 南和县| 武宁县| 东至县| 麻栗坡县| 玛纳斯县| 攀枝花市| 景洪市| 中江县| 酉阳| 运城市| 集贤县| 汶川县| 屯昌县| 永昌县| 桃园市| 崇文区| 彭阳县| 奇台县| 彭州市| 邵东县| 宜都市| 双城市| 乌兰浩特市| 长汀县| 公主岭市| 临夏县| 临朐县| 汤原县| 浪卡子县| 黑龙江省| 陆川县| 丰原市| 顺平县| 廉江市| 呼图壁县| 平遥县| 惠东县| 独山县| 新营市| 克山县| 东辽县|