javax.transaction.Transaction
public interface Transaction
Transaction Properties
Transaction properties are key/value pairs. Once set, they remain associated with a transaction during its entire lifetime. They are propagated between machines as the transaction travels through the system. They also are saved in the transaction log, and restored during crash recovery processing.
If a transaction property is set more than once the latest value is retained. However, in some threaded and/or multi-server situations, this behavior may not be predictable.
Key names prefixed with "weblogic.transaction" are reserved for use by Oracle.
Transaction Status
Recovery and audit-trail procedures require more information about a transaction than the JTA Transaction interface furnishes; information such as the transaction identifier, the specific reason for a rollback, and any heuristic error messages. In addition, the time taken by the transaction and the amount of time left can be used as limits on certain operations.
Transaction
Modifier and Type | Field | Description |
---|---|---|
static java.lang.String |
ENLISTMENT_RESOURCE_TYPE |
The transaction property key that is used internally as the
enlisted resource type (such as Weblogic JMS, see ENLISTMENT_RESOURCE_TYPE_WEBLOGIC_JMS)
for a transaction.
|
static java.lang.String |
ENLISTMENT_RESOURCE_TYPE_WEBLOGIC_JMS |
A transaction value to the ENLISTMENT_RESOURCE_TYPE key
indicating the enlisted resource is a WebLogic JMS resource
|
static java.lang.String |
TRANSACTION_COMPLETION_TIMEOUT_SECONDS_PROPERTY_KEY |
The transaction property key that is used internally as the
completion-timeout-seconds override for a transaction.
|
static java.lang.String |
TRANSACTION_EAGER_END_ON_DELIST_PROPERTY_KEY |
The transaction property key that is used internally to indicate, via boolean value,
whether XAResource.end must be called immediately rather than deferred.
|
static java.lang.String |
TRANSACTION_NAME_PROPERTY_KEY |
The transaction property key that is used internally to store the
name associated with a transaction.
|
Modifier and Type | Method | Description |
---|---|---|
void |
addProperties(java.util.Map props) |
Adds a set of properties to a transaction by calling setProperty
for all elements of props.
|
boolean |
delistResourceWithProperties(javax.transaction.xa.XAResource xaRes,
int flags,
java.util.Map delistmentProperties) |
Delist a Resource with specific properties in the transaction.
|
boolean |
enlistResource(NonXAResource nxar) |
Enlist a Non-XA Resource in the transaction.
|
boolean |
enlistResourceWithProperties(javax.transaction.xa.XAResource xaRes,
java.util.Map enlistmentProperties) |
Enlist a Resource with specific properties in the transaction.
|
java.lang.String |
getHeuristicErrorMessage() |
Returns the heuristic error message (if any) associated with the
transaction.
|
long |
getMillisSinceBegin() |
Returns the amount of time, in milliseconds, that the transaction
has been in existence.
|
java.lang.String |
getName() |
Retrieves the name previously associated with a transaction.
|
java.util.Map |
getProperties() |
Gets all properties currently associated with a transaction.
|
java.io.Serializable |
getProperty(java.lang.String key) |
Gets the value of a specific property.
|
java.lang.Throwable |
getRollbackReason() |
Retrieves the rollback reason (if any)
associated with the transaction.
|
java.lang.String |
getStatusAsString() |
Returns the status of the transaction as a string.
|
long |
getTimeToLiveMillis() |
Returns the amount of time, in milliseconds, that the transaction
has left to go.
|
javax.transaction.xa.Xid |
getXid() |
|
javax.transaction.xa.Xid |
getXID() |
Gets the transaction identifier.
|
boolean |
isTimedOut() |
Returns true if the transaction has timed out, false otherwise.
|
boolean |
isTxAsyncTimeout() |
|
void |
setName(java.lang.String n) |
Associates a name with a transaction.
|
void |
setProperty(java.lang.String key,
java.io.Serializable value) |
Sets a property value to be associated with a transaction.
|
void |
setRollbackOnly(java.lang.String msg) |
Wraps the rollback string message and calls
setRollbackOnly with this new message.
|
void |
setRollbackOnly(java.lang.String msg,
java.lang.Throwable reason) |
Wraps the rollback string message and the exception and calls
setRollbackOnly with this new exception.
|
void |
setRollbackOnly(java.lang.Throwable reason) |
Provides a reason for the rollback.
|
static final java.lang.String TRANSACTION_NAME_PROPERTY_KEY
static final java.lang.String TRANSACTION_COMPLETION_TIMEOUT_SECONDS_PROPERTY_KEY
static final java.lang.String ENLISTMENT_RESOURCE_TYPE
static final java.lang.String ENLISTMENT_RESOURCE_TYPE_WEBLOGIC_JMS
static final java.lang.String TRANSACTION_EAGER_END_ON_DELIST_PROPERTY_KEY
void setName(java.lang.String n)
java.lang.String getName()
void setProperty(java.lang.String key, java.io.Serializable value)
key
- A string keyvalue
- Property value, null means deletevoid addProperties(java.util.Map props)
props
- Set of key/value pairs to addjava.io.Serializable getProperty(java.lang.String key)
key
- Property namejava.util.Map getProperties()
void setRollbackOnly(java.lang.Throwable reason)
reason
- the reason behind the rollback.void setRollbackOnly(java.lang.String msg, java.lang.Throwable reason)
reason
- the reason behind the rollback.setRollbackOnly(Throwable)
void setRollbackOnly(java.lang.String msg)
msg
- the message behind the rollback.setRollbackOnly(Throwable)
java.lang.Throwable getRollbackReason()
setRollbackOnly(Throwable reason)
java.lang.String getHeuristicErrorMessage()
javax.transaction.xa.Xid getXID()
javax.transaction.xa.Xid getXid()
getXID()
java.lang.String getStatusAsString()
long getMillisSinceBegin()
long getTimeToLiveMillis()
boolean isTimedOut()
boolean isTxAsyncTimeout()
boolean enlistResourceWithProperties(javax.transaction.xa.XAResource xaRes, java.util.Map enlistmentProperties) throws javax.transaction.RollbackException, java.lang.IllegalStateException, javax.transaction.SystemException
javax.transaction.RollbackException
java.lang.IllegalStateException
javax.transaction.SystemException
boolean enlistResource(NonXAResource nxar) throws javax.transaction.RollbackException, java.lang.IllegalStateException, javax.transaction.SystemException
javax.transaction.RollbackException
java.lang.IllegalStateException
javax.transaction.SystemException
boolean delistResourceWithProperties(javax.transaction.xa.XAResource xaRes, int flags, java.util.Map delistmentProperties) throws java.lang.IllegalStateException, javax.transaction.SystemException
java.lang.IllegalStateException
javax.transaction.SystemException