JPA Interface

EntityTransaction


Interface used to control transactions on resource-local entity managers. The getTransaction() method returns the EntityTransaction interface.
Since:
JPA 1.0
The Database Connection using JPA article explains how to use EntityTransaction.

Public Methods

void begin()
Start a resource transaction.
Throws:
IllegalStateException - if {@link #isActive()} is true
Since:
JPA 1.0
void commit()
Commit the current resource transaction, writing any unflushed changes to the database.
Throws:
IllegalStateException - if {@link #isActive()} is false
RollbackException - if the commit fails
Since:
JPA 1.0
boolean getRollbackOnly()
Determine whether the current resource transaction has been marked for rollback.
Return:
boolean indicating whether the transaction has been marked for rollback
Throws:
IllegalStateException - if {@link #isActive()} is false
Since:
JPA 1.0
Integer getTimeout()
The transaction timeout.
Since:
JPA 3.2
boolean isActive()
Indicate whether a resource transaction is in progress.
Return:
boolean indicating whether transaction is in progress
Throws:
PersistenceException - if an unexpected error condition is encountered
Since:
JPA 1.0
void rollback()
Roll back the current resource transaction.
Throws:
IllegalStateException - if {@link #isActive()} is false
PersistenceException - if an unexpected error condition is encountered
Since:
JPA 1.0
Mark the current resource transaction so that the only possible outcome of the transaction is for the transaction to be rolled back.
Throws:
IllegalStateException - if {@link #isActive()} is false
Since:
JPA 1.0
void setTimeout(Integer timeout)
Set the transaction timeout, in seconds.
This is a hint.
Parameters:
timeout - the timeout, in seconds, or null to indicate that the database server should set the timeout
Since:
JPA 3.2