javax.persistence
Интерфейс EntityManager


public interface EntityManager

Интерфейс, используемый, чтобы взаимодействовать с контекстом персистентности.

EntityManager экземпляр связывается с контекстом персистентности. Контекст персистентности является рядом экземпляров объекта в который для любых персистентных идентификационных данных объекта есть уникальный экземпляр объекта. В пределах контекста персистентности управляют экземплярами объекта и их жизненным циклом. EntityManager API используется, чтобы создать и удалить персистентные экземпляры объекта, найти объекты их первичным ключом, и запросить по объектам.

Набор объектов, которыми можно управлять данным EntityManager экземпляр определяется модулем персистентности. Модуль персистентности определяет набор всех классов, которые связываются или группируются приложением, и которые должны быть colocated в их отображении на единственную базу данных.

С тех пор:
Персистентность Java 1.0
См. Также:
Query, TypedQuery, CriteriaQuery, PersistenceContext

Сводка метода
 void clear()
          Очистите контекст персистентности, заставляя все управляемые объекты стать отсоединенными.
 void close()
          Закройте управляемого приложением менеджера по объекту.
 boolean contains(java.lang.Object entity)
          Проверьте, является ли экземпляр управляемым экземпляром объекта, принадлежащим текущему контексту персистентности.
 Запрос createNamedQuery(java.lang.String name)
          Создайте экземпляр Query для того, чтобы выполнить именованный запрос (в языке запросов Персистентности Java или в собственном SQL).
<T> TypedQuery<T>
createNamedQuery(java.lang.String name, java.lang.Class<T> resultClass)
          Создайте экземпляр TypedQuery для того, чтобы выполнить язык запросов Персистентности Java, названный запросом.
 Запрос createNativeQuery(java.lang.String sqlString)
          Создайте экземпляр Query для того, чтобы выполнить собственный SQL-оператор, например, для обновления или удаляют.
 Запрос createNativeQuery(java.lang.String sqlString, java.lang.Class resultClass)
          Создайте экземпляр Query для того, чтобы выполнить собственный SQL-запрос.
 Запрос createNativeQuery(java.lang.String sqlString, java.lang.String resultSetMapping)
          Создайте экземпляр Query для того, чтобы выполнить собственный SQL-запрос.
<T> TypedQuery<T>
createQuery(CriteriaQuery<T> criteriaQuery)
          Создайте экземпляр TypedQuery для того, чтобы выполнить запрос критериев.
 Запрос createQuery(java.lang.String qlString)
          Создайте экземпляр Query для того, чтобы выполнить оператор языка запросов Персистентности Java.
<T> TypedQuery<T>
createQuery(java.lang.String qlString, java.lang.Class<T> resultClass)
          Создайте экземпляр TypedQuery для того, чтобы выполнить оператор языка запросов Персистентности Java.
 void detach(java.lang.Object entity)
          Удалите данный объект из контекста персистентности, заставляя управляемый объект стать отсоединенными.
<T> T
find(java.lang.Class<T> entityClass, java.lang.Object primaryKey)
          Найдите первичным ключом.
<T> T
find(java.lang.Class<T> entityClass, java.lang.Object primaryKey, LockModeType lockMode)
          Найдите первичным ключом и блокировкой.
<T> T
find(java.lang.Class<T> entityClass, java.lang.Object primaryKey, LockModeType lockMode, java.util.Map<java.lang.String,java.lang.Object> properties)
          Найдите первичным ключом и блокировкой, используя указанные свойства.
