HTTP 会话 (httpSession)
HTTP 会话管理的配置。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| allowOverflow | 布尔型 | true | 允许内存中的会话数超过“内存内最大会话数”属性的值。 |
| alwaysEncodeUrl | 布尔型 | False | Servlet 2.5 规范指定只有在必要时才对 response.encodeURL 调用上的 URL 进行编码。要在启用 URL 编码的情况下支持向后兼容性,请将此属性设为 true 以调用 encodeURL 方法。即使浏览器支持 cookie,也总是对 URL 进行编码。 |
| cloneId | string | 集群成员的克隆标识。在集群内,此标识必须唯一,以维护会话亲缘关系。设置时,此名称会覆盖由服务器生成的缺省名称。 | |
| cloneSeparator | string | : | 在会话 Cookie 中用来将会话标识与克隆标识相分离的单个字符。通常应该使用缺省值。在一些无线应用协议 (WAP) 设备上,不允许使用冒号 (:),因此应该改用加号 (+)。很少使用不同值。在使用此属性来更改克隆分隔符之前,应该了解系统上运行的其他产品的克隆字符要求。可以将任何字符指定为此属性的值这一事实并不意味着您指定的字符将正常工作。这也不表示 IBM 有责任修正使用备用字符时可能产生的任何问题。 |
| cookieDomain | string | 会话跟踪 Cookie 的域字段。 | |
| cookieHttpOnly | 布尔型 | true | 指定会话 Cookie 包含 HttpOnly 字段。支持 HttpOnly 字段的浏览器不支持客户机端脚本访问 cookie。使用 HttpOnly 字段将有助于防止跨站点脚本编制攻击。 |
| cookieMaxAge | 精度为秒的时间段 | -1 | Cookie 可在客户机浏览器上驻留的最大时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
| cookieName | string | JSESSIONID | 会话管理 Cookie 的唯一名称。 |
| cookiePath | string | / | 会将 Cookie 发送到路径中指定的 URL。 |
| cookieSecure | 布尔型 | False | 指定会话 Cookie 要包含安全字段。 |
| cookiesEnabled | 布尔型 | true | 指定会话跟踪使用 Cookie 传送会话标识。 |
| debugCrossover | 布尔型 | False | 启用此选项以执行附加检查来验证,是否仅访问或引用与请求相关联的会话,并在检测到任何差异的情况下记录消息。禁用此选项以跳过附加检查。 |
| forceInvalidationMultiple | 整型 | 3 | 如果您的请求通常不受限于响应时间限制,请指定 0 来指示在尝试使会话失效之前,会话管理器应该无限期地等待直到请求完成。否则,请将此属性设为正整数,以延迟使活动会话失效的操作。到第一个失效时间间隔过去为止,将不使已超时的活动会话失效,但是到基于此值的时间间隔过去为止,将使其失效。例如,值为 2 时,将在会话超时到期之后第二个失效时间间隔过去时使活动会话失效。 |
| idLength | 整型 | 23 | 会话标识的长度。 |
| idReuse | 布尔型 | False | 在没有针对会话持久性进行配置的多 JVM 环境中,如果将此属性设置为“true”,那么会使会话管理器能够将同一会话信息用于用户的所有请求(即使处理这些请求的 Web 应用程序由不同 JVM 控制)。此属性的缺省值为 false。如果您想要使会话管理器能够使用从浏览器发送的会话标识,跨 Web 应用程序(在没有针对会话持久性配置的环境中运行)保存会话数据,请将此属性设为 true。 |
| invalidateOnUnauthorizedSessionRequestException | 布尔型 | False | 如果您想要会话管理器使会话失效(而不是发出 UnauthorizedSessionRequestException),以对未经授权的请求作出响应,请将此属性设为 true。如果会话失效,那么请求者可以创建新会话,但无权访问先前保存的任何会话数据。这允许单用户在注销后继续处理对其他应用程序的请求,但仍然保护会话数据。 |
| invalidationTimeout | 精度为秒的时间段 | 30m | 在会话不再有效之前可处于未使用状态的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
| maxInMemorySessionCount | 整型 | 1000 | 在内存中为每个 Web 模块保留的最大会话数。 |
| noAdditionalInfo | 布尔型 | False | 强制移除会话标识中不需要的信息。 |
| protocolSwitchRewritingEnabled | 布尔型 | False | 当 URL 需要从 HTTP 切换至 HTTPS 或从 HTTPS 切换至 HTTP 时,将会话标识添加到该 URL。 |
| reaperPollInterval | 精度为秒的时间段 | -1 | 进程(用于移除无效会话)的唤醒时间间隔,以秒计。最小值为 30 秒。如果输入了小于最小值的值,那么会自动确定并使用相应的值。此值会覆盖介于 30 秒和 360 秒之间的缺省安装值(基于会话超时值)。因为缺省会话超时为 30 分钟,所以收割程序时间间隔通常介于 2 分钟和 3 分钟之间。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
| rewriteId | string | jsessionid | 使用此属性来更改配合 URL 重写功能使用的密钥。 |
| securityIntegrationEnabled | 布尔型 | true | 启用安全性集成,这会促使会话管理工具将用户的身份与他们的 HTTP 会话相关联。 |
| securityUserIgnoreCase | 布尔型 | False | 指示应该将会话安全身份和客户机安全身份视为匹配(即使它们的大小写不同)。例如,将此属性设置为 true 时,会话安全性身份 USER1 与客户机安全性身份 User1 和 user1 匹配。 |
| sslTrackingEnabled | 布尔型 | False | 指定会话跟踪使用安全套接字层 (SSL) 信息作为会话标识。 |
| urlRewritingEnabled | 布尔型 | False | 指定会话管理工具使用重写的 URL 来传送会话标识。 |
| useContextRootAsCookiePath | 布尔型 | False | 指定 Cookie 路径相当于 Web 模块的上下文根(而不是 /) |
参考主题