以下是適用於虛擬伺服器的其他特性。
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 特性的值都有三個可依任何順序指定的元件:
第一個部分 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 為正整數,表示允許多個規格。值類別必須從 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.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
指定自訂值的完全合格類別名稱,該值用來為此虛擬伺服器上的應用程式產生錯誤頁。指定空白字串以停用此虛擬伺服器的錯誤頁機制。