<T> T
find(java.lang.Class<T> entityClass, java.lang.Object primaryKey, java.util.Map<java.lang.String,java.lang.Object> properties)
          Найдите первичным ключом, используя указанные свойства.
 void flush()
          Синхронизируйте контекст персистентности с базовой базой данных.
 CriteriaBuilder getCriteriaBuilder()
          Возвратите экземпляр CriteriaBuilder для создания CriteriaQuery объекты.
 java.lang.Object getDelegate()
          Возвратите базовый объект провайдера для EntityManager, при наличии.
 EntityManagerFactory getEntityManagerFactory()
          Возвратите менеджера по объекту фабрика для менеджера по объекту.
 FlushModeType getFlushMode()
          Получите режим сброса, который применяется ко всем объектам, содержавшимся в контексте персистентности.
 LockModeType getLockMode(java.lang.Object entity)
          Получите текущий режим блокировки для экземпляра объекта.
 Метамодель getMetamodel()
          Возвратите экземпляр Metamodel интерфейс для доступа к метамодели модуля персистентности.
 java.util.Map<java.lang.String,java.lang.Object> getProperties()
          Получите свойства и подсказки и присваиваемые значения, которые являются в действительности для менеджера по объекту.
<T> T
getReference(java.lang.Class<T> entityClass, java.lang.Object primaryKey)
          Получите экземпляр, состояние которого может быть лениво выбрано.
 EntityTransaction getTransaction()
          Возвратите на уровне ресурса EntityTransaction объект.
 boolean isOpen()
          Определите, открыт ли менеджер по объекту.
 void joinTransaction()
          Укажите менеджеру по объекту, что транзакция JTA является активной.
 void lock(java.lang.Object entity, LockModeType lockMode)
          Заблокируйте экземпляр объекта, который содержится в контексте персистентности с указанным типом режима блокировки.
 void lock(java.lang.Object entity, LockModeType lockMode, java.util.Map<java.lang.String,java.lang.Object> properties)
          Заблокируйте экземпляр объекта, который содержится в контексте персистентности с указанным типом режима блокировки и с указанными свойствами.
<T> T
merge(T entity)
          Объедините состояние данного объекта в текущий контекст персистентности.
 void persist(java.lang.Object entity)
          Сделайте экземпляр управляемым и персистентным.
 void refresh(java.lang.Object entity)
          Обновите состояние экземпляра от базы данных, перезаписывая изменения, произведенные в объекте, если любой.
 void refresh(java.lang.Object entity, LockModeType lockMode)
          Обновите состояние экземпляра от базы данных, перезаписывая изменения, произведенные в объекте, если таковые вообще имеются, и заблокируйте это относительно данного типа режима блокировки.
 void refresh(java.lang.Object entity, LockModeType lockMode, java.util.Map<java.lang.String,java.lang.Object> properties)
          Обновите состояние экземпляра от базы данных, перезаписывая изменения, произведенные в объекте, если таковые вообще имеются, и заблокируйте это относительно данного типа режима блокировки и с указанными свойствами.
 void refresh(java.lang.Object entity, java.util.Map<java.lang.String,java.lang.Object> properties)
          Обновите состояние экземпляра от базы данных, используя указанные свойства, и перезаписывая изменения, произведенные в объекте, если любой.
 void remove(java.lang.Object entity)
          Удалите экземпляр объекта.
 void setFlushMode(FlushModeType flushMode)
          Установите режим сброса, который применяется ко всем объектам, содержавшимся в контексте персистентности.
 void setProperty(java.lang.String propertyName, java.lang.Object value)
          Установите менеджера по объекту свойство или подсказка.
<T> T
unwrap(java.lang.Class<T> cls)
          Возвратите объект указанного типа предоставить доступ к специфичному для провайдера API.
 

Деталь метода

сохраниться

void persist(java.lang.Object entity)
Сделайте экземпляр управляемым и персистентным.

Параметры:
entity - экземпляр объекта
Броски:
EntityExistsException - если объект уже существует. (Если объект уже существует, EntityExistsException может быть брошен, когда сохранять работа вызывается, или EntityExistsException или другой PersistenceException может быть брошен во время фиксации или сбросе.)
IllegalArgumentException - если экземпляр не является объектом
TransactionRequiredException - если вызвано на управляемого контейнером менеджера по объекту типа PersistenceContextType.TRANSACTION и нет никакой транзакции

