Overrides org.springframework.orm.jpa.DefaultJpaDialect.beginTransaction.

Implements org.springframework.orm.jpa.JpaDialect.beginTransaction.

Doc from org.springframework.orm.jpa.DefaultJpaDialect.beginTransaction.

This implementation invokes the standard JPA Transaction.begin method. Throws an InvalidIsolationLevelException if a non-default isolation level is set.

This implementation does not return any transaction data Object, since there is no state to be kept for a standard JPA transaction. Hence, subclasses do not have to care about the return value (null) of this implementation and are free to return their own transaction data Object.

Parameters

entityManager:EntityManager

Doc from org.springframework.orm.jpa.JpaDialect.beginTransaction.

the EntityManager to begin a JPA transaction on

definition:TransactionDefinition

Doc from org.springframework.orm.jpa.JpaDialect.beginTransaction.

the Spring transaction definition that defines semantics

Returns:Object

Doc from org.springframework.orm.jpa.JpaDialect.beginTransaction.

an arbitrary object that holds transaction data, if any (to be passed into cleanupTransaction). May implement the org.springframework.transaction.SavepointManager interface.

Annotations

@Override

Exceptions

PersistenceException:

Doc from org.springframework.orm.jpa.JpaDialect.beginTransaction.

if thrown by JPA methods

SQLException:

Doc from org.springframework.orm.jpa.JpaDialect.beginTransaction.

if thrown by JDBC methods

TransactionException:

Doc from org.springframework.orm.jpa.JpaDialect.beginTransaction.

in case of invalid arguments

Overrides org.springframework.orm.jpa.DefaultJpaDialect.cleanupTransaction.

Implements org.springframework.orm.jpa.JpaDialect.cleanupTransaction.

Doc from org.springframework.orm.jpa.DefaultJpaDialect.cleanupTransaction.

This implementation does nothing, since the default beginTransaction implementation does not require any cleanup.

Parameters

transactionData:Object

Doc from org.springframework.orm.jpa.JpaDialect.cleanupTransaction.

arbitrary object that holds transaction data, if any (as returned by beginTransaction or prepareTransaction)

Annotations

@Override

Overrides org.springframework.orm.jpa.DefaultJpaDialect.getJdbcConnection.

Implements org.springframework.orm.jpa.JpaDialect.getJdbcConnection.

Doc from org.springframework.orm.jpa.DefaultJpaDialect.getJdbcConnection.

This implementation always returns null, indicating that no JDBC Connection can be provided.

Parameters

entityManager:EntityManager

Doc from org.springframework.orm.jpa.JpaDialect.getJdbcConnection.

the current JPA EntityManager

readOnly:boolean

Doc from org.springframework.orm.jpa.JpaDialect.getJdbcConnection.

whether the Connection is only needed for read-only purposes

Returns:ConnectionHandle

Doc from org.springframework.orm.jpa.JpaDialect.getJdbcConnection.

a handle for the Connection, to be passed into releaseJdbcConnection, or null if no JDBC Connection can be retrieved

Annotations

@Override

Exceptions

PersistenceException:

Doc from org.springframework.orm.jpa.JpaDialect.getJdbcConnection.

if thrown by JPA methods

SQLException:

Doc from org.springframework.orm.jpa.JpaDialect.getJdbcConnection.

if thrown by JDBC methods

Overrides org.springframework.orm.jpa.DefaultJpaDialect.prepareTransaction.

Implements org.springframework.orm.jpa.JpaDialect.prepareTransaction.

Doc from org.springframework.orm.jpa.JpaDialect.prepareTransaction.

Prepare a JPA transaction, applying the specified semantics. Called by EntityManagerFactoryUtils when enlisting an EntityManager in a JTA transaction or a locally joined transaction (e.g. after upgrading an unsynchronized EntityManager to a synchronized one).

An implementation can apply the read-only flag as flush mode. In that case, a transaction data object can be returned that holds the previous flush mode (and possibly other data), to be reset in cleanupTransaction.

Implementations can also use the Spring transaction name to optimize for specific data access use cases (effectively using the current transaction name as use case identifier).

Parameters

entityManager:EntityManager

the EntityManager to begin a JPA transaction on

readOnly:boolean

whether the transaction is supposed to be read-only

name:String

the name of the transaction (if any)

Returns:Object

an arbitrary object that holds transaction data, if any (to be passed into cleanupTransaction)

Annotations

@Override

Exceptions

PersistenceException:

if thrown by JPA methods

Set the JDBC exception translator for Hibernate exception translation purposes.

Applied to any detected java.sql.SQLException root cause of a Hibernate JDBCException, overriding Hibernate's own SQLException translation (which is based on a Hibernate Dialect for a specific target database).

As of 6.1, also applied to org.hibernate.TransactionException translation with a SQLException root cause (where Hibernate does not translate itself at all), overriding Spring's default SQLExceptionSubclassTranslator there.

Parameters

exceptionTranslator:SQLExceptionTranslator

the SQLExceptionTranslator to delegate to, or null for none. By default, a SQLExceptionSubclassTranslator will be used for org.hibernate.TransactionException translation as of 6.1; this can be reverted to pre-6.1 behavior through setting null here.

Since

5.1

See Also

java.sql.SQLException, org.hibernate.JDBCException, org.springframework.jdbc.support.SQLExceptionSubclassTranslator, org.springframework.jdbc.support.SQLErrorCodeSQLExceptionTranslator

Set whether to prepare the underlying JDBC Connection of a transactional Hibernate Session, that is, whether to apply a transaction-specific isolation level and/or the transaction's read-only flag to the underlying JDBC Connection.

Default is "true". If you turn this flag off, JPA transaction management will not support per-transaction isolation levels anymore. It will not call Connection.setReadOnly(true) for read-only transactions anymore either. If this flag is turned off, no cleanup of a JDBC Connection is required after a transaction, since no Connection settings will get modified.

Since

4.1

See Also

java.sql.Connection#setTransactionIsolation, java.sql.Connection#setReadOnly

Overrides org.springframework.orm.jpa.DefaultJpaDialect.translateExceptionIfPossible.

Implements org.springframework.dao.support.PersistenceExceptionTranslator.translateExceptionIfPossible.

Doc from org.springframework.orm.jpa.DefaultJpaDialect.translateExceptionIfPossible.

This implementation delegates to EntityManagerFactoryUtils.

Parameters

ex:RuntimeException

Doc from org.springframework.dao.support.PersistenceExceptionTranslator.translateExceptionIfPossible.

a RuntimeException to translate

Returns:DataAccessException

Doc from org.springframework.dao.support.PersistenceExceptionTranslator.translateExceptionIfPossible.

the corresponding DataAccessException (or null if the exception could not be translated, as in this case it may result from user code rather than from an actual persistence problem)

Annotations

@Override

@Nullable