HTTP 会话数据库 (httpSessionDatabase)
控制将 HTTP 会话持久存储到数据库的方式。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| dataSourceRef | string | 会话管理器应该用来持久存储 HTTP 会话数据的数据源的标识。 | |
| db2RowSize |
|
4KB | 为会话表配置的表空间页大小(如果正在使用 DB2 数据库)。增大此值可以改进某些环境中的数据库性能。
|
| noAffinitySwitchBack | 布尔型 | False | 即使在原始成员恢复正常之后,也将此属性设置为“true”以维护与新成员的亲缘关系。当集群成员失败时,其请求路由到不同的集群成员,且会话将在那个成员中激活。因而,维护到新成员的会话亲缘关系并当备份集群成员失败时,那些对原始集群成员中创建的会话的请求将路由回给它。所允许的值为 true 或 false,缺省值为 false。如果已将分布式会话配置成使用基于时间的写功能,请将此属性设为 true。请注意,如果未启用分布式会话,那么此属性对行为没有任何影响。 |
| onlyCheckInCacheDuringPreInvoke | 布尔型 | False | 如果值为 true,那么指示仅当请求获取会话时,才应该更新该会话的上次访问时间。如果值为 false,那么指示每次请求时,都应该更新会话的上次访问时间。更改此值可以改进某些环境中的性能。 |
| optimizeCacheIdIncrements | 布尔型 | true | 如果用户的浏览器会话正在多个 Web 应用程序之间往返移动,那么由于会从持久性存储刷新 Web 模块的内存内会话,您可能会看到额外的持久性存储活动。因此,高速缓存标识不断增长,且内存会话属性由这些持久副本的属性覆盖。如果您想要阻止高速缓存标识不断增大,请将此属性设为 true。如果值为 true,那么指示会话管理器应该评估 Web 模块的内存内会话是否比持久性存储中副本的会话旧。如果配置是集群,请确保每个集群成员的系统时间尽可能相同。 |
| scheduleInvalidation | 布尔型 | False | 启用此选项,以减少使 HTTP 会话保持活动状态所需的数据库更新数。请指定一天内应用程序服务器中的活动最少的那两个小时。禁用此选项时,失效器进程会每隔几分钟运行一次,以移除失效的 HTTP 会话。 |
| scheduleInvalidationFirstHour | 整型 | 0 | 指示其间会从持久性存储中清除失效会话的第一个小时。请将此值指定为 0 与 23 之间的任意整数。仅当启用了调度失效时,此值才有效。 |
| scheduleInvalidationSecondHour | 整型 | 0 | 指示其间会从持久性存储中清除失效会话的第二个小时。请将此值指定为 0 与 23 之间的任意整数。仅当启用了调度失效时,此值才有效。 |
| skipIndexCreation | 布尔型 | False | 将此属性设置为“true”以禁止在服务器启动时创建索引。仅当您要手动创建自己的数据库索引以实现会话持久性时,才应该使用此定制属性。但是,建议您让会话管理器创建数据库索引。启用此属性之前,请确保会话数据库上确实存在正确的索引。 |
| tableName | string | sessions | 数据库表名。 |
| tableSpaceName | string | 要用于会话表的表空间。仅当 DB2 行大小超过 4KB 时,才需要此值。 | |
| useInvalidatedId | 布尔型 | true | 将此属性设置为“true”,以复用入局标识(如果最近已使具有该标识的会话失效)。因为这会阻止检查持久性存储,所以这是对性能的优化。 |
| useMultiRowSchema | 布尔型 | False | 启用时,会将每个会话数据属性置于数据库中的单独一行上,从而允许为每个会话存储更大量的数据。如果会话属性非常大,而且基本不需要更改,那么此配置可以产生较好的性能。禁用时,对于每个会话,会将所有会话数据属性都置于同一行中。 |
| useOracleBlob | 布尔型 | False | 将此属性设置为“true”,以使用介质列的二进制大对象 (BLOB) 数据类型创建数据库表。使用 Oracle 数据库时,此值会提高持久会话的性能。由于 Oracle 限制,如果数据超过 4000 字节,那么 BLOB 支持会要求使用 Oracle 调用接口 (OCI) 数据库驱动程序。您也必须确保通过执行以下操作重新启动服务器前已创建了一个新的会话表:删除旧的会话表或将数据源定义更改为引用不包含会话表的数据库。 |
| usingCustomSchemaName | 布尔型 | False | 如果您要将 DB2 用于会话持久性并且在数据源中设置 currentSchema 属性,请将此属性设置为“true”。 |
| writeContents |
|
ONLY_UPDATED_ATTRIBUTES | 指定应该写入持久性存储的会话数据量。缺省情况下,仅写入已更新的属性,但是可改为写入全部属性(无论它们是否已更改)。
|
| writeFrequency |
|
END_OF_SERVLET_SERVICE | 指定将会话数据写入持久性存储的时间。缺省情况下,会在 servlet 完成执行之后将会话数据写入持久性存储。更改此值可以改进某些环境中的性能。
|
| writeInterval | 精度为秒的时间段 | 2m | 将会话数据写入持久性存储之前应该经过的秒数。缺省值为 120 秒。仅当启用基于时间的写频率时,才会使用此值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
参考主题