虛擬伺服器特定的特性

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

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 特性的值都有三個可依任意順序指定的部分:

例如︰

<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, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices