t

scala.concurrent.stm

TxnDebuggable

trait TxnDebuggable extends AnyRef

This trait implements methods that can be used to examine the content of transactional data structures in a debugger with minimal modification to the behavior of the program. Normal transactional reads would add to an atomic block's read set, which could reduce the number of valid program execution orders. dbgStr and dbgValue perform transactional reads, but then erase them from the enclosing transaction (if any).

You can use these methods from an IDE debugger manually, by watching x.dbgStr or x.dbgValue rather than x.

If you use Eclipse, you can make this method the default view by going to Window->Preferences->Java[+]->Debug[+]->Detail Formatters and entering the code snippet dbgStr() (or dbgValue()) for instances of scala.concurrent.stm.TxnDebuggable.

If you use IntelliJ IDEA, go to File->Settings...->Debugger->Data Type Renderers and create a new renderer for scala.concurrent.stm.TxnDebuggable that uses dbgStr() for rendering and dbgValue() for node expansion.

Linear Supertypes
AnyRef, Any
Known Subclasses
Ref, View, Source, View, TArray, View, TMap, View, TSet, View
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. TxnDebuggable
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def dbgStr: String

    Returns a string representation of the transactional value in this instance for debugging convenience.

    Returns a string representation of the transactional value in this instance for debugging convenience. The Ref reads (and writes) performed while constructing the result will be discarded before returning. This method works fine outside a transaction.

    If this method is called from within a transaction that is already doomed (status Txn.Rolledback), a string describing the reason for the outer transaction's rollback will be returned.

  2. abstract def dbgValue: Any

    Returns some value that is suitable for examination in a debugger, or returns a Txn.RollbackCause if called from inside a doomed atomic block.