org.apache.jena.dboe.transaction.txn

Class TransactionalBase

java.lang.Object

org.apache.jena.dboe.transaction.txn.TransactionalBase

All Implemented Interfaces:

TransactionalSystem, Transactional

public class TransactionalBase
extends Object
implements TransactionalSystem

Framework for implementing a Transactional via TransactionalSystem. This base class provides the "per thread" aspect - the TransactionCoordinator itself is not thread aware.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.jena.sparql.core.Transactional

Transactional.Promote

Constructor Summary

Constructors

Constructor and Description
TransactionalBase(String label, TransactionCoordinator txnMgr)
TransactionalBase(TransactionCoordinator txnMgr)

Method Summary

Modifier and Type	Method and Description
void	abort()
void	attach(TransactionCoordinatorState coordinatorState) Attach a transaction to this thread.
void	begin(ReadWrite readWrite)
void	begin(TxnType txnType)
void	commit()
void	commitExec() Do the 2-phase "commit" step
void	commitPrepare() Do the 2-phase "prepare" step after which the transaction coordinator decides whether to commit or abort.
TransactionCoordinatorState	detach() Suspend this transaction, detaching from the current thread.
void	end()
Transaction	getThreadTransaction() Return the transaction object for this thread.
TransactionInfo	getTransactionInfo() Return an information view of the transaction for this thread, if any.
TransactionCoordinator	getTxnMgr() Get the associated TransactionCoordinator
boolean	isInTransaction()
boolean	promote()
boolean	promote(Transactional.Promote promoteMode)
void	shutdown() Shutdown component, aborting any in-progress transactions.
ReadWrite	transactionMode()
TxnType	transactionType()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jena.sparql.core.Transactional

begin

Constructor Detail

TransactionalBase

public TransactionalBase(String label,
                         TransactionCoordinator txnMgr)

TransactionalBase

public TransactionalBase(TransactionCoordinator txnMgr)

Method Detail

getTxnMgr

public TransactionCoordinator getTxnMgr()

Description copied from interface: TransactionalSystem

Get the associated TransactionCoordinator

Specified by:

getTxnMgr in interface TransactionalSystem

detach

public TransactionCoordinatorState detach()

Description copied from interface: TransactionalSystem

Suspend this transaction, detaching from the current thread. A new transaction on this thread can performed but the detached transaction still exists and if it is a write transaction it can still block other write transactions.

Specified by:

detach in interface TransactionalSystem

attach

public void attach(TransactionCoordinatorState coordinatorState)

Description copied from interface: TransactionalSystem

Attach a transaction to this thread. A transaction system implementation usually imposes a rule that only one thread can have a transaction attached at a time.

Specified by:

attach in interface TransactionalSystem

begin

public final void begin(ReadWrite readWrite)

Specified by:

begin in interface Transactional

begin

public final void begin(TxnType txnType)

Specified by:

begin in interface Transactional

promote

public final boolean promote()

Specified by:

promote in interface Transactional

promote

public final boolean promote(Transactional.Promote promoteMode)

Specified by:

promote in interface Transactional

commit

public final void commit()

Specified by:

commit in interface TransactionalSystem

Specified by:

commit in interface Transactional

commitPrepare

public void commitPrepare()

Description copied from interface: TransactionalSystem

Do the 2-phase "prepare" step after which the transaction coordinator decides whether to commit or abort. A TransactionalSystem must be prepared for both possibilities.

Specified by:

commitPrepare in interface TransactionalSystem

commitExec

public void commitExec()

Description copied from interface: TransactionalSystem

Do the 2-phase "commit" step

Specified by:

commitExec in interface TransactionalSystem

abort

public final void abort()

Specified by:

abort in interface Transactional

end

public final void end()

Specified by:

end in interface Transactional

transactionMode

public ReadWrite transactionMode()

Specified by:

transactionMode in interface Transactional

transactionType

public TxnType transactionType()

Specified by:

transactionType in interface Transactional

isInTransaction

public boolean isInTransaction()

Specified by:

isInTransaction in interface Transactional

getTransactionInfo

public final TransactionInfo getTransactionInfo()

Description copied from interface: TransactionalSystem

Return an information view of the transaction for this thread, if any. Returns null when there is no active transaction for this tread.

Specified by:

getTransactionInfo in interface TransactionalSystem

getThreadTransaction

public final Transaction getThreadTransaction()

Description copied from interface: TransactionalSystem

Return the transaction object for this thread. Low-level use only. To get information about the current transaction, call TransactionalSystem.getTransactionInfo().

Specified by:

getThreadTransaction in interface TransactionalSystem

shutdown

public void shutdown()

Shutdown component, aborting any in-progress transactions. This operation is not guaranteed to be called.