agi.foundation.infrastructure.threading

(agi.foundation.tracking-2024r3.jar)

Class TransactedObject

java.lang.Object

agi.foundation.infrastructure.threading.TransactedObject

Direct Known Subclasses:

TransactedProperty

public abstract class TransactedObject
extends Object

An object that participates in the software transactional memory (STM) system via TransactionContext and Transaction.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TransactedObject(TransactionContext context, Object owner) Initializes a new instance with a specified owner.

Method Summary

Modifier and Type	Method and Description
protected void	checkTransaction(Transaction transaction) Verifies that a specified transaction is in the same context as this transacted object and throws an ArgumentException if it is not.
TransactionContext	getContext() Gets the transaction context in which this object can be modified.
Object	getOwner() Gets the object that owns this transacted object, or null if this object does not have an owner.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransactedObject

protected TransactedObject(@Nonnull
                           TransactionContext context,
                           Object owner)

Initializes a new instance with a specified owner.

Parameters:

context - The context in which this object can be modified.

owner - The object that owns this transacted object.

Method Detail

getContext

public final TransactionContext getContext()

Gets the transaction context in which this object can be modified.

getOwner

public final Object getOwner()

Gets the object that owns this transacted object, or null if this object does not have an owner.

checkTransaction

protected final void checkTransaction(@Nonnull
                                      Transaction transaction)

Verifies that a specified transaction is in the same context as this transacted object and throws an ArgumentException if it is not.

Parameters:

transaction - The transaction to verify.

Throws:

ArgumentException - The specified transaction is in a different context than this transacted object.