Servlet 上下文初始化参数

Parameters

applicationQualifiedCookies

这是一个字符串值：true 或 false。 如果您的环境包含使用唯一的 cookie 名称的多个应用程序，请将此参数设置为 true。缺省值为 false，这假设所有应用程序都使用相同的 cookie 名称。

authenticationRetryCount

指定当凭证到期时认证的重试计数。如果将该值设置为 0，那么将不重试任何认证。

catalogHostPort

获取客户端 ObjectGrid 实例时可联系的目录服务器。该值的格式必须是 host:port<,host:port>。 主机是用于运行目录服务器的侦听器主机。 端口是该目录服务器进程的侦听器端口。此列表可为任意长度且仅用于引导过程。将使用第一个可行地址。如果配置了 catalog.services.cluster 属性，那么此参数在 WebSphere® Application Server 内是可选参数。

credentialAuthentication

指定客户机凭证认证支持。可能的值为：

• Never - 客户机不支持凭证认证。
• Supported - 当且仅当服务器也支持凭证认证时，客户机才支持凭证认证。
• Required - 客户机需要凭证认证。 缺省值为 Supported。

cookieDomain

指定是否要求会话在主机间可供访问。将此值设置为主机间的公共域的名称。

cookiePath

指定实现 com.ibm.websphere.objectgrid.security.plugins.CredentialGenerator 接口的类的名称。 此类用于获取客户机的凭证。

credentialGeneratorClass

类的名称，该类用于实现 com.ibm.websphere.objectgrid.security.plugins.CredentialGenerator 接口。此类用于获取客户机的凭证。

credentialGeneratorProps

CredentialGenerator 实现类的属性。这些属性设置为带有 setProperties(String) 方法的对象。仅当 credentialGeneratorClass 属性的值不为空时，才使用 credentialGeneratorProps 值。

enableSessionStats

这是一个字符串值：true 或 false。 启用 eXtreme Scale 客户机 HTTP 会话统计信息跟踪。

fragmentedSession

这是一个字符串值：true 或 false。 缺省值为 true。可使用此设置来控制产品是将会话数据存储为一整个条目还是分别存储每个属性。

如果 Web 应用程序会话有多个属性或其属性的大小很大，请将 fragmentedSession 参数设置为 true。当会话的属性很少时，请将 fragmentedSession 设置为 false，因为所有属性都将存储在数据网格内的同一个键中。

在先前的基于过滤器的实现中，此属性又被称为 persistenceMechanism，可能值为 ObjectGridStore（已分段）和 ObjectGridAtomicSessionStore（未分段）。

objectGridType

这是一个字符串值：REMOTE 或 EMBEDDED。 缺省值为 REMOTE。

如果将此参数设置为 REMOTE，那么会话数据将存储在运行 Web 应用程序的服务器外部。

如果将此参数设置为 EMBEDDED，那么嵌入式 eXtreme Scale 容器将在运行 Web 应用程序的应用程序服务器进程中启动。

objectGridName

一个字符串值，用于定义将用于特定 Web 应用程序的 ObjectGrid 实例的名称。缺省名称为 session。

此属性必须在用于启动 eXtreme Scale 容器服务器的 ObjectGrid XML 和部署 XML 文件中反映 objectGridName。

objectGridXML

objectgrid.xml 文件的文件位置。如果 objectGridType=EMBEDDED 并且未指定 objectGridXML 属性，那么系统将自动装入打包在 eXtreme Scale 库中的内置 XML 文件。

objectGridDeploymentXML

指定 objectGrid 部署策略 XML 文件的位置。如果 objectGridType=EMBEDDED 并且未指定 objectGridDeploymentXML 属性，那么系统将自动装入打包在 eXtreme Scale 库中的内置 XML 文件。

replicationInterval

