Nonstop Timeouts and Behaviors
Nonstop caches can be configured with the following attributes:
enabled – Enables ("true" DEFAULT) or disables ("false") the ability of a cache to execute certain actions after a Terracotta client disconnects. This attribute is optional for enabling nonstop.
immediateTimeout – Enables ("true") or disables ("false" DEFAULT) an immediate timeout response if the Terracotta client detects a network interruption (the node is disconnected from the cluster). If enabled, this parameter overrides
timeoutMillis, so that the option set in
timeoutBehavior is in effect immediately.
timeoutMillis – Specifies the number of milliseconds an application waits for any cache operation to return before timing out. The default value is 30000 (thirty seconds). The behavior after the timeout occurs is determined by
timeoutBehavior.
searchTimeoutMillis – Specifies the number of milliseconds an application waits for search operations to return before timing out. The default value is 30000 (thirty seconds). The behavior after the timeout occurs is determined by
timeoutBehavior.
<nonstop> has one self-closing sub-element, <timeoutBehavior>. This sub-element determines the response after a timeout occurs (timeoutMillis expires or an immediate timeout occurs). The response can be set by the <timeoutBehavior>attribute type. This attribute can have one of the values listed in the following table:
Value | Behavior |
exception | |
noop | Return null for gets. Ignore all other cache operations. Hibernate users may want to use this option to allow their application to continue with an alternative data source. |
localReads | For caches with Terracotta clustering, allow inconsistent reads of cache data. Ignore all other cache operations. For caches without Terracotta clustering, throw an exception. |
localReadsAndExceptionOnWrite | For caches with Terracotta clustering, allow inconsistent reads of cache data, and throw a NonStopCacheException for write operations. For caches without Terracotta clustering, throw an exception. |