public interface TransactionalNotSupportedMixin extends Transactional
TransactionalNotSupported
Transactional.Promote
Modifier and Type | Method and Description |
---|---|
default void |
abort()
Abort a transaction - finish the transaction and undo any changes (if a "write" transaction)
|
default void |
begin()
Start a transaction which is READ mode and which will switch to WRITE if an update
is attempted but only if no intermediate transaction has performed an update.
|
default void |
begin(ReadWrite readWrite)
Start either a READ or WRITE transaction.
|
default void |
begin(TxnType txnType)
Start a transaction.
READ or WRITE transactions start in that state and do not change for the lifetime of the transaction. |
default void |
commit()
Commit a transaction - finish the transaction and make any changes permanent (if a "write" transaction)
|
default void |
end()
Finish the transaction - if a write transaction and commit() has not been called, then abort
|
default boolean |
isInTransaction()
Say whether inside a transaction.
|
default boolean |
promote(Transactional.Promote txnType)
Attempt to promote a transaction from "read" mode to "write" and the transaction.
|
default boolean |
supportsTransactionAbort() |
default boolean |
supportsTransactions() |
default ReadWrite |
transactionMode()
Return the current mode of the transaction - "read" or "write".
|
default TxnType |
transactionType()
Return the transaction type used in
begin(TxnType) . |
promote
default void begin()
Transactional
See Transactional.begin(TxnType)
for more details an options.
May not be implemented. See Transactional.begin(ReadWrite)
is guaranteed to be provided.
begin
in interface Transactional
default void begin(TxnType txnType)
Transactional
WRITE
: this guarantees a WRITE will complete if commit()
is
called. The same as begin(ReadWrite.WRITE)
.
READ
: the transaction can not promote to WRITE,ensuring read-only
access to the data. The same as begin(ReadWrite.READ)
.
READ_PROMOTE
: the transaction will go from "read" to "write" if an
update is attempted and if the dataset has not been changed by another write
transaction. See also Transactional.promote()
.
READ_COMMITTED_PROMOTE
: Use this with care. The promotion will
succeed but changes from other transactions become visible.
begin
). If READ_PROMOTE
, the dataset must not have
changed; if READ_COMMITTED_PROMOTE
any intermediate changes are
visible but the application can not assume any data it has read in the
transaction is the same as it was at the point the transaction started.
This operation is optional and some implementations may throw
a JenaTransactionException
exception for some or all TxnType
values.
See Transactional.begin(ReadWrite)
for a form that is required of implementations.
begin
in interface Transactional
default void begin(ReadWrite readWrite)
Transactional
begin
in interface Transactional
default boolean promote(Transactional.Promote txnType)
Transactional
READ
, which is read-only.
An argument of READ_PROMOTE
treats the promotion as if the transaction was started
with READ_PROMOTE
(any other writer commiting since the transaction started
blocks promotion) and READ_COMMITTED_PROMOTE
treats the promotion as if the transaction was started
with READ_COMMITTED_PROMOTE
(intemediate writer commits become visible).
Returns "true" if the transaction is in write mode after the call. The method always succeeds of the transaction is already "write".
This method returns true if a READ_PROMOTE
or
READ_COMMITTED_PROMOTE
is promoted.
This method returns false if a READ_PROMOTE
can't be promoted - the
transaction is still valid and in "read" mode.
This method throws an exception if there is an attempt to promote a READ
transaction.
promote
in interface Transactional
default void commit()
Transactional
commit
in interface Transactional
default void abort()
Transactional
abort
in interface Transactional
default void end()
Transactional
end
in interface Transactional
default boolean isInTransaction()
Transactional
isInTransaction
in interface Transactional
default ReadWrite transactionMode()
Transactional
transactionMode
in interface Transactional
default TxnType transactionType()
Transactional
begin(TxnType)
.
If the caller is not in a transaction, this method returns null.transactionType
in interface Transactional
default boolean supportsTransactions()
default boolean supportsTransactionAbort()
Licenced under the Apache License, Version 2.0