Class ConsistencyException
- All Implemented Interfaces:
Serializable
,oracle.kv.impl.util.FastExternalizable
Consistency
could not be met, within the allowed timeout
period.
The likelihood of this exception being thrown depends on the specified
Consistency
and the general health of the KVStore system. The
default consistency policy (specified by KVStoreConfig.getConsistency()
) is Consistency.NONE_REQUIRED
. With
Consistency.NONE_REQUIRED
(the default), Consistency.NONE_REQUIRED_NO_MASTER
, or Consistency.ABSOLUTE
, this
exception will never be thrown.
If the client overrides the default and specifies a Consistency.Time
or Consistency.Version
setting, then this
exception will be thrown when the specified consistency requirement cannot
be satisfied within the timeout period associated with the consistency
setting. If this exception is encountered frequently, it indicates that the
consistency policy requirements are too strict and cannot be met routinely
given the load being placed on the system and the hardware resources that
are available to service the load.
Depending on the nature of the application, when this exception is thrown the client may wish to
- retry the read operation,
- fall back to using a larger timeout or a less restrictive consistency
setting (for example,
Consistency.NONE_REQUIRED
), and resume using the original consistency setting at a later time, or - give up and report an error at a higher level.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionReturns the consistency policy that could not be satisfied.void
setConsistency
(Consistency consistency) Sets the consistency policy.Methods inherited from class oracle.kv.FaultException
getFaultClassName, getRemoteStackTrace, toString, wasLoggedRemotely
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface oracle.kv.impl.util.FastExternalizable
deserializedForm
-
Method Details
-
getConsistency
Returns the consistency policy that could not be satisfied. -
setConsistency
Sets the consistency policy.- Parameters:
consistency
- the consistency policy
-