weblogicxml配置部署描述符元素.docx

weblogicxml配置部署描述符元素.docx

《weblogicxml配置部署描述符元素.docx》由会员分享，可在线阅读，更多相关《weblogicxml配置部署描述符元素.docx（39页珍藏版）》请在冰豆网上搜索。

weblogicxml配置部署描述符元素

weblogic.xml

true

---设成truejsp就会报classcastException

false

---设成false就没有问题了。

怎么回事呢？

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

这个设置指的是，是否优选web-info目录下的classes。

如果你的classes没有在web-info目录下，又设置为true，就会出现问题了。

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

weblogic.xml的作用和配置

2011-05-2016:

49

weblogicServer允许通过设置weblogic应用程序扩展描述符（weblogic.xml）配置jsp容器，该文件通常位于web应用程序的web-inf目录下。

一般不通过修改weblogic文件直接配置，而是通过控制台配置该文件，在Deploments-->webApplication-->defaultWebApp中配置。

可在开发和生产环境中配置不同的信息。

主要配置信息：

compilerSupportsEncoding

//true－－支持使用字符集

encoding

//指定jsp文件的默认字符集，如gb2312；

vervose

//是否将调试信息输出到浏览器和日志；

keepgenerated

//是否让编译jsp文件产生的.java文件持续存在；

PageCheckSeconds

//正数－－在以秒为单位的时间间隔检查jsp文件是否发生了修改，如果是则重新编译；

//0－－在每一个请求检查jsp;

//-1－－不对jsp文件进行检查。

Precompile

//true－－在weblogic服务器启动时自动编译所有的jsp。

DebugEnable//true－－是否允许调试。

weblogic.xml部署描述符元素

本文档提供WebLogicServer特定的部署描述符weblogic.xml中的元素的完整参考。

如果您的Web应用程序不包含weblogic.xml部署描述符，WebLogicServer会自动选择部署描述符元素的默认值。

要查看weblogic.xml的Schema，请转至

下列部分描述weblogic.xml部署描述符中根元素下可定义的复杂部署描述符元素：

▪description

▪weblogic-version

▪security-role-assignment

▪run-as-role-assignment

▪reference-descriptorGroup

▪session-descriptor

▪jsp-descriptor

▪auth-filter

▪container-descriptor

▪charset-params

▪virtual-directory-mapping

▪url-match-map

▪security-permission

▪context-root

▪wl-dispatch-policy

▪servlet-descriptor

▪work-manager

▪logging

▪library-ref

▪向后兼容性标志

▪Web容器全局配置

description

description元素是Web应用程序的文字描述。

weblogic-version

weblogic-version元素表示该Web应用程序（在根元素下定义）即将部署至的WebLogicServer的版本。

该元素仅表示版本信息，WebLogicServer并不使用该元素。

security-role-assignment

security-role-assignment元素声明Web应用程序安全角色与WebLogicServer中一个或多个委托人之间的映射，如以下示例所示。

PayrollAdmin

Tanya

Fred

system

还可以使用它将给定角色标记为外部定义的角色，如以下示例所示：

roleadmin

注意：

在元素中，必须定义或。

不能两者都忽略。

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

元素

必需

可选

描述

必需

指定安全角色的名称。

如果未定义，则此元素必需。

指定安全领域内定义的委托人的名称。

可以使用多个元素向一个角色映射多个委托人。

有关安全领域的详细信息，请参阅确保WebLogic安全性。

如果未定义，则此元素必需。

指定在安全领域内全局定义某特定安全角色；WebLogicServer使用该安全角色作为委托人名称，而无需在全局领域内查找委托人。

如果还在其他位置上定义了该安全角色及其委托人名称的映射，则该元素将用作表示性占位符。

注意：

如果您不定义security-role-assignment元素及其子元素，则Web应用程序容器会将该角色名隐式映射为委托人名称，并记录一条警告。

如果不定义映射，则EJB容器不部署该模块。

注意：

假设角色名是“role_xyz”，请考虑以下使用场景

▪如果在weblogic.xml中将“role_xyz”映射至用户“joe”，则role_xyz成为本地角色。

▪如果将role_xyz指定为外部定义的角色，则它成为全局角色（它指领域级别上定义的角色）。

▪如果不定义security-role-assignment元素，role_xyz成为本地角色，且Web应用程序容器创建其隐式映射，并记录一条警告。

run-as-role-assignment

run-as-role-assignment元素将web.xml中的run-as角色名（servlet元素的子元素）映射为系统中的有效用户名。

对于给定servlet，该值将被servlet-descriptor中的run-as-principal-name元素替代。

如果给定角色名中没有指定run-as-role-assignment，则Web应用程序容器使用security-role-assignment中定义的第一个principal-name。

以下示例说明如何使用run-as-role-assignment元素。

RunAsRoleName

joe

下表描述可在run-as-role-assignment元素中定义的元素。

元素

必需

可选

描述

必需

指定安全角色的名称。

必需

指定委托人的名称。

reference-descriptorGroup