一个整数值（以秒计），用于定义将已更新会话写至 ObjectGrid 的时间间隔。缺省值为 10 秒。可能的值为从 0 到 60。0 意味着已更新会话在对每个请求的 servlet 服务方法调用结束时写至 ObjectGrid。较高的 replicationInterval 值将提高性能，因为写至数据网格的更新变少。但是，提高该值将导致配置容错性降低。

仅当 objectGridType 设置为 REMOTE 时，才应用此设置。

reuseSessionID

这是一个字符串值：true 或 false。 缺省值为 false。如果底层 Web 容器在针对不同主机的请求间复用会话标识，请将此参数设置为 true。此属性的值必须与 Web 容器中的值相同。如果您正在使用 WebSphere Application Server 并使用管理控制台或 wsadmin 工具脚本编制来配置 eXtreme Scale HTTP 会话持久性，那么缺省情况下，将添加 Web 容器定制属性 HttpSessionIdReuse=true。reuseSessionID 也会设置为 true。 如果您不想复用会话标识，请先在 Web 容器定制属性上设置 HttpSessionIdReuse=false 定制属性，再配置 eXtreme Scale 会话持久性。

sessionIdOverrideClass

这是类的名称，该类用于实现 com.ibm.websphere.xs.sessionmanager.SessionIDOverride 接口。此类用于覆盖通过 HttpSession.getId() 方法检索到的唯一会话标识，以便所有应用程序都具有相同标识。缺省值是使用从 HttpSession.getId() 派生的用户标识。

sessionStatsSpec = session.all = enabled

这是一个 eXtreme Scale 客户机 HTTP 统计信息规范的字符串。

shareSessionsAcrossWebApps

这是一个字符串值：true 或 false。 缺省值为 false。 指定是否在 Web 应用程序间共享会话，此项被指定为字符串值 true 或 false。servlet 规范声明不能在 Web 应用程序间共享 HTTP 会话。系统提供了此 servlet 规范的扩展以允许此共享。

sessionTableSize

一个整数值，用于定义内存中保存的会话引用数。缺省值为 1000。

此设置仅与 REMOTE 拓扑相关，因为 EMBEDDED 拓扑的会话数据在 Web 容器所在的层。

系统会根据最近最少使用 (LRU) 逻辑从内存中的表逐出会话。从内存中的表逐出会话时，该会话在 Web 容器中失效。但是，数据不会从网格中除去，所以针对该会话的后续请求仍可检索该数据。必须将此值设置为高于 Web 容器最大线程池值，这样可降低针对会话高速缓存的争用。

securityEnabled

这是一个字符串值：true 或 false。 缺省值为 False。此设置启用 eXtreme Scale 客户机安全性。此设置必须与 eXtreme Scale 服务器属性文件中的 securityEnabled 设置匹配。如果设置不匹配，那么会发生异常。

sessionIdOverrideClass

覆盖检索到的应用程序的会话标识。缺省值是使用从 HttpSession.getId() 方法派生的标识。允许 eXtreme Scale 客户机 HTTP 会话覆盖应用程序的唯一会话标识，以便使用相同标识来检索所有应用程序。设置为 com.ibm.websphere.xs.sessionmanager.SessionIDOverride 接口的实现。 此接口会根据 HttpServletRequest 对象来确定 HttpSession 标识。

traceSpec

指定 IBM® WebSphere 跟踪规范作为字符串值。对 WebSphere Application Server 以外的应用程序服务器使用此设置。

traceFile

指定跟踪文件位置作为字符串值。对 WebSphere Application Server 以外的应用程序服务器使用此设置。

useURLEncoding

这是一个字符串值：true 或 false。 缺省值为 false。 如果要启用 URL 重写，请将此参数设置为 true。缺省值为 false，这指示将 cookie 用于存储会话数据。此参数的值必须与会话管理的 Web 容器设置相同。

useCookies

这是一个字符串值：true 或 false。 如果底层 Web 容器在针对不同主机的请求间将复用会话标识，请将此参数设置为 true。缺省值为 false。 此参数的值必须与 Web 容器中设置的值相同。