слияние

<T> T merge(T entity)
Объедините состояние данного объекта в текущий контекст персистентности.

Параметры:
entity - экземпляр объекта
Возвраты:
управляемый экземпляр, с которым было объединено состояние
Броски:
IllegalArgumentException - если экземпляр не является объектом или является удаленным объектом
TransactionRequiredException - если вызвано на управляемого контейнером менеджера по объекту типа PersistenceContextType.TRANSACTION и нет никакой транзакции

удалить

void remove(java.lang.Object entity)
Удалите экземпляр объекта.

Параметры:
entity - экземпляр объекта
Броски:
IllegalArgumentException - если экземпляр не является объектом или является отсоединенным объектом
TransactionRequiredException - если вызвано на управляемого контейнером менеджера по объекту типа PersistenceContextType.TRANSACTION и нет никакой транзакции

найти

<T> T find(java.lang.Class<T> entityClass,
           java.lang.Object primaryKey)
Найдите первичным ключом. Ищите объект указанного class и первичного ключа. Если экземпляр объекта содержится в контексте персистентности, он возвращается оттуда.

Параметры:
entityClass - объект class
primaryKey - первичный ключ
Возвраты:
найденный экземпляр объекта или нуль, если объект не существует
Броски:
IllegalArgumentException - если первый параметр не обозначает тип объекта, или второй параметр, не допустимый тип для этого entity’s первичный ключ или нуль

найти

<T> T find(java.lang.Class<T> entityClass,
           java.lang.Object primaryKey,
           java.util.Map<java.lang.String,java.lang.Object> properties)
Найдите первичным ключом, используя указанные свойства. Ищите объект указанного class и первичного ключа. Если экземпляр объекта содержится в контексте персистентности, он возвращается оттуда. Если специфичное для поставщика свойство или подсказка не распознаются, это тихо игнорируется.

Параметры:
entityClass - объект class
primaryKey - первичный ключ
properties - стандартные и специфичные для поставщика свойства и подсказки
Возвраты:
найденный экземпляр объекта или нуль, если объект не существует
Броски:
IllegalArgumentException - если первый параметр не обозначает тип объекта, или второй параметр, не допустимый тип для этого entity’s первичный ключ или нуль
С тех пор:
Персистентность Java 2.0

найти

<T> T find(java.lang.Class<T> entityClass,
           java.lang.Object primaryKey,
           LockModeType lockMode)
Найдите первичным ключом и блокировкой. Ищите объект указанного class и первичного ключа и заблокируйте это относительно указанного типа блокировки. Если экземпляр объекта содержится в контексте персистентности, он возвращается оттуда, и эффект этого метода является тем же самым, как будто метод блокировки вызвали на объекте.

Если объект находится в пределах контекста персистентности, и тип режима блокировки пессимистичен, и у объекта есть атрибут версии, провайдер персистентности должен выполнить оптимистические проверки версии, получая блокировку базы данных. Если эти проверки перестали работать, OptimisticLockException будет брошен.

Если тип режима блокировки пессимистичен, и экземпляр объекта находится, но не может быть заблокирован:

Параметры:
entityClass - объект class
primaryKey - первичный ключ
lockMode - режим блокировки
Возвраты:
найденный экземпляр объекта или нуль, если объект не существует
Броски:
IllegalArgumentException - если первый параметр не обозначает тип объекта, или второй параметр не является допустимым типом для первичного ключа того объекта или является нулем
TransactionRequiredException - если нет никакой транзакции, и режим блокировки ни кроме ОДНОГО не определяется
OptimisticLockException - если оптимистическая проверка версии перестала работать
PessimisticLockException - если пессимистические сбои блокировки и транзакция откатываются
LockTimeoutException - если пессимистические сбои блокировки и только оператор откатываются
PersistenceException - если неподдерживаемый вызов блокировки выполняется
С тех пор:
Персистентность Java 2.0

