以下其他属性可用于虚拟服务器。
sso-max-inactive-seconds
指定如果未接收到任何客户机活动,在可以清除用户的单点登录记录之前等待的秒数。由于单点登录应用到同一台虚拟服务器上的多个应用程序,因此对其中任何一个应用程序的访问都可以使单点登录记录保持活动状态。
默认值是 300 秒 (5 分钟)。较高的值为用户提供了较长的单点登录持久性,但会占用服务器的更多内存。
sso-reap-interval-seconds
指定清除到期的单点登录记录的时间间隔 (秒)。
默认值为 60。
ssoCookieSecure
设置与部署到此虚拟服务器的 Web 应用程序关联的任何 JSESSIONIDSSO
cookie 的 Secure
属性。只有在启用单点登录时,此属性才适用。允许的值包括:
真
将 Secure
设置为真。
假
将 Secure
设置为假。
dynamic
JSESSIONIDSSO
cookie 继承参与 SSO 的第一个会话的 Secure
设置。
要设置 JSESSIONID
cookie 的 Secure 属性,请使用 sun-web.xml
文件中的 cookieSecure
cookie-properties
属性。有关详细信息,请参阅 Oracle GlassFish Server Application Deployment Guide 中的 cookie-properties。
setCacheControl
指定 Cache-Control
响应指令的逗号分隔列表。有关有效指令的列表,请参阅位于 http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt
) 的文档的第 14.9 节。
accessLogBufferSize
指定存储访问日志调用的缓冲区的大小 (字节)。如果该值小于 5120,则系统会发出警告消息,并将该值设置为 5120。默认值为 32768。
accessLogWriterInterval
指定在将日志写入磁盘之前经过的秒数。缓冲区已满或超过时间间隔时写入访问日志。如果该值为 0,则系统始终会将数据写入缓冲区,即使缓冲区未满也是如此。这意味着每次访问服务器时都将日志消息直接存储到该文件中。默认值为 300。
allowRemoteAddress
指定用于比较远程客户机 IP 地址的正则表达式模式的逗号分隔列表。如果指定了此属性,则远程地址必须匹配,才会接受此请求。如果未指定此属性,则会接受所有请求,除非远程地址与 denyRemoteAddress
模式匹配。
denyRemoteAddress
指定用于比较远程客户机 IP 地址的正则表达式模式的逗号分隔列表。如果指定了此属性,则远程地址必须不匹配,才会接受此请求。如果未指定此属性,将仅由 allowRemoteAddress
属性来控制是否接受请求。
allowRemoteHost
指定用于比较远程客户机主机名 (由 [java.net.]Socket.getInetAddress().getHostName()
返回) 的正则表达式模式的逗号分隔列表。如果指定了此属性,则远程主机名必须匹配,才会接受此请求。如果未指定此属性,则会接受所有请求,除非远程主机名与 denyRemoteHost
模式匹配。
denyRemoteHost
指定用于比较远程客户机主机名 (由 [java.net.]Socket.getInetAddress().getHostName()
返回) 的正则表达式模式的逗号分隔列表。如果指定了此属性,则远程主机名必须不匹配,才会接受此请求。如果未指定此属性,将仅由 allowRemoteHost
属性来控制是否接受请求。
如果通过启用了“JK 监听程序”选项的网络监听程序访问 GlassFish Server 域,则设置此属性将不起作用。
authRealm
指定验证领域的名称,该领域将覆盖已部署至此虚拟服务器的独立 Web 应用程序的服务器实例默认领域。在独立 Web 应用程序的 web.xml
文件中定义的领域会覆盖虚拟服务器的领域。有关详细信息,请参阅领域。
securePagesWithPragma
将此属性设置为假
,可以确保此虚拟服务器上的所有 Web 应用程序可在 Internet Explorer 中使用 SSL 正常进行文件下载操作。
通过使用 sun-web.xml
文件中的 sun-web-app
元素,各个 Web 应用程序均可以覆盖该设置。有关详细信息,请参阅 Oracle GlassFish Server Application Deployment Guide 中的 glassfish-web-app。
默认值为真
。
alternatedocroot_
n指定备用文档根目录 (docroot),其中 n 为允许指定多个根目录的正整数。通过备用文档根目录,Web 应用程序可根据请求是否与一个 (或多个) Web 应用程序备用文档根目录的 URI 模式相匹配,来为自身文档根目录之外的某些资源的请求提供服务。
如果请求与一个备用文档根目录的 URI 模式匹配,则系统会通过将请求 URI (去掉 Web 应用程序的上下文根目录) 附加到备用文档根目录的物理位置 (目录) 来将请求映射到备用文档根目录。如果请求与多个 URI 模式匹配,则按照以下优先顺序来确定备用文档根目录:
完全匹配
最长路径匹配
扩展名匹配
例如,以下属性指定了三个备用文档根目录。第一个备用文档根目录的 URI 模式使用完全匹配,而第二和第三个备用文档根目录的 URI 模式则分别使用扩展名匹配和最长路径前缀匹配。
<property name="alternatedocroot_1" value="from=/my.jpg dir=/srv/images/jpg" <property name="alternatedocroot_2" value="from=*.jpg dir=/srv/images/jpg" <property name="alternatedocroot_3" value="from=/jpg/* dir=/src/images"
每个备用文档根目录的 value
均有两个组件:第一个组件 from
指定备用文档根目录的 URI 模式,而第二个组件 dir
则指定备用文档根目录的物理位置 (目录)。dir
组件中允许使用空格。
通过使用 sun-web.xml
文件中的 sun-web-app
元素,各个 Web 应用程序均可以覆盖该设置。有关详细信息,请参阅 Oracle GlassFish Server Application Deployment Guide 中的 glassfish-web-app。
contextXmlDefault
指定此虚拟服务器的 context.xml
文件 (如果使用的话) 相对于 domain-dir 的位置。有关 context.xml
文件的详细信息,请参阅上下文容器 (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html
)。
allowLinking
如果设置为真
,将为部署到该虚拟服务器上的所有 Web 应用程序提供符号链接资源。通过使用 sun-web.xml
文件中的 sun-web-app
属性 allowLinking
,各个 Web 应用程序均可以覆盖该设置:
<sun-web-app> <property name="allowLinking" value="{true|false}" </sun-web-app>
有关详细信息,请参阅 Oracle GlassFish Server Application Deployment Guide 中的 glassfish-web-app。
默认值为假
。
注意:
在 Windows 系统上将此属性设置为真可以公开 JSP 源代码。send-error_
n指定虚拟服务器的定制错误页映射,这些映射将由虚拟服务器上部署的所有 Web 应用程序继承。Web 应用程序可在其 web.xml
部署描述符中覆盖这些定制错误页映射。每个 send-error_
n 属性的值均有三个组件,这些组件可按任意顺序指定:
第一个组件 code
指定响应中应返回的定制错误页的三位数 HTTP 响应状态代码。
第二个组件 path
指定定制错误页的绝对或相对文件系统路径。相对文件系统路径解释为相对于 domain-dir/config
目录。
第三个组件 reason
是可选的,它指定要返回的原因字符串文本 (例如 Unauthorized
或 Forbidden
)。
例如:
<property name="send-error_1" value="code=401 path=/myhost/401.html reason=MY-401-REASON"
此示例属性定义将会返回 /myhost/401.html
的内容、401 响应和以下响应行:
HTTP/1.1 401 MY-401-REASON
redirect_
n指定将旧 URL 的请求处理成新 URL 的请求。这些属性将由虚拟服务器上部署的所有 Web 应用程序继承。每个 redirect_
n 属性的值均有两个组件,这些组件可按任意顺序指定:
第一个组件 from
指定要匹配的请求 URI 前缀。
第二个组件 url-prefix
指定要返回给客户机的新 URL 前缀。此 URL 前缀将替换 from
前缀。
例如:
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"
valve_
n指定定制调节器的全限定类名,其中 n 为正整数,允许指定多个全限定类名。valve 类必须从 Tomcat 或早期发行版的 GlassFish Server 实现 org.apache.catalina.Valve
接口,或从当前 GlassFish Server 发行版实现 org.glassfish.web.valve.GlassFishValve
接口。例如:
<property name="valve_1" value="org.glassfish.extension.Valve"
可以为特定 Web 应用程序设置此属性。有关详细信息,请参阅 Oracle GlassFish Server Application Deployment Guide 中的 glassfish-web-app。
listener_
n指定定制 Catalina 监听程序的全限定类名,其中 n 为正整数,允许指定多个全限定类名。listener 类必须实现 org.apache.catalina.ContainerListener
或 org.apache.catalina.LifecycleListener
接口。例如:
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"
可以为特定 Web 应用程序设置此属性。有关详细信息,请参阅 Oracle GlassFish Server Application Deployment Guide 中的 glassfish-web-app。
errorReportValve
指定定制调节器的全限定类名,该调节器在此虚拟服务器上生成应用程序的默认错误页。指定空字符串可以禁用此虚拟服务器的默认错误页机制。