这个weblogic.xml部署描述符指reference-descriptorGroup，它属于weblogic-j2ee-xsd文件的一部分。

将使用reference-descriptorGroup的以下子元素

元素名

默认值

值

resource-description

resource-description元素用于将服务器资源的JNDI名映射至WebLogicServer中的EJB资源引用。

请参阅resource-description。

resource-env-description

resource-env-description元素将ejb-jar.xml部署描述符中声明的resource-env-ref映射至其代表的服务器资源的JNDI名。

请参阅resource-env-description。

ejb-reference-description

请参阅ejb-reference-description。

service-reference-description

请参阅service-reference-description。

weblogic.xml部署描述符。

resource-description

resource-description元素用于将服务器资源的JNDI名映射至WebLogicServer中的EJB资源引用。

下表描述可在resource-description元素中定义的元素。

元素

必需/

可选

描述

必需

指定资源引用的名称。

必需

指定资源的JNDI名。

.

resource-env-description

resource-env-description元素将ejb-jar.xml部署描述符中声明的resource-env-ref映射至其代表的服务器资源的JNDI名。

下表描述可在resource-env-description元素中定义的元素。

元素

必需/

可选

描述

必需

指定资源环境引用的名称。

必需

指定资源环境引用的JNDI名。

.

ejb-reference-description

下表描述可在ejb-reference-description元素中定义的元素。

元素

必需/

可选

描述

必需

指定Web应用程序中使用的EJB引用的名称。

必需

指定引用的JNDI名。

.

service-reference-description

下表描述可在service-reference-description元素中定义的元素。

元素

必需/

可选

描述

元素具有下列子元素：

▪

▪

元素具有下列子元素：

▪

▪

▪

session-descriptor

session-descriptor元素定义servlet会话的参数。

元素名

默认值

值

timeout-secs

3600

设置WebLogicServer等待会话超时的时间（秒）。

默认值为3600秒。

在繁忙的站点上，可以通过调整会话超时时间来调整应用程序。

尽管您希望为浏览器客户端提供每个完成会话的机会，但如果用户已离开站点或已放弃会话，您也不希望毫无必要地占用服务器。

该元素可以由web.xml中的session-timeout元素（分钟）替代。

invalidation-interval-secs

60

设置WebLogicServer在执行超时会话和无效会话的清理检查与删除旧会话并释放内存之间需要等待的时间（秒）。

使用此元素调整WebLogicServer以在高流量站点上获得最佳性能。

默认值为60秒。

sharing-enabled

false

如果该值在应用程序级别上设置为true，则Web应用程序能够共享HTTP会话。

如果在Web应用程序级别打开该元素，将忽略该元素。

debug-enabled

false

启用HTTP会话的调试功能。

默认值为false。

id-length

52

设置会话ID的大小。

最小值为8字节，最大值为Integer.MAX_VALUE。

如果您正在编写WAP应用程序，您必须使用URL重写，因为WAP协议不支持cookie。

同时，某些WAP设备限制URL的长度（包括特性）不得超过128个字符，这限制了使用URL重写功能可以传输的数据量。

为了给各个特性预留较多空间，可以使用此特性限制WebLogicServer随机生成的会话ID的大小。

还可以通过设置WAPEnabled特性将长度限制为固定的52位字符，且不允许使用特殊字符。

有关详细信息，请参阅“开发WebLogicServer的Web应用程序”中的URL重写和无线访问协议。

tracking-enabled

true

启用HTTP请求之间的会话跟踪。

cache-size

1028

设置JDBC持久性会话和文件持久性会话的缓存大小。

max-in-memory-sessions

-1

设置内存/复制会话的最大限制。

如果不能对内存中servlet会话的使用加以限制，那么，随着新会话的持续创建，服务器最终必然引发内存不足。

为防止出现此问题，WebLogicServer将针对所创建会话的数量提供可配置的限制。

超出该数量时，每次尝试新建会话时都会引发weblogic.servlet.SessionCreationException。

此功能适用于复制内存中会话和非复制内存中会话。

要对内存中servlet会话的使用加以限制，您可以在max-in-memory-sessions元素中设置限制。

默认值为–1（无限制）。

cookies-enabled

true

默认情况下启用会话cookie，建议保持此状态，但也可以通过将该属性设置为false来禁用它们。

您可能会关闭该选项以进行测试。

cookie-name

JSESSIONID

定义会话跟踪cookie名称。

如果没有设置，则默认值为JSESSIONID。

可以将其设置为适用于您的应用程序的更具体的名称。

cookie-path

null

定义会话跟踪cookie路径。

如果未设置此特性，则此特性默认为/（斜杠），浏览器会向WebLogicServer服务的所有URL发送cookie。

可以将该路径设置为限制性更强的映射，以便限制浏览器会向其发送cookie的请求URL。

cookie-domain

null

指定cookie有效的域。

例如，将cookie-domain设置为会向*域中的所有服务器返回cookie。

域名必须至少由两部分组成。

将名称设置为*.com或*.net是无效的。