найти

<T> T find(java.lang.Class<T> entityClass,
           java.lang.Object primaryKey,
           LockModeType lockMode,
           java.util.Map<java.lang.String,java.lang.Object> properties)
Найдите первичным ключом и блокировкой, используя указанные свойства. Ищите объект указанного class и первичного ключа и заблокируйте это относительно указанного типа блокировки. Если экземпляр объекта содержится в контексте персистентности, он возвращается оттуда.

Если объект находится в пределах контекста персистентности, и тип режима блокировки пессимистичен, и у объекта есть атрибут версии, провайдер персистентности должен выполнить оптимистические проверки версии, получая блокировку базы данных. Если эти проверки перестали работать, OptimisticLockException будет брошен.

Если тип режима блокировки пессимистичен, и экземпляр объекта находится, но не может быть заблокирован:

Если специфичное для поставщика свойство или подсказка не распознаются, это тихо игнорируется.

Переносимые приложения не должны положиться на стандартную подсказку тайм-аута. В зависимости от базы данных в использовании и механизмах блокировки, используемых провайдером, подсказка может или не может наблюдаться.

Параметры:
entityClass - объект class
primaryKey - первичный ключ
lockMode - режим блокировки
properties - стандартные и специфичные для поставщика свойства и подсказки
Возвраты:
найденный экземпляр объекта или нуль, если объект не существует
Броски:
IllegalArgumentException - если первый параметр не обозначает тип объекта, или второй параметр не является допустимым типом для первичного ключа того объекта или является нулем
TransactionRequiredException - если нет никакой транзакции и режима блокировки кроме NONE определяется
OptimisticLockException - если оптимистическая проверка версии перестала работать
PessimisticLockException - если пессимистические сбои блокировки и транзакция откатываются
LockTimeoutException - если пессимистические сбои блокировки и только оператор откатываются
PersistenceException - если неподдерживаемый вызов блокировки выполняется
С тех пор:
Персистентность Java 2.0

getReference

<T> T getReference(java.lang.Class<T> entityClass,
                   java.lang.Object primaryKey)
Получите экземпляр, состояние которого может быть лениво выбрано. Если требуемый экземпляр не существует в базе данных, EntityNotFoundException бросается, когда к состоянию экземпляра сначала получают доступ. (Времени выполнения провайдера персистентности разрешают бросить EntityNotFoundException когда getReference вызывается.) Приложение не должно ожидать, что состояние экземпляра будет доступно после отсоединения, если к этому не получило доступ приложение, в то время как менеджер по объекту был открыт.

Параметры:
entityClass - объект class
primaryKey - первичный ключ
Возвраты:
найденный экземпляр объекта
Броски:
IllegalArgumentException - если первый параметр не обозначает тип объекта, или второй параметр не является допустимым типом для этого entity’s первичный ключ или является нулем
EntityNotFoundException - если к состоянию объекта нельзя получить доступ

сброс

void flush()
Синхронизируйте контекст персистентности с базовой базой данных.

Броски:
TransactionRequiredException - если нет никакой транзакции
PersistenceException - если сброс перестал работать

setFlushMode

void setFlushMode(FlushModeType flushMode)
Установите режим сброса, который применяется ко всем объектам, содержавшимся в контексте персистентности.

Параметры:
flushMode - режим сброса

getFlushMode

FlushModeType getFlushMode()
Получите режим сброса, который применяется ко всем объектам, содержавшимся в контексте персистентности.

Возвраты:
flushMode

блокировка

void lock(java.lang.Object entity,
          LockModeType lockMode)
Заблокируйте экземпляр объекта, который содержится в контексте персистентности с указанным типом режима блокировки.

