4.4.3. Интерфейс Persistence

Интерфейс инфраструктуры, являющийся точкой входа в функциональность хранения данных в БД.

Методы интерфейса:

  • createTransaction(), getTransaction() - получить интерфейс управления транзакциями

  • callInTransaction(), runInTransaction() - выполнить код в новой транзакции с возвратом значения или без возврата значения.

  • isInTransaction() - определяет, существует ли в данный момент активная транзакция

  • getEntityManager() - возвращает экземпляр EntityManager для текущей транзакции

  • isSoftDeletion() - позволяет определить, активен ли режим мягкого удаления

  • setSoftDeletion() - устанавливает или отключает режим мягкого удаления. Влияет на аналогичный признак всех создаваемых экземпляров EntityManager. По умолчанию мягкое удаление включено.

  • getDbTypeConverter() - возвращает экземпляр DbTypeConverter для используемой в данный момент базы данных.

  • getDataSource() - получить javax.sql.DataSource для используемой в данный момент базы данных.

    Warning

    Для всех объектов javax.sql.Connection, получаемых методом getDataSource().getConnection(), необходимо после использования соединения вызвать метод close() в секции finally. В противном случае соединение не вернется в пул, через какое-то время пул переполнится, и приложение не сможет выполнять запросы к базе данных.

  • getTools() - возвращает экземпляр интерфейса PersistenceTools (см. ниже).