以下是適用於虛擬伺服器的其他特性。
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 Application Deployment Guide 中的 cookie-properties。
setCacheControl
指定以逗號分隔 Cache-Control
回應指令的清單。如需有效指令的清單,請參閱以下文件的第 14.9 節://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
建置描述元中置換這些自訂錯誤頁面對映。每個 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
指定自訂值的完全合格類別名稱,該值用來為此虛擬伺服器上的應用程式產生錯誤頁。 指定空白字串以停用此虛擬伺服器的錯誤頁機制。