Если пессимистический тип режима блокировки определяется, и объект содержит атрибут версии, провайдер персистентности должен также выполнить оптимистические проверки версии, получая блокировку базы данных. Если эти проверки перестали работать, OptimisticLockException будет брошен.

Если тип режима блокировки пессимистичен, и экземпляр объекта находится, но не может быть заблокирован:

Параметры:
entity - экземпляр объекта
lockMode - режим блокировки
Броски:
IllegalArgumentException - если экземпляр не является объектом или является отсоединенным объектом
TransactionRequiredException - если нет никакой транзакции
EntityNotFoundException - если объект не существует в базе данных, когда пессимистическая блокировка выполняется
OptimisticLockException - если оптимистическая проверка версии перестала работать
PessimisticLockException - если пессимистические сбои блокировки и транзакция откатываются
LockTimeoutException - если пессимистические сбои блокировки и только оператор откатываются
PersistenceException - если неподдерживаемый вызов блокировки выполняется

блокировка

void lock(java.lang.Object entity,
          LockModeType lockMode,
          java.util.Map<java.lang.String,java.lang.Object> properties)
Заблокируйте экземпляр объекта, который содержится в контексте персистентности с указанным типом режима блокировки и с указанными свойствами.

Если пессимистический тип режима блокировки определяется, и объект содержит атрибут версии, провайдер персистентности должен также выполнить оптимистические проверки версии, получая блокировку базы данных. Если эти проверки перестали работать, OptimisticLockException будет брошен.

Если тип режима блокировки пессимистичен, и экземпляр объекта находится, но не может быть заблокирован:

Если специфичное для поставщика свойство или подсказка не распознаются, это тихо игнорируется.

Переносимые приложения не должны положиться на стандартную подсказку тайм-аута. В зависимости от базы данных в использовании и механизмах блокировки, используемых провайдером, подсказка может или не может наблюдаться.

Параметры:
entity - экземпляр объекта
lockMode - режим блокировки
properties - стандартные и специфичные для поставщика свойства и подсказки
Броски:
IllegalArgumentException - если экземпляр не является объектом или является отсоединенным объектом
TransactionRequiredException - если нет никакой транзакции
EntityNotFoundException - если объект не существует в базе данных, когда пессимистическая блокировка выполняется
OptimisticLockException - если оптимистическая проверка версии перестала работать
PessimisticLockException - если пессимистические сбои блокировки и транзакция откатываются
LockTimeoutException - если пессимистические сбои блокировки и только оператор откатываются
PersistenceException - если неподдерживаемый вызов блокировки выполняется
С тех пор:
Персистентность Java 2.0

обновление

void refresh(java.lang.Object entity)
Обновите состояние экземпляра от базы данных, перезаписывая изменения, произведенные в объекте, если любой.

Параметры:
entity - экземпляр объекта
Броски:
IllegalArgumentException - если экземпляр не является объектом, или объектом не управляют
TransactionRequiredException - если вызвано на управляемого контейнером менеджера по объекту типа PersistenceContextType.TRANSACTION и нет никакой транзакции
EntityNotFoundException - если объект больше не существует в базе данных

обновление

void refresh(java.lang.Object entity,
             java.util.Map<java.lang.String,java.lang.Object> properties)
Обновите состояние экземпляра от базы данных, используя указанные свойства, и перезаписывая изменения, произведенные в объекте, если любой.

Если специфичное для поставщика свойство или подсказка не распознаются, это тихо игнорируется.

Параметры:
entity - экземпляр объекта
properties - стандартные и специфичные для поставщика свойства и подсказки
Броски:
IllegalArgumentException - если экземпляр не является объектом, или объектом не управляют
TransactionRequiredException - если вызвано на управляемого контейнером менеджера по объекту типа PersistenceContextType.TRANSACTION и нет никакой транзакции
EntityNotFoundException - если объект больше не существует в базе данных
С тех пор:
Персистентность Java 2.0

обновление

