虛擬伺服器特定的特性

以下是適用於虛擬伺服器的其他特性。

sso-max-inactive-seconds

指定在未接收到任何從屬端作業的情形下,可以清除使用者 Single Sign-On 記錄之前等待的秒數。由於 Single Sign-On 套用於同一個虛擬伺服器上的多個應用程式,因此對其中任何一個應用程式的存取均會使 Single Sign-On 記錄保持使用中狀態。

預設值為 300 秒 (5 分鐘)。較高的值可延長使用者的 Single Sign-On 持續時間,但會佔用較多的伺服器記憶體。

sso-reap-interval-seconds

指定兩次清除過期的 Single Sign-On 記錄的間隔秒數。

預設值為 60。

ssoCookieSecure

設定與建置到此虛擬伺服器的 Web 應用程式關聯的任何 JSESSIONIDSSO cookie 的 Secure 屬性。此屬性只有在 Single Sign-On 啟用時才適用。允許的值包括:

true

Secure 設為 true。

false

Secure 設為 false。

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 回應指令的清單。如需有效指令的清單,請參閱以下文件的第 14.9 節:http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt)。

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 檔案中定義的範圍,會置換虛擬伺服器的範圍。如需更多資訊,請參閱 Realms

securePagesWithPragma

將此特性設定為 false,可確保對於此虛擬伺服器上的所有 Web 應用程式而言,使用 SSL 的檔案下載在 Internet Explorer 中可正確執行。

使用 sun-web.xml 檔案的 sun-web-app 元素,可讓個別 Web 應用程式置換此設定。如需詳細資訊,請參閱 Oracle GlassFish Server Application Deployment Guide 中的 glassfish-web-app

預設值為 true

alternatedocroot_n

指定替代文件根 (文件根),其中 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

如果為 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 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 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 Application Deployment Guide 中的 glassfish-web-app

errorReportValve

指定自訂值的完全合格類別名稱,該值用來為此虛擬伺服器上的應用程式產生錯誤頁。指定空白字串以停用此虛擬伺服器的錯誤頁機制。

Copyright © 2005, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices