Jakarta Persistence (JPA) Interface

jakarta.persistence.EntityTransaction


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

Public Instance Methods

void begin()
Start a resource transaction.
Throws:
IllegalStateException - if isActive is true.
Since:
Jakarta Persistence (JPA) 1.0
void commit()
Commit the current resource transaction, writing any unflushed changes to the database.
Throws:
IllegalStateException - if isActive is false.
RollbackException - if the commit fails.
Since:
Jakarta Persistence (JPA) 1.0
boolean getRollbackOnly()
Determine whether the current resource transaction has been marked for rollback.
Returns:
boolean indicating whether the transaction has been marked for rollback.
Throws:
IllegalStateException - if isActive is false.
Since:
Jakarta Persistence (JPA) 1.0
Integer getTimeout()
The transaction timeout.
Since:
Jakarta Persistence (JPA) 3.2
boolean isActive()
Indicate whether a resource transaction is in progress.
Returns:
boolean indicating whether transaction is in progress.
Throws:
PersistenceException - if an unexpected error condition is encountered.
Since:
Jakarta Persistence (JPA) 1.0
void rollback()
Roll back the current resource transaction.
Throws:
IllegalStateException - if isActive is false.
PersistenceException - if an unexpected error condition is encountered.
Since:
Jakarta Persistence (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 isActive is false.
Since:
Jakarta Persistence (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:
Jakarta Persistence (JPA) 3.2