void refresh(java.lang.Object entity,
             LockModeType lockMode)
Обновите состояние экземпляра от базы данных, перезаписывая изменения, произведенные в объекте, если таковые вообще имеются, и заблокируйте это относительно данного типа режима блокировки.

Если тип режима блокировки пессимистичен, и экземпляр объекта находится, но не может быть заблокирован:

Параметры:
entity - экземпляр объекта
lockMode - режим блокировки
Броски:
IllegalArgumentException - если экземпляр не является объектом, или объектом не управляют
TransactionRequiredException - если нет никакой транзакции и если вызвано на управляемый контейнером EntityManager экземпляр с PersistenceContextType.TRANSACTION или с режимом блокировки кроме NONE
EntityNotFoundException - если объект больше не существует в базе данных
PessimisticLockException - если пессимистические сбои блокировки и транзакция откатываются
LockTimeoutException - если пессимистические сбои блокировки и только оператор откатываются
PersistenceException - если неподдерживаемый вызов блокировки выполняется
С тех пор:
Персистентность Java 2.0

обновление

void refresh(java.lang.Object entity,
             LockModeType lockMode,
             java.util.Map<java.lang.String,java.lang.Object> properties)
Обновите состояние экземпляра от базы данных, перезаписывая изменения, произведенные в объекте, если таковые вообще имеются, и заблокируйте это относительно данного типа режима блокировки и с указанными свойствами.

Если тип режима блокировки пессимистичен, и экземпляр объекта находится, но не может быть заблокирован:

Если специфичное для поставщика свойство или подсказка не распознаются, это тихо игнорируется.

Переносимые приложения не должны положиться на стандартную подсказку тайм-аута. В зависимости от базы данных в использовании и механизмах блокировки, используемых провайдером, подсказка может или не может наблюдаться.

Параметры:
entity - экземпляр объекта
lockMode - режим блокировки
properties - стандартные и специфичные для поставщика свойства и подсказки
Броски:
IllegalArgumentException - если экземпляр не является объектом, или объектом не управляют
TransactionRequiredException - если нет никакой транзакции и если вызвано на управляемый контейнером EntityManager экземпляр с PersistenceContextType.TRANSACTION или с режимом блокировки кроме NONE
EntityNotFoundException - если объект больше не существует в базе данных
PessimisticLockException - если пессимистические сбои блокировки и транзакция откатываются
LockTimeoutException - если пессимистические сбои блокировки и только оператор откатываются
PersistenceException - если неподдерживаемый вызов блокировки выполняется
С тех пор:
Персистентность Java 2.0

очистить

void clear()
Очистите контекст персистентности, заставляя все управляемые объекты стать отсоединенными. Изменения, произведенные в объектах, которые не были сброшены к базе данных, не будут сохранены.


отсоединение

void detach(java.lang.Object entity)
Удалите данный объект из контекста персистентности, заставляя управляемый объект стать отсоединенными. Несброшенные изменения, произведенные в объекте, если кто-либо (включая удаление объекта), не будут синхронизироваться с базой данных. Объекты, которые ранее сослались на отсоединенный объект, будут продолжать ссылаться на него.

Параметры:
entity - экземпляр объекта
Броски:
IllegalArgumentException - если экземпляр не является объектом
С тех пор:
Персистентность Java 2.0

содержит

boolean contains(java.lang.Object entity)
Проверьте, является ли экземпляр управляемым экземпляром объекта, принадлежащим текущему контексту персистентности.

Параметры:
entity - экземпляр объекта
Возвраты:
булево указание, если объект находится в контексте персистентности
Броски:
IllegalArgumentException - если не объект

getLockMode

LockModeType getLockMode(java.lang.Object entity)
Получите текущий режим блокировки для экземпляра объекта.

