weblogic參數(shù).doc

weblogic-ra.xml Schema本附錄中的下面幾部分介紹了可以在特定于 WebLogic Server 的部署描述符 weblogic-ra.xml 中定義的部署描述符元素。weblogic-ra.xml的 Schema 是/ns/weblogic/90/weblogic-ra.xsd。如果資源適配器歸檔文件（resource adapter archive，簡(jiǎn)稱 RAR）不包含weblogic-ra.xml部署描述符，WebLogic Server 將自動(dòng)選擇部署描述符元素的默認(rèn)值。 weblogic-connector work-manager security properties admin-objects outbound-resource-adapterweblogic-connectorweblogic-connector元素是已部署資源適配器特定于 WebLogic 部署描述符的根元素?？梢栽趙eblogic-connector元素中定義下列元素。表 9-1weblogic-connector 子元素元素必需/可選描述native-libdir如果有本地庫(kù)，則為必需。指定資源適配器所需的所有本地庫(kù)所在的目錄。jndi-name僅當(dāng)指定資源適配器 bean 時(shí)為必需。指定資源適配器的 JNDI 名稱。資源適配器 bean 使用該名稱注冊(cè)到 JNDI 樹中。如果未指定資源適配器 bean，則它不是必需元素。如果為沒有資源適配器 bean 的資源適配器指定了 JNDI 名稱，則它是一個(gè)不起作用的元素。enable-access-outside-app可選正如 J2CA 1.5 規(guī)范中所述，如果將資源適配器打包到某個(gè)應(yīng)用程序中（換句話說(shuō)，就是打包到 EAR 中），則只有該應(yīng)用程序內(nèi)的組件才有權(quán)訪問(wèn)該資源適配器。使用此元素可以改變這一功能。注意：此元素不適用于獨(dú)立資源適配器。默認(rèn)值：false當(dāng)設(shè)置為 false 時(shí)，資源適配器只能由與該資源適配器駐留在同一應(yīng)用程序中的客戶端訪問(wèn)。注意：對(duì)于版本 1.0 資源適配器（受本版本中支持），此元素的默認(rèn)值設(shè)置為true。enable-global-access-to-classes可選當(dāng)設(shè)置為true時(shí)（默認(rèn)），可以全局訪問(wèn)資源適配器的類。work-manager可選此復(fù)雜元素用來(lái)指定用于創(chuàng)建將由資源適配器 bean 使用的工作管理器的所有可配置元素。work-manager元素是從weblogic-j2ee.xsdSchema 中導(dǎo)入的。工作管理器可以動(dòng)態(tài)調(diào)整工作線程的數(shù)量，以避免因并發(fā)限制導(dǎo)致的死鎖并可獲得最佳吞吐量。它還可以滿足響應(yīng)時(shí)間目標(biāo)、共享和優(yōu)先級(jí)等目標(biāo)的需要。有關(guān)work-manager的子元素的信息，請(qǐng)參閱work-manager。security可選此復(fù)雜元素用來(lái)指定用于資源適配器操作的所有安全性參數(shù)。有關(guān)連接器容器將采用的安全性默認(rèn)值的信息，請(qǐng)參閱perties可選此復(fù)雜元素用來(lái)替換在ra.xml文件中為資源適配器 bean 指定的任何屬性。有關(guān)properties的子元素的信息，請(qǐng)參閱properties。admin-objects可選此復(fù)雜元素定義了資源適配器中的所有管理對(duì)象。與outbound-resource-adapter復(fù)雜元素一樣，admin-objects復(fù)雜元素具有三個(gè)可以指定配置范圍的層次屬性級(jí)別：1. 全局級(jí) - 在此級(jí)別可以使用default-properties元素來(lái)指定適用于資源適配器的所有管理對(duì)象的參數(shù)。請(qǐng)參閱default-properties。2. 組級(jí) - 在此級(jí)別可以通過(guò)使用admin-object-group元素，指定適用于所有域?qū)ο螅▽儆趓a.xml部署描述符中指定的特定管理對(duì)象組）的參數(shù)。在該組中指定的屬性將替換在全局級(jí)指定的任何參數(shù)。請(qǐng)參閱admin-object-group。3. 實(shí)例級(jí) - 在每個(gè)管理對(duì)象組下，都可以使用admin-object-instance元素來(lái)指定管理對(duì)象實(shí)例。它們與資源適配器的管理對(duì)象實(shí)例相對(duì)應(yīng)。可以在實(shí)例級(jí)別指定屬性，并替換那些在組級(jí)和全局級(jí)提供的屬性。請(qǐng)參閱admin-object-instance。有關(guān)admin-objects子元素的信息，請(qǐng)參閱admin-objects。outbound-resource-adapter可選此復(fù)雜元素用來(lái)描述資源適配器的出站組件。與admin-objects復(fù)雜元素一樣，此元素具有三個(gè)層次屬性級(jí)別，可以指定配置范圍用以定義出站連接緩沖池：1. 全局級(jí) - 在此級(jí)別，可以使用default-connection-properties元素指定適用于資源適配器中的所有出站連接緩沖池的參數(shù)。請(qǐng)參閱default-connection-properties。2. 組級(jí) - 在此級(jí)別可以通過(guò)使用connection-definition-group元素，指定適用于所有出站連接（屬于ra.xml部署描述符中指定的特定連接工廠）的參數(shù)。ra.xml中的連接工廠與weblogic-ra.xml中的連接定義組之間存在一一對(duì)應(yīng)關(guān)系。在組中指定的屬性將替換全局級(jí)別上指定的任何參數(shù)。請(qǐng)參閱connection-definition-group。3. 實(shí)例級(jí) - 在每個(gè)連接定義組下，都可以指定連接實(shí)例。它們與資源適配器的各個(gè)連接緩沖池相對(duì)應(yīng)。也可以在此級(jí)別指定參數(shù)，且這些參數(shù)可以替換那些在組級(jí)和全局級(jí)提供的參數(shù)。請(qǐng)參閱connection-instance。有關(guān)outbound-resource-adapter子元素的信息，請(qǐng)參閱outbound-resource-adapter。work-managerwork-manager元素是一種復(fù)雜元素，用來(lái)指定用于創(chuàng)建資源適配器 bean 將使用的工作管理器的所有可配置元素。work-manager元素是從weblogic-j2ee.xsdSchema 中導(dǎo)入的。下列子元素可以在work-manager元素中配置。表 9-2 work-manager 子元素元素必需可選描述name必需指定工作管理器的名稱。J2CA 1.5 規(guī)范描述了資源適配器如何向應(yīng)用服務(wù)器提交工作線程。這些工作線程由 WebLogic Server 工作管理器管理。工作管理器可以動(dòng)態(tài)調(diào)整工作線程的數(shù)量，以避免因并發(fā)限制導(dǎo)致的死鎖并可獲得最佳吞吐量。它還可以滿足響應(yīng)時(shí)間目標(biāo)、共享和優(yōu)先級(jí)等目標(biāo)的需要。response-time-request-classfair-share-request-classcontext-request-classrequest-class-name可選work-manager元素可以且僅可以包括以下四個(gè)元素中的一個(gè)：response-time-request-class- 定義應(yīng)用程序的響應(yīng)時(shí)間請(qǐng)求類。響應(yīng)時(shí)間（毫妙）由特性 goal-ms 定義。增量為 (目標(biāo) - T) Cr)/R，其中 T 指平均線程使用時(shí)間，R 指達(dá)到率，Cr 指確定響應(yīng)時(shí)間目標(biāo)優(yōu)先于公平共享的系數(shù)。fair-share-request-class- 定義公平共享請(qǐng)求類。公平共享由默認(rèn)共享的屬性百分比定義。因此，默認(rèn)值是 100。增量是 Cf/(P R T)，其中 P 指百分比，R 指達(dá)到率，T 指平均線程使用時(shí)間，Cf 指公平共享優(yōu)先級(jí)低于響應(yīng)時(shí)間目標(biāo)的系數(shù)。context-request-class- 定義上下文類。上下文由將上下文信息（如當(dāng)前用戶或其角色、cookie 或工作區(qū)域字段）映射到已命名的服務(wù)類的多個(gè)案例定義。request-class-name- 定義請(qǐng)求類名稱。min-threads-constraintmin-threads-constraint-name可選可以從以下兩種元素之間選擇一個(gè)：min-threads-constraint- 用來(lái)保證服務(wù)器向受約束工作集的請(qǐng)求分配的線程數(shù)，以避免死鎖。默認(rèn)值為零。例如，對(duì)于復(fù)制更新請(qǐng)求，最少線程值如果為一（可以從對(duì)等方同步調(diào)用），則該值非常有用。min-threads-constraint-name- 定義min-threads-constraint元素的名稱。max-threads-constraintmax-threads-constraint-name可選可以從以下兩種元素之間選擇一個(gè)：max-threads-constraint- 限制執(zhí)行來(lái)自受約束工作集的請(qǐng)求的并發(fā)線程數(shù)量。默認(rèn)值是無(wú)限制。例如，假設(shè)約束被定義為最多具有 10 個(gè)線程，并且由 3 個(gè)入口點(diǎn)共享。調(diào)度邏輯可確保執(zhí)行來(lái)自三個(gè)入口點(diǎn)組合的請(qǐng)求的線程不超過(guò) 10 個(gè)。max-threads-constraint-name- 定義max-threads-constraint元素的名稱。capacitycapacity-name可選可以從以下兩種元素之間選擇一個(gè)：capacity- 可以定義約束并將其應(yīng)用于入口點(diǎn)集（稱為受約束的工作集）。只有達(dá)到該容量時(shí)服務(wù)器才開始拒絕請(qǐng)求。默認(rèn)值為零。請(qǐng)注意，容量包括受約束的工作集中已經(jīng)排隊(duì)或正在執(zhí)行的所有請(qǐng)求。此約束主要用于像 JMS 之類的子系統(tǒng)，它們執(zhí)行自己的流控制。此約束與全局隊(duì)列閾值無(wú)關(guān)。capacity-name- 定義capacity元素的名稱。securitysecurity 復(fù)雜元素包括對(duì)連接器容器配置的默認(rèn)安全性信息。有關(guān)詳細(xì)信息，請(qǐng)參閱為資源適配器配置安全標(biāo)識(shí)。表 9-3 安全子元素元素必需可選描述default-principal-name可選指定用來(lái)調(diào)用資源適配器的默認(rèn)安全 ID。如果未指定此值，則默認(rèn)值為anonymous標(biāo)識(shí)，這等同于沒有安全標(biāo)識(shí)。有關(guān)此元素的子元素的信息，請(qǐng)參閱default-principal-name。manage-as-principal-name可選指定將用來(lái)運(yùn)行各種資源適配器管理任務(wù)的安全 ID，這些任務(wù)包括啟動(dòng)、關(guān)閉、測(cè)試、收縮和事務(wù)管理。如果未指定，則默認(rèn)值為default-principal-name。如果未指定default-principal-name，則默認(rèn)為anonymous標(biāo)識(shí)。有關(guān)此元素的子元素的信息，請(qǐng)參閱manage-as-principal-name。run-as-principal-name可選指定在連接請(qǐng)求期間，從連接器容器到資源適配器代碼的所有調(diào)用所使用的安全 ID。（此元素當(dāng)前僅適用于出站功能。）如果未指定，則默認(rèn)值為default-principal-name。如果未指定default-principal-name，將使用請(qǐng)求調(diào)用程序的標(biāo)識(shí)。有關(guān)此元素的子元素的信息，請(qǐng)參閱run-as-principal-name。run-work-as-principal-name可選指定用來(lái)運(yùn)行由該資源適配器啟動(dòng)的所有工作實(shí)例的安全 ID。如果未指定，則默認(rèn)值為default-principal-name。如果未指定default-principal-name，則將使用用來(lái)啟動(dòng)該工作的標(biāo)識(shí)。有關(guān)此元素的子元素的信息，請(qǐng)參閱run-work-as-principal-name。default-principal-namedefault-principal-name元素包含下列子元素。表 9-4 default-principal-name 子元素元素必需可選描述use-anonymous-identity必需指定應(yīng)使用匿名標(biāo)識(shí)。principal-name必需指定應(yīng)使用委托人名稱。該名稱必須與已定義的 WebLogic Server 用戶名稱匹配。manage-as-principal-namemanage-as-principal-name元素包括下列子元素。表 9-5 manage-as-principal-name 子元素元素必需可選描述use-anonymous-identity必需指定應(yīng)使用匿名標(biāo)識(shí)。principal-name必需指定應(yīng)使用委托人名稱。該名稱必須與已定義的 WebLogic Server 用戶名稱匹配。run-as-principal-namerun-as-principal-name元素包含下列子元素。表 9-6 run-as-principal-name 子元素元素必需可選描述use-anonymous-identity必需指定應(yīng)使用匿名標(biāo)識(shí)。principal-name必需指定應(yīng)使用委托人名稱。該名稱必須與已定義的 WebLogic Server 用戶名稱匹配。use-caller-identity必需指定應(yīng)使用調(diào)用程序的標(biāo)識(shí)。run-work-as-principal-namerun-work-as-principal-name元素包含下列子元素。表 9-7 run-work-as-principal-name 子元素元素必需可選描述use-anonymous-identity必需指定應(yīng)使用anonymous標(biāo)識(shí)。principal-name必需指定應(yīng)使用委托人名稱。該名稱必須與已定義的 WebLogic Server 用戶名稱匹配。use-caller-identity必需指定應(yīng)使用調(diào)用程序的標(biāo)識(shí)。propertiesproperties元素是weblogic-connector的子元素，它是在ra.xml中為資源適配器 bean 指定的屬性的容器。它擁有一個(gè)或多個(gè)property元素。可以在properties元素內(nèi)定義如下property元素。表 9-8 properties 子元素元素必需可選描述property必需property 元素用來(lái)替換在ra.xml文件中為資源適配器 bean 指定的屬性。它擁有以下兩個(gè)子元素：name- 指定與config-property-name元素（ra.xml部署描述符中的config-property的子元素）相同的名稱。設(shè)置此參數(shù)會(huì)導(dǎo)致替換ra.xml中相關(guān)的config-property-value元素。這是必需的元素。value- 指定替換config-property-value元素（ra.xml部署描述符中的config-property的子元素）的值。這是可選元素。admin-objectsadmin-objects復(fù)雜元素定義了資源適配器中的所有管理對(duì)象。與outbound-resource-adapter復(fù)雜元素一樣，admin-objects復(fù)雜元素具有可以指定的三個(gè)層次屬性級(jí)別。admin-objects元素是weblogic-connector元素的子元素?？梢栽赼dmin-objects元素中定義下列元素。表 9-9 admin-objects 子元素元素必需可選描述default-properties可選指定適用于資源適配器中所有管理對(duì)象（全局級(jí)）的默認(rèn)屬性。default-properties元素可以包含一個(gè)或多個(gè)屬性元素，每個(gè)屬性元素都有name和value對(duì)。請(qǐng)參閱properties。admin-object-group一個(gè)或多個(gè)指定適用于所有管理對(duì)象（屬于在ra.xml部署描述符中指定的特定管理對(duì)象組）的默認(rèn)參數(shù)。在該組中指定的屬性將替換在全局級(jí)指定的任何參數(shù)。有關(guān)admin-object-group子元素的信息，請(qǐng)參閱admin-object-group。admin-object-groupadmin-object-group元素用來(lái)定義管理對(duì)象組。在組級(jí)別指定適用于所有管理對(duì)象（屬于ra.xml部署描述符中指定的特定管理對(duì)象組）的參數(shù)。在該組中指定的屬性將替換在全局級(jí)指定的任何參數(shù)。admin-object-interface元素（admin-object-group元素的子元素）將作為每個(gè)admin-object-group的唯一必備元素（關(guān)鍵字）。weblogic-ra.xmladmin-object-interface元素和ra.xmladminobject-interface元素之間必須是一一對(duì)應(yīng)的關(guān)系admin-object-group元素是weblogic-connector元素的子元素。可以在admin-object-group元素中定義下列元素。表 9-10 admin-object-group元素必需可選描述admin-object-interface必需admin-object-interface元素是每個(gè)admin-object-group的唯一必備元素（關(guān)鍵字）。weblogic-ra.xmladmin-object-interface元素和ra.xmladminobject-interface元素之間必須是一一對(duì)應(yīng)的關(guān)系。default-properties可選指定適用于此管理對(duì)象組中的所有管理對(duì)象的默認(rèn)屬性。default-properties元素可以包括一個(gè)或多個(gè)property元素，每個(gè)元素都有name和value對(duì)。請(qǐng)參閱properties。admin-object-instance一個(gè)或多個(gè)指定該管理對(duì)象組中的一個(gè)或多個(gè)管理對(duì)象實(shí)例，它們與資源適配器的管理對(duì)象實(shí)例相對(duì)應(yīng)?？梢栽趯?shí)例級(jí)別指定屬性，并替換在組級(jí)和全局級(jí)別提供的那些屬性。有關(guān)子元素的信息，請(qǐng)參閱admin-object-instance。admin-object-instance可以在admin-object-instance下定義下列子元素。表 9-11 admin-object-instance 子元素元素必需可選描述jndi-name / resource-link必需定義管理對(duì)象實(shí)例引用名稱的管理對(duì)象組?？梢詫⒁妹Q指定為連接實(shí)例的 JNDI 名稱或資源鏈接。如果指定了 JNDI 名稱（通過(guò)指定jndi-name元素），將把連接緩沖池綁定到客戶端在應(yīng)用程序之外可以看到的 JNDI 中。注意：為了使此設(shè)置生效，enable-access-outside-app元素必須設(shè)置為 true。對(duì)于那些不需要從外部對(duì)其他應(yīng)用程序可視的資源適配器，需要指定resource-link值。admin-object-properties可選定義適用于管理對(duì)象實(shí)例的所有屬性。admin-object-properties元素可以包括一個(gè)或多個(gè)property元素，每個(gè)元素都有name和value對(duì)。請(qǐng)參閱properties。outbound-resource-adapteroutbound-resource-adapter元素是weblogic-connector元素的子元素?？梢栽趏utbound-resource-adapter元素中定義下列元素。表 9-12 outbound-resource-adapter 子元素元素必需可選描述default-connection-properties可選此復(fù)雜元素用來(lái)在全局級(jí)指定屬性。在此級(jí)別，用戶能夠指定適用于該資源適配器中的所有出站連接緩沖池的參數(shù)。有關(guān)子元素的信息，請(qǐng)參閱default-connection-properties。connection-definition-group一個(gè)或多個(gè)此元素用來(lái)指定所有連接定義組。在ra.xml部署描述符中的連接工廠和weblogic-ra.xml部署描述符中的組之間必須有一一對(duì)應(yīng)關(guān)系。對(duì)于ra.xml的每個(gè)連接工廠，weblogic-ra.xml部署描述符中不一定存在組。但是，如果存在一個(gè)組，則該組中必須至少有一個(gè)連接實(shí)例。在組中指定的屬性將替代使用default-connection-properties在全局級(jí)指定的所有參數(shù)。有關(guān)子元素的信息，請(qǐng)參閱connection-definition-group。default-connection-propertiesdefault-connection-properties元素是outbound-resource-adapter元素的子元素?？梢栽赿efault-connection-properties元素中定義下列元素。表 9-13 default-connection-properties 子元素元素必需可選描述pool-params可選用作為此連接工廠提供特定于連接緩沖池的參數(shù)的根元素。WebLogic Server 使用這些規(guī)范來(lái)控制 ManagedConnections 的保留緩沖池的行為。這是可選元素。指定此元素或其任何特定元素項(xiàng)失敗將導(dǎo)致分配默認(rèn)值。請(qǐng)參考對(duì)每個(gè)具體元素的描述，以了解指定的默認(rèn)值。有關(guān)子元素的信息，請(qǐng)參閱pool-params。logging可選包含用于配置ManagedConnectionFactory的日志記錄和資源適配器的ManagedConnection對(duì)象的參數(shù)。有關(guān)子元素的信息，請(qǐng)參閱logging。transaction-support可選指定特定連接工廠的事務(wù)支持的級(jí)別。它提供了替換在ra.xml部署描述符中指定的事務(wù)支持值的能力，該值本來(lái)是資源適配器的所有連接工廠的默認(rèn)值。事務(wù)支持的值必須為下列值之一：NoTransactionLocalTransactionXATransaction相關(guān)信息，請(qǐng)參閱連接管理。authentication-mechanism可選authentication-mechanism元素指定了資源適配器中特定連接工廠所支持的身份驗(yàn)證機(jī)制。它提供了替換在ra.xml部署描述符中指定的authentication-mechanism值的能力，該值本來(lái)是資源適配器的所有連接工廠的默認(rèn)值。請(qǐng)注意，BasicPassword機(jī)制類型必須支持javax.resource.spi.security.PasswordCredential接口。reauthentication-support可選是布爾值，用來(lái)指定特定連接工廠是否支持對(duì)現(xiàn)有ManagedConnection實(shí)例重新進(jìn)行身份驗(yàn)證。它提供了替換在ra.xml部署描述符中指定的reauthentication-support值的能力，該值本來(lái)是資源適配器的所有連接工廠的默認(rèn)值。properties可選properties 元素包括一個(gè)或多個(gè) property 元素，后者定義了適用于默認(rèn)連接的子元素的名稱和值。res-auth可選指定是否使用容器或應(yīng)用程序管理的安全性。此元素的值可以是Application或Container。默認(rèn)值是 Container。pool-paramspool-params元素是default-connection-properties元素的子元素?？梢栽趐ool-params元素中定義下列元素。表 9-14 pool-params 子元素元素必需可選描述initial-capacity可選指定部署期間 WebLogic Server 嘗試創(chuàng)建的 ManagedConnections 的初始數(shù)量。默認(rèn)值：1max-capacity可選指定 WebLogic Server 允許的 ManagedConnections 最大數(shù)量。如果新分配 ManagedConnections 的請(qǐng)求超出此限制，則會(huì)導(dǎo)致將ResourceAllocationException返回給調(diào)用程序。默認(rèn)值：10capacity-increment可選指定在重新調(diào)整保留的連接緩沖池期間，WebLogic Server 嘗試創(chuàng)建的附加 ManagedConnections 的最大數(shù)量。默認(rèn)值：1shrinking-enabled可選指定是否銷毀未使用的 ManagedConnections 并將其從連接緩沖池中刪除，這是一種控制系統(tǒng)資源的手段。默認(rèn)值：trueshrink-frequency-seconds可選指定 Connection Pool Management 在連續(xù)兩次嘗試銷毀未使用的 ManagedConnections 之間需要等待的時(shí)間（以秒為單位）。默認(rèn)值：900 秒highest-num-waiters可選指定可以并發(fā)阻止等待的最大線程數(shù)，以保留與緩沖池的連接。默認(rèn)值：0highest-num-unavailable可選指定應(yīng)用程序在進(jìn)行諸如刷新連接等操作時(shí)，緩沖池中不可用 ManagedConnections 的最大數(shù)。請(qǐng)注意，在后端系統(tǒng)不可用等情況下，由于存在一些緩沖池?zé)o法控制的因素，實(shí)際數(shù)可能會(huì)超出此指定值。默認(rèn)值：0connection-creation-retry-frequency-seconds可選緩沖池創(chuàng)建連接重試嘗試的周期。默認(rèn)值：0connection-reserve-timeout-seconds可選設(shè)置保留與緩沖池的連接的調(diào)用超時(shí)前持續(xù)的時(shí)間（以秒為單位）。默認(rèn)值：-1（保留資源時(shí)不阻塞）test-frequency-seconds可選對(duì)緩沖池中的連接的測(cè)試頻率。默認(rèn)值：0test-connections-on-create可選啟用對(duì)新建連接的測(cè)試。默認(rèn)值：falsetest-connections-on-release可選啟用將連接釋放到緩沖池時(shí)對(duì)這些連接進(jìn)行測(cè)試。默認(rèn)值：falsetest-connections-on-reserve可選啟用在保留連接時(shí)對(duì)它們進(jìn)行測(cè)試。默認(rèn)值：falseprofile-harvest-frequency-seconds可選指定收集連接緩沖池的配置文件的頻率。ignore-in-use-connections-enabled可選此元素用來(lái)指定關(guān)閉連接緩沖池時(shí)，忽略當(dāng)時(shí)正在使用的連接是否可以接受。match-connections-supported可選指出資源適配器是否支持ManagedConnectionFactory.matchManagedConnections()方法。如果資源適配器不支持此方法（始終對(duì)此方法返回 null），則 WebLogic Server 將在連接請(qǐng)求期間繞過(guò)此方法調(diào)用。默認(rèn)值：truelogginglogging元素是default-connection-properties元素的子元素?？梢栽趌ogging元素中定義下列元素。表 9-15 logging 子元素元素必需可選描述log-filename可選指定日志文件的名稱，根據(jù)此日志發(fā)送從ManagedConnectionFactory或ManagedConnection生成的輸出。需要提供該文件名的完整地址。logging-enabled可選指定是否為ManagedConnectionFactory或ManagedConnection設(shè)置了日志編寫器。如果將此元素設(shè)置為 true，則從ManagedConnectionFactory或ManagedConnection中生成的輸出將發(fā)送到由log-filename元素指定的文件。默認(rèn)值：falserotation-type可選設(shè)置文件滾動(dòng)類型?？赡苤蛋╞ySize、byName和nonebySize- 當(dāng)日志文件大小達(dá)到在file-size-limit中指定的大小時(shí)，服務(wù)器將把該文件重命名為FileName.n。byName- 按照在 file-time-span 中指定的時(shí)間間隔，服務(wù)器將該文件重命名為FileName.n。在服務(wù)器重命名某個(gè)文件之后，后續(xù)的消息會(huì)累積在一個(gè)名稱在log-filename中指定的新文件中。none- 消息累積在單個(gè)文件中。當(dāng)日志文件太大而影響使用時(shí)，必須清除其內(nèi)容。默認(rèn)值：bySizenumber-of-files-limited可選指定是否限制此服務(wù)器實(shí)例為存儲(chǔ)舊日志消息而創(chuàng)建的文件的數(shù)量。（需要指定bySize的滾動(dòng)類型）。服務(wù)器達(dá)到此限制后，它將覆蓋最舊的文件。如果不啟用此選項(xiàng)，服務(wù)器將無(wú)限制地創(chuàng)建新文件，這樣就必須在需要時(shí)清除這些文件。如果通過(guò)將number-of-files-limited設(shè)置為 true 啟用該選項(xiàng)，則服務(wù)器將參考rotationType變量來(lái)決定如何滾動(dòng)該日志文件。滾動(dòng)意味著替換現(xiàn)有文件而不是創(chuàng)建新文件。如果將number-of-files-limited指定為false，則服務(wù)器將創(chuàng)建大量日志文件而不是替換同一個(gè)日志文件。默認(rèn)值：falsefile-count可選服務(wù)器在滾動(dòng)日志時(shí)創(chuàng)建的日志文件的最大數(shù)量。該數(shù)目不包括服務(wù)器用于存儲(chǔ)當(dāng)前消息的文件。（需要啟用number-of-files-limited。）默認(rèn)值：7file-size-limit可選觸發(fā)服務(wù)器將日志消息移動(dòng)到單個(gè)文件的大小。（需要指定bySize的滾動(dòng)類型。）日志文件達(dá)到指定的最小大小之后，服務(wù)器會(huì)在下次檢查文件大小時(shí)將當(dāng)前的日志文件重命名為FileName.n，并新建一個(gè)用來(lái)存儲(chǔ)后續(xù)消息的文件。默認(rèn)值：500rotate-log-on-startup可選指定服務(wù)器在其啟動(dòng)周期內(nèi)是否滾動(dòng)其日志文件。默認(rèn)值：truelog-file-rotation-dir可選指定將存儲(chǔ)滾動(dòng)日志文件的目錄的路徑。rotation-time可選日志文件基于時(shí)間滾動(dòng)順序的開始時(shí)間的格式為k:mm，其中k是 1-24。（需要指定byTime的滾動(dòng)類型）。在到達(dá)指定時(shí)間時(shí)，服務(wù)器會(huì)重命名當(dāng)前的日志文件。之后，服務(wù)器將按照在file-time-span中指定的間隔重命名日志文件。如果指定的時(shí)刻已過(guò)，服務(wù)器會(huì)立即開始其文件滾動(dòng)。默認(rèn)情況下，滾動(dòng)周期會(huì)立