如果不设置此特性，则此特性默认为发出cookie的服务器。

有关详细信息，请参阅SunMicrosystems的Servlet规范中的Cookie.setDomain（）。

cookie-comment

null

指定标识cookie文件中会话跟踪cookie的注释。

cookie-secure

false

指示浏览器仅通过HTTPS连接传回cookie。

这可以确保cookieID是安全的，且仅用于使用HTTPS的网站。

如果启用此功能，则HTTP上的会话Cookie将不再起作用。

如果希望使用此特性，则应禁用url-rewriting-enabled元素。

cookie-max-age-secs

-1

设置客户端上的会话cookie的生命周期（秒），会话cookie超过该时间即会过期。

默认值为–1（无限制）

有关cookie的详细信息，请参阅使用会话和会话持久性。

persistent-store-type

memory

将持久性存储方法设置为以下某个选项：

▪memory-禁用持久性会话存储。

▪replicated-与memory相同，但会话数据将在群集服务器之间复制。

▪replicated_if_clustered–如果Web应用程序部署于群集服务器上，则会复制生效的persistent-store-type。

否则，memory为默认值。

▪sync-replication-across-cluster–复制将在群集内同步发生。

▪async-replication-across-cluster–复制将在群集内异步发生。

▪file-使用基于文件的持久性（另请参阅persistent-store-dir）。

▪jdbc-使用数据库存储持久性会话。

（另请参阅persistent-store-pool。

）

▪cookie–所有会话数据都存储于用户浏览器的cookie中。

persistent-store-cookie-name

WLCOOKIE

设置基于cookie的持久性所使用的cookie的名称。

WLCOOKIEcookie中带有会话状态，不应在Web应用程序之间共享。

有关详细信息，请参阅使用基于Cookie的会话持久性。

persistent-store-dir

session_db

指定基于文件的持久性所使用的存储目录

确保您有充足的磁盘存储空间（有效会话数与每个会话大小的乘积）。

可以通过查看persistent-store-dir下创建的文件来确定会话的大小。

注意，每个会话的大小随序列化会话数据的大小变化而变化。

每个服务器实例都有一个默认的不需要配置的持久性文件存储。

因此，如果不指定目录，会在\data\store\default目录中自动创建默认存储。

但是，默认存储不能在群集服务器间共享。

可以在不同服务器之间共享的目录中创建自定义持久性存储，从而使文件持久性会话群集化。

但是，您需要手工创建此目录。

persistent-store-pool

None

指定要用于持久性存储的JDBC连接缓冲池的名称。

persistent-store-table

wl_servlet_sessions

指定用于存储基于JDBC的持久性会话的数据库表名。

仅当persistent-store-type设置为jdbc时，此项才适用。

当您选择数据库表名称而非默认值时，将使用persistent-store-table元素。

jdbc-column-name-max-inactive-interval

是wl_max_inactive_interval列名的备用名称。

这个jdbc-column-name-max-inactive-interval元素仅适用于基于JDBC的持久性。

某些不支持长列名的数据库需要使用该元素。

jdbc-connection-timeout-secs

120

注意：

本版本中不赞成使用该元素。

设置WebLogicServer等待JDBC连接超时的时间（秒），其中x是其间的秒数。

url-rewriting-enabled

true

启用URL重写（将会话ID编码到URL中），如果浏览器中禁用cookie，它还可以提供会话跟踪。

http-proxy-caching-of-cookies

true

设置为false时，WebLogicServer会在下面的响应中添加如下头信息：

"Cache-control:

no-cache=set-cookie"

这表示代理缓存没有缓存cookie。

encode-session-id-in-query-params

false

最新servlet规范要求容器将会话ID编码在路径参数中。

某些Web服务器不太支持路径参数。

在这样的情况下，应该将encode-session-id-in-query-params元素设置为true。

（默认值为false。

）

runtime-main-attribute

用于ServletSessionRuntimeMBean中。

ServletSessionRuntimeMBean的getMainAttribute（）会使用该字符串为关键字而返回会话特性值。

示例：

user-name

该元素适用于标记不同会话的会话运行时信息。

jsp-descriptor

jsp-descriptor元素指定JSP编译器的配置参数列表。

下表描述可在jsp-descriptor元素中定义的元素。

元素

必需/

可选

描述

page-check-seconds

1

设置WebLogicServer检查JSP文件的时间间隔（秒），以便查看JSP文件是否已更改以及是否需要重新编译。

如果已发生更改，还会检查依赖关系并递归重新加载。

▪值-1表示永不检查页面。

该值为生产环境中的默认值。

▪值0表示总是检查页面。

▪值1表示每秒检查一次页面。

该值为开发环境中的默认值。

在生产环境下，很少发生JSP更改，可考虑根据您的调整要求将pageCheckSeconds的值更改为60或更大。

precompile

false

如果设置为true，当部署或重新部署Web应用程序时，或启动WebLogicServer时，WebLogicServer会自动预编译所有已修改的JSP。

precompile-continue

false

如果设置为true，即使编译期间其中某些JSP