Параметры:
entity - экземпляр объекта
Возвраты:
режим блокировки
Броски:
TransactionRequiredException - если нет никакой транзакции
IllegalArgumentException - если экземпляр не является управляемым объектом, и транзакция является активной
С тех пор:
Персистентность Java 2.0

setProperty

void setProperty(java.lang.String propertyName,
                 java.lang.Object value)
Установите менеджера по объекту свойство или подсказка. Если специфичное для поставщика свойство или подсказка не распознаются, это тихо игнорируется.

Параметры:
propertyName - имя свойства или подсказки
value - значение для свойства или подсказки
Броски:
IllegalArgumentException - если второй параметр не допустим для реализации
С тех пор:
Персистентность Java 2.0

getProperties

java.util.Map<java.lang.String,java.lang.Object> getProperties()
Получите свойства и подсказки и присваиваемые значения, которые являются в действительности для менеджера по объекту. Изменение содержания карты не изменяет конфигурацию в действительности.

Возвраты:
карта свойств и подсказок в действительности для менеджера по объекту
С тех пор:
Персистентность Java 2.0

createQuery

Query createQuery(java.lang.String qlString)
Создайте экземпляр Query для того, чтобы выполнить оператор языка запросов Персистентности Java.

Параметры:
qlString - Персистентность Java запрашивает строку
Возвраты:
новый экземпляр запроса
Броски:
IllegalArgumentException - если строка запроса, как находят, недопустима

createQuery

<T> TypedQuery<T> createQuery(CriteriaQuery<T> criteriaQuery)
Создайте экземпляр TypedQuery для того, чтобы выполнить запрос критериев.

Параметры:
criteriaQuery - критерии запрашивают объект
Возвраты:
новый экземпляр запроса
Броски:
IllegalArgumentException - если запрос критериев, как находят, недопустим
С тех пор:
Персистентность Java 2.0

createQuery

<T> TypedQuery<T> createQuery(java.lang.String qlString,
                              java.lang.Class<T> resultClass)
Создайте экземпляр TypedQuery для того, чтобы выполнить оператор языка запросов Персистентности Java. Список выборки запроса должен содержать только единственный элемент, который должен быть присваиваемым типу, определенному resultClass параметр.

Параметры:
qlString - Персистентность Java запрашивает строку
resultClass - тип результата запроса
Возвраты:
новый экземпляр запроса
Броски:
IllegalArgumentException - если строка запроса, как находят, недопустима или если результат запроса, как находят, не присваиваем указанному типу
С тех пор:
Персистентность Java 2.0

createNamedQuery

Query createNamedQuery(java.lang.String name)
Создайте экземпляр Query для того, чтобы выполнить именованный запрос (в языке запросов Персистентности Java или в собственном SQL).

Параметры:
name - имя запроса определяется в метаданных
Возвраты:
новый экземпляр запроса
Броски:
IllegalArgumentException - если запрос не был определен с помощью имени или если строка запроса, как находят, недопустима

createNamedQuery

<T> TypedQuery<T> createNamedQuery(java.lang.String name,
                                   java.lang.Class<T> resultClass)
Создайте экземпляр TypedQuery для того, чтобы выполнить язык запросов Персистентности Java, названный запросом. Список выборки запроса должен содержать только единственный элемент, который должен быть присваиваемым типу, определенному resultClass параметр.

Параметры:
name - имя запроса определяется в метаданных
resultClass - тип результата запроса
Возвраты:
новый экземпляр запроса
Броски:
IllegalArgumentException - если запрос не был определен с помощью имени или если строка запроса, как находят, недопустима или если результат запроса, как находят, не присваиваем указанному типу
С тех пор:
Персистентность Java 2.0

createNativeQuery

Query createNativeQuery(java.lang.String sqlString)
Создайте экземпляр Query для того, чтобы выполнить собственный SQL-оператор, например, для обновления или удаляют.

Параметры:
sqlString - собственная строка SQL-запроса
Возвраты:
новый экземпляр запроса

