Interface TransactionalNotSupportedMixin
- All Superinterfaces:
Transactional
- All Known Implementing Classes:
TransactionalNotSupported
TransactionalNull
) because it does not track the transaction state
and therefore is stateless.- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.apache.jena.sparql.core.Transactional
Transactional.Promote
-
Method Summary
Modifier and TypeMethodDescriptiondefault 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
Start either a READ or WRITE transaction.default void
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 abortdefault boolean
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
default boolean
default ReadWrite
Return the current mode of the transaction - "read" or "write".default TxnType
Return the transaction type used inbegin(TxnType)
.Methods inherited from interface org.apache.jena.sparql.core.Transactional
calc, calculate, calculateRead, calculateWrite, exec, execute, executeRead, executeWrite, promote
-
Method Details
-
begin
default void begin()Description copied from interface:Transactional
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.See
Transactional.begin(TxnType)
for more details an options.May not be implemented. See
Transactional.begin(ReadWrite)
is guaranteed to be provided.- Specified by:
begin
in interfaceTransactional
-
begin
Description copied from interface:Transactional
Start a transaction.
READ or WRITE transactions start in that state and do not change for the lifetime of the transaction.WRITE
: this guarantees a WRITE will complete ifcommit()
is called. The same asbegin(ReadWrite.WRITE)
.READ
: the transaction can not promote to WRITE,ensuring read-only access to the data. The same asbegin(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 alsoTransactional.promote()
.READ_COMMITTED_PROMOTE
: Use this with care. The promotion will succeed but changes from other transactions become visible.
begin
). IfREAD_PROMOTE
, the dataset must not have changed; ifREAD_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 allTxnType
values.See
Transactional.begin(ReadWrite)
for a form that is required of implementations.- Specified by:
begin
in interfaceTransactional
-
begin
Description copied from interface:Transactional
Start either a READ or WRITE transaction.- Specified by:
begin
in interfaceTransactional
-
promote
Description copied from interface:Transactional
Attempt to promote a transaction from "read" mode to "write" and the transaction. This method allows the form of promotion to be specified. The transaction must not have been started withREAD
, which is read-only.An argument of
READ_PROMOTE
treats the promotion as if the transaction was started withREAD_PROMOTE
(any other writer commiting since the transaction started blocks promotion) andREAD_COMMITTED_PROMOTE
treats the promotion as if the transaction was started withREAD_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
orREAD_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.- Specified by:
promote
in interfaceTransactional
-
commit
default void commit()Description copied from interface:Transactional
Commit a transaction - finish the transaction and make any changes permanent (if a "write" transaction)- Specified by:
commit
in interfaceTransactional
-
abort
default void abort()Description copied from interface:Transactional
Abort a transaction - finish the transaction and undo any changes (if a "write" transaction)- Specified by:
abort
in interfaceTransactional
-
end
default void end()Description copied from interface:Transactional
Finish the transaction - if a write transaction and commit() has not been called, then abort- Specified by:
end
in interfaceTransactional
-
isInTransaction
default boolean isInTransaction()Description copied from interface:Transactional
Say whether inside a transaction.- Specified by:
isInTransaction
in interfaceTransactional
-
transactionMode
Description copied from interface:Transactional
Return the current mode of the transaction - "read" or "write". If the caller is not in a transaction, this method returns null.- Specified by:
transactionMode
in interfaceTransactional
-
transactionType
Description copied from interface:Transactional
Return the transaction type used inbegin(TxnType)
. If the caller is not in a transaction, this method returns null.- Specified by:
transactionType
in interfaceTransactional
-
supportsTransactions
default boolean supportsTransactions() -
supportsTransactionAbort
default boolean supportsTransactionAbort()
-