特定于虚拟服务器的属性

以下附加属性可用于虚拟服务器。

sso-max-inactive-seconds

指定如果未接收到任何客户机活动,在可以清除用户的单点登录记录之前等待的时间(以秒为单位)。由于单点登录应用到同一台虚拟服务器上的多个应用程序,因此对其中任何一个应用程序的访问都可以使单点登录记录保持活动状态。

默认值是 300 秒(5 分钟)。较高的值为用户提供了较长的单点登录持久性,但会占用服务器的更多内存。

sso-reap-interval-seconds

指定清除到期的单点登录记录的时间间隔(以秒为单位)。

默认值为 60。

ssoCookieSecure

设置与部署到此虚拟服务器的 Web 应用程序关联的任何 JSESSIONIDSSO cookie 的 Secure 属性。只有在启用单点登录时,此属性才适用。允许的值包括:

true

Secure 设置为 true。

false

Secure 设置为 false。

dynamic

JSESSIONIDSSO cookie 继承参与 SSO 的第一个会话的 Secure 设置。

要设置 JSESSIONID cookie 的 Secure 属性,请使用 sun-web.xml 文件中的 cookieSecure cookie-properties 属性。有关详细信息,请参见《Oracle GlassFish Server 3.1 Application Deployment Guide 》中的"cookie-properties"

setCacheControl

指定 Cache-Control 响应指令的逗号分隔列表。有关有效的指令列表,请参见 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

将此属性设置为 false,可以确保此虚拟服务器上的所有 Web 应用程序可在 Internet Explorer 中使用 SSL 正常进行文件下载操作。

通过使用 sun-web.xml 文件中的 sun-web-app 元素,各个 Web 应用程序均可以覆盖该设置。有关详细信息,请参见《Oracle GlassFish Server 3.1 Application Deployment Guide》中的"glassfish-web-app"

默认值为 true

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 3.1 Application Deployment Guide》中的"glassfish-web-app"

contextXmlDefault

指定此虚拟服务器的 context.xml 文件(如果使用的话)相对于 domain-dir 的位置。有关 context.xml 文件的更多信息,请参见 The Context Container

allowLinking

如果设置为true,将为部署到该虚拟服务器上的所有 Web 应用程序提供符号链接资源。通过使用 sun-web.xml 文件中的 sun-web-app 属性 allowLinking,各个 Web 应用程序均可以覆盖该设置:

<sun-web-app>
   <property name="allowLinking" 
      value="{true|false}"/>
</sun-web-app>

有关详细信息,请参见《Oracle GlassFish Server 3.1 Application Deployment Guide》中的"glassfish-web-app"

默认值为 false


注意 - 在 Windows 系统上将此属性设置为 true 可以公开 JSP 源代码。


send-error_n

指定虚拟服务器的自定义错误页面映射,这些映射将由虚拟服务器上部署的所有 Web 应用程序继承。Web 应用程序可在其 web.xml 部署描述符中覆盖这些自定义错误页面映射。每个 send-error_ n 属性的值均有三个组件,这些组件可按任意顺序指定:

例如:

<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 属性的值均有两个组件,这些组件可按任意顺序指定:

例如:

<property name="redirect_1" 
  value="from=/dummy url-prefix=http://etude"/>
valve_n

指定自定义阀值的全限定类名,其中 n 为正整数,允许指定多个全限定类名。阀值类必须实现 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 3.1 Application Deployment Guide》中的"glassfish-web-app"

listener_n

指定自定义 Catalina 侦听器的全限定类名,其中 n 为正整数,允许指定多个全限定类名。该侦听器类必须实现 org.apache.catalina.ContainerListenerorg.apache.catalina.LifecycleListener 接口。例如:

<property name="listener_1"
value="org.glassfish.extension.MyLifecycleListener"/>

可以为特定 Web 应用程序设置此属性。有关详细信息,请参见《Oracle GlassFish Server 3.1 Application Deployment Guide》中的"glassfish-web-app"

errorReportValve

指定自定义阀值的全限定类名,该阀值在此虚拟服务器上生成应用程序的默认错误页面。指定空字符串可以禁用此虚拟服务器的默认错误页面机制。

版权所有 © 2005, 2011, Oracle 和/或其附属公司。 保留所有权利。 法律声明