createNativeQuery

Query createNativeQuery(java.lang.String sqlString,
                        java.lang.Class resultClass)
Создайте экземпляр Query для того, чтобы выполнить собственный SQL-запрос.

Параметры:
sqlString - собственная строка SQL-запроса
resultClass - class результирующего экземпляра (ов)
Возвраты:
новый экземпляр запроса

createNativeQuery

Query createNativeQuery(java.lang.String sqlString,
                        java.lang.String resultSetMapping)
Создайте экземпляр Query для того, чтобы выполнить собственный SQL-запрос.

Параметры:
sqlString - собственная строка SQL-запроса
resultSetMapping - имя отображения набора результатов
Возвраты:
новый экземпляр запроса

joinTransaction

void joinTransaction()
Укажите менеджеру по объекту, что транзакция JTA является активной. Этот метод нужно вызвать на приложении JTA управляемым менеджером по объекту, который создавался вне контекста активной транзакции, чтобы связать его с текущей транзакцией JTA.

Броски:
TransactionRequiredException - если нет никакой транзакции

развернуть

<T> T unwrap(java.lang.Class<T> cls)
Возвратите объект указанного типа предоставить доступ к специфичному для провайдера API. Если провайдер EntityManager реализация не поддерживает указанный class, PersistenceException бросается.

Параметры:
cls - class объекта, который будет возвращен. Это - обычно любой базовое EntityManager class реализации или интерфейс, который это реализует.
Возвраты:
экземпляр указанного class
Броски:
PersistenceException - если провайдер не поддерживает вызов
С тех пор:
Персистентность Java 2.0

getDelegate

java.lang.Object getDelegate()
Возвратите базовый объект провайдера для EntityManager, при наличии. Результатом этого метода является определенная реализация. unwrap метод должен быть предпочтен для новых приложений.

Возвраты:
базовый объект провайдера для EntityManager

близко

void close()
Закройте управляемого приложением менеджера по объекту. После того, как близкий метод был вызван, все методы на EntityManager экземпляр и любой Query и TypedQuery объекты, полученные из этого, бросят IllegalStateException за исключением getProperties, getTransaction, и isOpen (который возвратит false). Если этот метод вызывают, когда менеджер по объекту связывается с активной транзакцией, контекст персистентности остается управляемым, пока транзакция не завершается.

Броски:
IllegalStateException - если менеджер по объекту управляется контейнером

isOpen

boolean isOpen()
Определите, открыт ли менеджер по объекту.

Возвраты:
истина, пока менеджер по объекту не был закрыт

getTransaction

EntityTransaction getTransaction()
Возвратите на уровне ресурса EntityTransaction объект. EntityTransaction экземпляр может использоваться последовательно, чтобы начать и фиксировать многократные транзакции.

Возвраты:
Экземпляр EntityTransaction
Броски:
IllegalStateException - если вызвано на менеджера по объекту JTA

getEntityManagerFactory

EntityManagerFactory getEntityManagerFactory()
Возвратите менеджера по объекту фабрика для менеджера по объекту.

Возвраты:
Экземпляр EntityManagerFactory
Броски:
IllegalStateException - если менеджер по объекту был закрыт
С тех пор:
Персистентность Java 2.0

getCriteriaBuilder

CriteriaBuilder getCriteriaBuilder()
Возвратите экземпляр CriteriaBuilder для создания CriteriaQuery объекты.

Возвраты:
Экземпляр CriteriaBuilder
Броски:
IllegalStateException - если менеджер по объекту был закрыт
С тех пор:
Персистентность Java 2.0

getMetamodel

Metamodel getMetamodel()
Возвратите экземпляр Metamodel интерфейс для доступа к метамодели модуля персистентности.

Возвраты:
Экземпляр метамодели
Броски:
IllegalStateException - если менеджер по объекту был закрыт
С тех пор:
Персистентность Java 2.0


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter