以下是適用於虛擬伺服器的其他特性。
指定在未接收到任何用戶端作業的情形下,可以清除使用者單次登入記錄之前等待的秒數。由於單次登入套用於同一個虛擬伺服器上的多個應用程式,因此對其中任何一個應用程式的存取均會使單次登入記錄保持使用中狀態。
預設值為 300 秒 (5 分鐘)。較高的值可延長使用者的單次登入持續時間,但會佔用較多的伺服器記憶體。
指定兩次清除過期的單次登入記錄的間隔秒數。
預設值為 60。
設定與部署到此虛擬伺服器的 Web 應用程式關聯的任何 JSESSIONIDSSO cookie 的 Secure 屬性。此屬性只有在單次登入啟用時才適用。允許的值包括:
將 Secure 設為 true。
將 Secure 設為 false。
JSESSIONIDSSO cookie 會繼承第一個加入 SSO 之階段作業的 Secure 設定。
若要設定 JSESSIONID cookie 的 Secure 屬性,請使用 sun-web.xml 檔案中的 cookieSecure cookie-properties 屬性。如需詳細資訊,請參閱 「Oracle GlassFish Server 3.1 Application Deployment Guide」中的「cookie-properties」。
指定以逗號分隔 Cache-Control 回應指令的清單。如需有效指令的清單,請參閱以下文件的第 14.9 節:http://www.ietf.org/rfc/rfc2616.txt。
指定儲存存取記錄呼叫的緩衝區大小 (以位元組為單位)。若此值小於 5120,會發出警告訊息,並將值設為 5120。預設值為 32768。
指定將記錄寫入磁碟之前經過的秒數。當緩衝區已滿或間隔過期時,存取記錄會被寫入。若此值為 0,則即使緩衝區未滿,也會一直執行寫入。這意味著每次存取伺服器時,會將記錄訊息直接儲存至檔案中。預設值為 300。
指定以逗號分隔常規表示式樣式的清單,遠端用戶端的 IP 位址會以這些樣式為比對依據。如果指定此特性,則遠端位址必須符合,才能使這個請求被接受。如果未指定此特性,則所有請求都會被接受,除非遠端位址符合 denyRemoteAddress 樣式。
指定以逗號分隔常規表示式樣式的清單,遠端用戶端的 IP 位址會以這些樣式為比對依據。如果指定此特性,則遠端位址必須不符合,才能使這個請求被接受。如果未指定此特性,則是否接受請求完全由 allowRemoteAddress 特性控制。
指定以逗號分隔常規表示式樣式的清單,而遠端用戶端的主機名稱 (由 [java.net.]Socket.getInetAddress().getHostName() 所傳回) 會以這些樣式為比對依據。如果指定此特性,則遠端主機名稱必須符合,才能使這個請求被接受。如果未指定此特性,則所有請求都會被接受,除非遠端主機名稱符合 denyRemoteHost 樣式。
指定以逗號分隔常規表示式樣式的清單,而遠端用戶端的主機名稱 (由 [java.net.]Socket.getInetAddress().getHostName() 所傳回) 會以這些樣式為比對依據。如果指定此特性,則遠端主機名稱必須不符合,才能使這個請求被接受。如果未指定此特性,則是否接受請求完全由 allowRemoteHost 特性控制。
如果是透過已啟用 [JK 偵聽程式] 選項的網路偵聽程式存取 GlassFish Server 網域,則設定此特性不會有影響。
指定認證範圍的名稱,此範圍會為部署至此虛擬伺服器的獨立 Web 應用程式,置換伺服器實例的預設範圍。獨立 Web 應用程式的 web.xml 檔案中定義的範圍,會置換虛擬伺服器的範圍。如需更多資訊,請參閱範圍。
將此特性設定為 false,可確保對於此虛擬伺服器上的所有 Web 應用程式而言,使用 SSL 的檔案下載在 Internet Explorer 中可正確執行。
使用 sun-web.xml 檔案的 sun-web-app 元素,可讓個別 Web 應用程式置換此設定。如需詳細資訊,請參閱 「Oracle GlassFish Server 3.1 Application Deployment Guide」中的「glassfish-web-app」。
預設值為 true。
指定替代文件根 (文件根),其中 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」。
指定此虛擬伺服器之 context.xml 檔案 (如果使用) 相對於 domain-dir 的位置。如需有關 context.xml 檔案的更多資訊,請參閱環境容器。
如果為 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 原始碼。
指定虛擬伺服器的自訂錯誤頁面對映,已在虛擬伺服器上部署的所有 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
指定將舊 URL 的請求視為新 URL 的請求。已在虛擬伺服器上部署的所有 Web 應用程式都會繼承這些特性。每個 redirect_n 特性的值都有兩個可依任何順序指定的部分:
第一個部分 from 指定要符合之請求的 URI 前綴。
第二個部分 url-prefix 指定要傳回給用戶端的新 URL 前綴。此 URL 前綴會直接取代 from 前綴。
例如︰
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"/>
指定完全合格的自訂閾值類別名稱,其中 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 3.1 Application Deployment Guide」中的「glassfish-web-app」。
指定完全合格的自訂 Catalina 偵聽程式類別名稱,其中 n 為指定一個以上規格的正整數。listener 類別必須實作 org.apache.catalina.ContainerListener 或 org.apache.catalina.LifecycleListener 介面。例如︰
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"/>
您可以為特定的 Web 應用程式設定此特性。如需詳細資訊,請參閱 「Oracle GlassFish Server 3.1 Application Deployment Guide」中的「glassfish-web-app」。
指定自訂值的完全合格類別名稱,該值用來為此虛擬伺服器上的應用程式產生錯誤頁。 指定空白字串以停用此虛擬伺服器的錯誤頁機制。