scala.concurrent.stm.Txn.OptimisticFailureCause

The RollbackCause for a NestingLevel whose optimistic execution was invalid, and that should be retried. The specific situations in which an optimistic failure can occur are specific to the STM algorithm, but may include:

the STM detected that the value returned by a previous read in this nesting level is no longer valid;
a cyclic dependency has occurred and this nesting level must be rolled back to avoid deadlock;
a transaction with a higher priority wanted to write to a Ref written by this transaction;
the STM decided to switch execution strategies for this atomic block; or
no apparent reason (*).

(*) - Some STMs perform validation, conflict detection and deadlock cycle breaking using algorithms that are conservative approximations. This means that any particular attempt to execute an atomic block might fail spuriously.

category: an STM-specific label for the reason behind this optimistic failure. The set of possible categories is bounded.
trigger: the specific object that led to the optimistic failure, if it is available, otherwise None.

Linear Supertypes

Serializable, Serializable, Product, Equals, TransientRollbackCause, RollbackCause, AnyRef, Any

Ordering

Alphabetic
By inheritance

Inherited

Hide All
Show all

OptimisticFailureCause
Serializable
Serializable
Product
Equals
TransientRollbackCause
RollbackCause
AnyRef
Any

Visibility

Public
All

Instance Constructors

new OptimisticFailureCause (category: Symbol, trigger: Option[Any])

category
an STM-specific label for the reason behind this optimistic failure. The set of possible categories is bounded.
trigger
the specific object that led to the optimistic failure, if it is available, otherwise None.

Value Members

def != (arg0: AnyRef): Boolean

Attributes
final
Definition Classes
AnyRef
def != (arg0: Any): Boolean

Attributes
final
Definition Classes
Any
def ## (): Int

Attributes
final
Definition Classes
AnyRef → Any
def == (arg0: AnyRef): Boolean

Attributes
final
Definition Classes
AnyRef
def == (arg0: Any): Boolean

Attributes
final
Definition Classes
Any
def asInstanceOf [T0] : T0

Attributes
final
Definition Classes
Any
def canEqual (arg0: Any): Boolean

Definition Classes
OptimisticFailureCause → Equals
val category : Symbol

an STM-specific label for the reason behind this optimistic failure.
an STM-specific label for the reason behind this optimistic failure. The set of possible categories is bounded.
def clone (): AnyRef

Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws()
def eq (arg0: AnyRef): Boolean

Attributes
final
Definition Classes
AnyRef
def equals (arg0: Any): Boolean

Definition Classes
OptimisticFailureCause → Equals → AnyRef → Any
def finalize (): Unit

Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws()
def getClass (): java.lang.Class[_]

Attributes
final
Definition Classes
AnyRef
def hashCode (): Int

Definition Classes
OptimisticFailureCause → AnyRef → Any
def isInstanceOf [T0] : Boolean

Attributes
final
Definition Classes
Any
def ne (arg0: AnyRef): Boolean

Attributes
final
Definition Classes
AnyRef
def notify (): Unit

Attributes
final
Definition Classes
AnyRef
def notifyAll (): Unit

Attributes
final
Definition Classes
AnyRef
def productArity : Int

Definition Classes
OptimisticFailureCause → Product
def productElement (arg0: Int): Any

Definition Classes
OptimisticFailureCause → Product
def productIterator : Iterator[Any]

Definition Classes
Product
def productPrefix : String

Definition Classes
OptimisticFailureCause → Product
def synchronized [T0] (arg0: ⇒ T0): T0

Attributes
final
Definition Classes
AnyRef
def toString (): String

Definition Classes
OptimisticFailureCause → AnyRef → Any
val trigger : Option[Any]

the specific object that led to the optimistic failure, if it is available, otherwise None.
def wait (): Unit

Attributes
final
Definition Classes
AnyRef
Annotations
@throws()
def wait (arg0: Long, arg1: Int): Unit

Attributes
final
Definition Classes
AnyRef
Annotations
@throws()
def wait (arg0: Long): Unit

Attributes
final
Definition Classes
AnyRef
Annotations
@throws()
def productElements : Iterator[Any]

Definition Classes
Product
Annotations
@deprecated
Deprecated
use productIterator instead

OptimisticFailureCause

case class OptimisticFailureCause (category: Symbol, trigger: Option[Any]) extends TransientRollbackCause with Product with Serializable

Instance Constructors

new OptimisticFailureCause (category: Symbol, trigger: Option[Any])

Value Members

def != (arg0: AnyRef): Boolean

def != (arg0: Any): Boolean

def ## (): Int

def == (arg0: AnyRef): Boolean

def == (arg0: Any): Boolean

def asInstanceOf [T0] : T0

def canEqual (arg0: Any): Boolean

val category : Symbol

def clone (): AnyRef

def eq (arg0: AnyRef): Boolean

def equals (arg0: Any): Boolean

def finalize (): Unit

def getClass (): java.lang.Class[_]

def hashCode (): Int

def isInstanceOf [T0] : Boolean

def ne (arg0: AnyRef): Boolean

def notify (): Unit

def notifyAll (): Unit

def productArity : Int

def productElement (arg0: Int): Any

def productIterator : Iterator[Any]

def productPrefix : String

def synchronized [T0] (arg0: ⇒ T0): T0

def toString (): String

val trigger : Option[Any]

def wait (): Unit

def wait (arg0: Long, arg1: Int): Unit

def wait (arg0: Long): Unit

def productElements : Iterator[Any]

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from TransientRollbackCause

Inherited from RollbackCause

Inherited from AnyRef

Inherited from Any