security-role-mapping
在当前活动领域将角色映射到用户或组。关于如何定义当前活动领域，请参考Sun Java System应用服务器开发者指南。
子元素
下面的表格描述了security-role-mapping元素的子元素。左边一列列出了子元素的名称，中间一列指定了所需的规则，右边一列描述了其功能。
|
security-role-mapping 子元素
元素名
|
所需规则
|
说明
|
|
role-name
|
仅为1
|
含有角色名
|
|
principal-name
|
需要至少一个主要名称或组名
|
含有当前领域内主要的（用户）名称
|
|
group-name
|
需要至少一个主要名称或组名
|
含有当前领域中一个组的名称
|
属性
空
servlet
为某个servlet指定主名，该主名用于在web-xml中定义运行角色。
子元素
下面的表格描述了servlet元素的子元素。左边一列列出了子元素的名称，中间一列指定了所需规则，右边一列说明了元素的功能。
|
Servlet子元素
元素名
|
所需规则
|
说明
|
|
servlet-name
|
仅一个
|
包含servlet的名称，该名称用于匹配web.xml文件中的servlet-name。
|
|
principal-name
|
仅一个
|
包含当前领域中主要的（用户）名称。
|
属性
空
Servlet-name
包含指定servlet名称的数据，用于匹配web.xml文件中的servlet-name。该名字必须在web.xml文件中存在。
子元素
空
属性
空
Role-name
包含指定web.xml文件中security-role元素的role-name的数据。
子元素
空
属性
空
Principal-name
包含指定当前领域内某个主要的（用户）名称的数据。
子元素
空
属性
空
Group-name
包含指定当前领域内组名称的数据。
子元素
空
属性
空
会话元素
会话元素如下所示：
|
注意
|
会话Administration界面是不稳定的。不稳定的接口可能是试验性或过渡性的，因此可能会产生不兼容的变化、被去除或在下一发布版本中被其它更稳定的接口替代。
|
session-config
指定会话的配置信息。
子元素
下面的表格描述了session-config元素的子元素。左边一列列出了子元素的名称，中间一列指定了所需的规则，右边一列说明了它的功能。
|
session-config子元素
元素名
|
所需规则
|
说明
|
|
session-manager
|
零个或一个
|
指定会话管理程序的配置信息。
|
|
session-properties
|
零个或一个
|
指定会话的属性
|
|
cookie-properties
|
零个或一个
|
指定会话的cookie属性
|
属性
空
Session-manager
指定会话管理信息。
子元素
下面的表格描述了session-manager元素的子元素。左边一列列出了子元素的名称，中间一列指定所需规则，而右边一列说明了它的功能。
|
session-manager子元素
元素名
|
所需规则
|
说明
|
|
manager-properties
|
零或一个
|
指定会话管理的属性
|
|
store-properties
|
零或一个
|
指定会话持续性（存储）性质
|
属性
下面的表格描述了session-manager元素的属性。左边一列列出了属性名称，中间一列指定了默认值，右边一列说明了它的功能。
|
session-manager属性
属性名
|
默认值
|
说明
|
|
persistence-type
|
memory
|
（可选）指定会话持续性机制。值可以为memory和file。不能自定义值，也不能使用子定义值。
|
Manager-properties
指定会话管理程序的属性
子元素
下面的表格描述了manager-properties元素的子元素。左边一列列出了子元素名称，中间一列指定了所需的规则，右边一列说明了它的功能。
|
manager-properties子元素
元素名
|
所需规则
|
说明
|
|
property
|
零或多个
|
指定一个属性，它由名称和值构成。
|
属性
下面的表格描述了manager-properties元素的属性。左边一列列出了属性名称，中间一列指定了默认值，右边一列说明了属性的功能。
|
manager-properties 属性
属性名称
|
默认值
|
说明
|
|
reapIntervalSeconds
|
60
|
指定会话两次过期检查间隔的秒数。
推荐将它的值设置成低于会话数据改变的频率。例如，对于访问计数servlet，该值应该尽可能与访问网站的频率一样，否则每次重新启动服务器时可能会丢失最后一些计数。
|
|
maxSessions
|
-1
|
指定活动会话的最大数量，-1（默认）表示没有限制。
|
|
sessionFilename
|
none； 重新启动时状态不保存
|
如果可以保存状态，指定应用两次重新启动时用于保存状态的文件的绝对或相对路径。相对路径是相对于web组件的临时目录。
仅当session-manager元素的persistence-type属性为memory时可用。
|
Stroe-properties
指定会话保持（存储）性质。
子元素
下面的表格描述了stroe-properties元素的子元素。左边一列列出了子元素名称，中间一列指定所需规则，右边一列说明其功能。
|
store-properties子元素
元素名称
|
所需规则
|
说明
|
|
property
|
零或多个
|
指定一个属性，由名字和值构成。
|
属性
空
性质
下面的表格描述了store-properties元素的性质。左边一列列出了性质名，中间一列指明默认值，右边一列说明了属性的功能。
|
store-properties性质
属性名称
|
默认值
|
说明
|
|
reapIntervalSeconds
|
60
|
对于现在被换出的那些会话，指定两次过期检查的时间间隔的秒数。
推荐将该值设置成比会话数据改变的频率低的值。例如，对于访问计数servlet，该值应该尽可能与访问网站的频率一样，否则每次重新启动服务器时可能会丢失最后一些计数。
|
|
directory
|
由javax.servlet.context.tempdir背景属性指定的目录
|
指定各个会话文件写入的目录的绝对或相对路径。相对路径是相对于该web组件的临时工作目录。
|
Session-properties
指定会话属性。
子元素
下面的表格描述了session-properties元素的子元素。左边一列列出了子元素的名字，中间一列指定所需规则，右边一列描述了其功能。
|
session-properties子元素
元素名
|
所需规则
|
说明
|
|
property
|
零或多个
|
指定属性，包含属性名称和值。
|
属性
空
性质
下面的表格指定了session-properties元素的性质。左边一列列出了性质的名称，中间一列指定默认值，而右边一列对其功能作了说明。
|
session-properties 性质
性质名
|
默认值
|
说明
|
|
timeoutSeconds
|
600
|
指定在web组件中生成的所有会话默认的最大非活动间隔（秒的形式）。如果设置成0或小于0，在web组件中的会话不会过期。
如果在web.xml文件中session-timeout元素被指定，那么session-timeout值将忽略timeoutSeconds值。如果session-timeout和timeoutSeconds都没有指定，那么将使用timeoutSeconds的默认值。
注意，在web.xml中指定的session-timeout元素是分钟的形式，不是秒的形式。
|
|
enableCookies
|
true
|
如果设置成true，将使用cookies来跟踪会话。
|
|
enableURLRewriting
|
true
|
将URL重写设置成可以。这样当浏览器不接受cookie时可以根据URL重写来跟踪会话。在servlet或jsp中也可以使用encodeURL或encodeRedirectURL调用。
|
|
idLengthBytes
|
128
|
指定web组件的会话ID的字节数。
|
cookie-properties
指定会话cookie属性。
子元素
下面的表格描述了cookie-properties元素的子元素。左边一列列出了子元素的名字，中间一列指定所需的规则，右边一列对元素的功能的说明。
|
cookie-properties子元素
元素名
|
所需规则
|
说明
|
|
property
|
零个或多个
|
指定属性，由名称和值构成
|
属性
下面的表格描述了cookie-properties元素的属性。左边一列列出了属性的名称，中间是默认值，右边的一列说明了该属性的功能。
|
cookie-properties属性
属性名称
|
默认值
|
说明
|
|
cookieName
|
JSESSIONID
|
指定用于会话跟踪的cookie的名称
|
|
cookiePath
|
背景路径，web组件就安装在该路径中
|
指定当产生cookie时设置pathname。如果请求的pathname中包含该pathname，那么浏览器发送cookie。如果设置成/(斜杠)，浏览器将cookie发送到由Sun Java System应用服务器服务的所有URL。可以将路径设置成较窄的映射来限制浏览器发送cookies的请求URL。
|
|
cookieMaxAgeSeconds
|
-1
|
指定过期时间（秒为单位），过了该时间浏览器将使cookie过期。
|
|
cookieDomain
|
(未装配)
|
指定cookie有效的域。
|
|
cookieComment
|
Sun
ONE应用服务器会话跟踪cookie
|
指定注释来标识cookie文件中的会话跟踪cookie。应用程序可以为cookie提供更具体的注释。
|
上一部分 | 目录
| 下一部分
