Resource-env-ref
在相应的J2EE web.xml文件的resource-env-ref表目中将res-ref-name映射到资源的绝对jndi-name。
子元素
下面的表格描述了resource-env-ref元素的子元素。左边一列列出了子元素的名字，中间一列指定了所需的规则，右边一列描述了元素的功能。
|
resource-env-ref子元素
元素
|
所需规则
|
说明
|
|
resource-env-ref-name
|
only one
|
在相应的J2EE web.xml文件的resource-env-ref表目中指定res-ref-name。
|
|
jndi-name
|
only one
|
指定资源的绝对jndi-name。
|
属性
空
Resource-env-ref-name
包含数据用来指定相应的J2EE web.xml文件的resource-env-ref表目中指定res-ref-name。
Attributes
none
子元素
空
属性
空
Resource-ref
在相应的J2EE web.xml文件的resource-env-ref表目中将res-ref-name映射到资源的绝对jndi-name。
子元素
下面的表格描述了resource-ref元素的子元素。左边一列列出了子元素的名字，中间一列指定所需的规则，右边一列描述了相应的功能。
|
resource-ref子元素
元素名
|
所需规则
|
说明
|
|
res-ref-name
|
only one
|
在相应的J2EE web.xml文件的resource-env-ref表目中指定res-ref-name。
|
|
jndi-name
|
only one
|
指定资源的绝对jndi-name。
|
|
default-resource-principal
|
zero or one
|
指定资源的默认主要（用户）。
|
属性
空
Res-ref-name
包含数据用来指定相应的J2EE web.xml文件的resource-env-ref表目中指定res-ref-name。
子元素
空
属性
空
Default-resource-principal
指定资源的默认主体（用户）。
如果该元素和JMS连接企业资源一起使用，那么资元素的名称和密码必须是Sun Java System消息队列的代理程序用户存储库中有效的表目。详细信息请参考Sun Java System消息对列管理员指南中“安全管理”章节。
子元素
下面的表格描述了default-resource-principal元素的子元素。左边一列列出了资元素的名字，中间一列指定所需的规则，右边一列描述了元素的功能。
|
default-resource-principal 子元素
元素名
|
所需规则
|
说明
|
|
name
|
只能为1
|
包含主体的名字。
|
|
password
|
只能为1
|
包含主体的密码
|
属性
空
name
包含数据指定主体的名字
子元素
空
属性
空
Password
包含数据指定主体的密码
子元素
空
属性
空
Ejb-ref
将相应的J2EE ejb-jar.xml文件的ejb-ref表目映射到ejb-ref-name。
子元素
下面的表格描述了ejb-ref元素的子元素。左边一列列出了子元素的名字，中间一列指定所需的规则，右边一列描述了相应的功能。
|
ejb-ref子元素
元素名
|
所需规则
|
说明
|
|
ejb-ref-name
|
仅为1
|
在相应的J2EE ejb-jar.xml文件的ejb-ref表目中指定ejb-ref-name。
|
|
jndi-name
|
仅为1
|
指定资源的绝对jndi-name。
|
属性
空
Ejb-ref-name
包含数据用来在相应的J2EE ejb-jar.xml文件的ejb-ref表目中指定ejb-ref-name。
子元素
空
属性
空
Jndi-name
包含数据用来指定server.xml文件中URL资源或某个资源的绝对jndi-name。
|
注意
|
为了避免与JNDI中其它企业资源的名字冲突，也为了避免可移植性问题，在Sun Java System应用服务器应用中所有名字都以字符串java:comp/env开头。
|
子元素
空
属性
空
高速缓存元素
由于响应高速缓存属于servlets，故它的详细信息请参考"Caching
Servlet Results"。关于JSP高速缓存的详细信息参考"JSP
Caching"。高速缓存元素包括如下一些：
Cache
为web应用程序组件配置高速缓存。
子元素
下面的表格对cache元素的子元素作了说明。左边一列列出了子元素的名称，中间一列指明了所需规则，而右边一列对元素的功能作了描述。
|
Cache子元素
元素名
|
所需规则
|
说明
|
|
cache-helper
|
零或多个
|
指定一个自定义类来执行CacheHelper接口。
|
|
default-helper
|
零或一个
|
允许修改默认的内置 cache-helper类的属性。
|
|
property
|
零或多个
|
指定一个高速缓存的属性，由名字和值构成。
|
|
cache-mapping
|
零或多个
|
将某个URL模式或Servlet名字映射到高速缓存约束。
|
属性
下面的表格描述了Cache元素的属性。左边一列列出了属性名，中间一列指定默认值，右边一列对属性作了说明。
|
Cache属性
属性名
|
默认值
|
说明
|
|
max-entries
|
4096
|
（可选）指定Cache可以容纳的表目的最大数量。必须是一个正整数。
|
|
timeout-in-seconds
|
30
|
（可选）指定一个表目从生成或刷新起保存在高速缓存中的最大秒数。可以被 timeout元素替换。
|
|
enabled
|
false
|
（可选）确定servlet和jsp高速缓存是否可行。合法值有 on, off, yes, no, 1, 0, true, false。
|
属性
下面的表格对cache元素的性质作了说明。左边一列列出了性质名称，中间一列指定了默认值，右边一列对性质作了说明。
|
Cache性质
性质
|
默认值
|
说明
|
|
cacheClassName
|
com.sun.appserv.web.cache.LruCache
|
为实现cache功能的类指定全限定名。下面的"cacheClassName值”表列出了可能的值。
|
|
MultiLRUSegmentSize
|
4096
|
指定一段高速缓存表中表目的数量，该高速缓存表有自己的LRU（最近最少使用）列表。只有当cacheClassName被设置成 com.sun.appserv.web.cache.MultiLruCache时才有效。
|
|
MaxSize
|
unlimited; Long.MAX_VALUE
|
以字节的形式（KB或MB）指定高速缓存内存大小的上限。例如值为32KB或2MB。仅当cacheClassName被设置成com.sun.appserv.web.cache.BoundedMultiLruCache时才有效。
|
高速缓存类名称
下面的表格列出了cacheClassName属性的可能取值。左边一列列出了值，右边一列对该值指定的高速缓存作了说明。
|
CacheClassName值
值
|
说明
|
|
com.sun.appserv.web.cache.LruCache
|
使用LRU（最近最少使用）高速缓存值换策略的定界高速缓存。
|
|
com.sun.appserv.web.cache.BaseCache
|
当表目的最大数量未知时适用的未定界高速缓存。
|
|
com.sun.appserv.web.cache.MultiLruCache
|
适用于表目数量较大（>4096）的高速缓存。使用MultiLRUSegmentSize。
|
|
com.sun.appserv.web.cache.BoundedMultiLruCache
|
适用于大小受内存限制而不是受表目数量限制的高速缓存。使用属性MaxSize。
|
cache-helper
指定一个实现CacheHelper接口的类。详细信息参考"CacheHelper Interface".（网页地址：http://docs.sun.com/source/816-7150-10/dwservlt.html#29239）。
子元素
下面的表格描述了cache-helper元素的子元素。左边一列列出了子元素名，中间一列指定了所需的规则，右边一列对元素进行了说明。
|
cache-helper子元素
元素名
|
所需规则
|
说明
|
|
property
|
零或多个
|
指定属性，该属性由属性名和值构成。
|
属性
下面的表格描述了cache-helper元素的属性。左边一列列出了属性的名称，中间一列指定了默认值，右边一列对属性作了说明。
|
cache-helper 属性
属性名
|
默认值
|
说明
|
|
name
|
default
|
为helper类指定唯一的名字，它将在cache-mapping元素中被引用。
|
|
class-name
|
none
|
指定cache
helper的完全限制名，它必须实现了com.sun.appserv.web.CacheHelper接口。
|
default-helper
允许改变内置的默认的cache-helper类的属性。
子元素
下面的表格描述了default-helper元素的子元素。左边一列列出了子元素的名称，中间一列指定了所需的规则，右边一列对元素的功能作了说明。
|
default-helper子元素
元素名
|
所需规则
|
说明
|
|
property
|
零或多个
|
指定一个属性，由名称和值构成。
|
属性
空
性质
下面的表格描述了default-helper元素的性质。左边一列列出了性质名，中间一列指定了默认值，右边一列对性质作了说明。
|
default-helper性质
性质名
|
默认值
|
说明
|
|
cacheKeyGeneratorAttrName
|
使用内置的默认cache-helper关键字生成，如果有，它将servlet路径和key-field值相关联。
|
高速缓存引擎在ServletContext中查找属性名与该属性值相等的属性来确定是否使用自定义CacheKeyGenerator。通常应用程序提供自定义的关键字生成器而不是使用默认的。
参考"CacheKeyGenerator
Interface".（网页地址：http://docs.sun.com/source/816-7150-10/dwservlt.html#31576）。
|
Cache-mapping
将一个URL模式或servlet名字映射到其高速缓存性约束上。
子元素
下面的表格描述了cache-mapping元素的子元素。左边一列列出了子元素的名字，中间一列指定所需规则，右边一列描述了元素的功能。
|
cache-mapping 子元素
元素名
|
所需规则
|
说明
|
|
servlet-name
|
需要一个servlet-name或url-pattern
|
包含servlet的名字
|
|
url-pattern
|
需要一个servlet-name或url-pattern
|
包含可以高速缓存的servlet URL模式
|
|
cache-helper-ref
|
如果没有使用 timeout, refresh-field, http-method, key-field, 和constraint-field，则必须。
|
包含父cache-mapping元素使用的 cache-helper的名字。
|
|
timeout
|
如果没有使用cache-helper-ref，零或一个。
|
包含秒形式的 cache-mapping具体的时间最大值，也就是表目生成或刷新后可以在高速缓存中保持的最大时间。
|
|
refresh-field
|
如果没有使用cache-helper-ref，零或一个。
|
指定一个字段，给应用程序组件一种编程方式来刷新高速缓存中表目。
|
|
http-method
|
如果没有使用cache-helper-ref，零或多个。
|
包含一个被授权可以高速缓存的http方法。
|
|
key-field
|
如果没有使用cache-helper-ref，零或多个。
|
指定关键字组件，它用于查找并提取高速缓存表目。
|
|
constraint-field
|
如果没有使用cache-helper-ref，零或多个。
|
为给定的url-pattern或servlet-name指定一个高速缓存性约束。
|
属性
空
url-pattern
包含数据来指定一个servlet URL模式，在这种模式中可以高速缓存。关于可应用的模式请参考Servlet2.3规格说明SRV.11.2部分。
子元素
空
属性
空
Cache-helper-ref
包含数据来指定由父元素cache-mapping使用的cache-helper的名字。
子元素
空
属性
空
Timeout
包含数据用来以秒的形式指定cache-mapping具体的最大时间，该时间指定了高速缓存中的某个表目从它生成或刷新开始可以保持的最大时间。如果没有指定，默认值为cache元素的timeout属性的值。
子元素
空
属性
下面的表格描述了timeout元素的属性。左边一列列出了属性的名称，中间一列指定默认值，而右边一列描述其功能。
|
timeout 属性
属性名
|
默认值
|
说明
|
|
name
|
none
|
指定超时输入参数，它的值以秒的形式解释。字段的类型必须为java.lang.Long或java.lang.Integer。
|
|
scope
|
request.attribute
|
（可选）指定输入参数可以表示的范围。可能的值有 context.attribute, request.header, request.parameter, request.cookie, request.attribute,和session.attribute。
|
Refresh-field
指定一个字段，该字段为应用程序组件提供了一种编程方式来刷新高速缓存的表目。
子元素
空
属性
下面的表格描述了refresh-field元素的属性。左边一列列出了属性名称，中间一列指定了默认值，右边一列对属性的功能作了描述。
|
refresh-field 属性
属性名
|
默认值
|
说明
|
|
name
|
none
|
指定输入参数的名字。
|
|
scope
|
request.parameter
|
（可选）指定输入参数可以表示的范围 。可能的值为：context.attribute, request.header, request.parameter, request.cookie, session.id, 和session.attribute。
|
http-method
包含数据用来指定一个http方法，它有资格得到高速缓存。默认为GET。
子元素
空
属性
空
Key-field
指定用于查找和提取高速缓存表目的关键字组件。Web容器在特定范围内查找已命名参数、字段。如果没有出现该元素，那么web容器不使用servlet Path（与激活当前请求的servlet映射相符合路径部分）。关于Servlet Path的详细信息，请参考servlet2.3规格说明书，SRV4.4部分。
子元素
空
属性
下面的表格描述了key-field元素的属性。左边一列列出了属性名，中间一列指定默认值，右边一列说明了有关属性的功能。
|
key-field 属性
属性名
|
默认值
|
说明
|
|
name
|
none
|
|
