Помимо Java ORM: что сделал Versant с JPA (часть 1)

Сущность — это в основном легкий постоянный объект домена. Форма сущности определяется в классе с возможностью сохранения (он же класс сущности) путем добавления аннотации @Entity ( примечание 1 ):

Рисунок 1: класс сущностей JPA — это обычный Java-класс с добавлением аннотации @Entity

Традиционно состояние такого объекта будет сохраняться в таблице в реляционной базе данных, в то время как экземпляры такого объекта будут соответствовать отдельным строкам в таблице. Необходимая информация о сопоставлении должна быть добавлена ​​к соединению (или по умолчанию реализацией JPA), чтобы сопоставить объект вашего домена с таблицами.

Можете ли вы представить себе избавление от всех затрат на реляционные ресурсы при использовании JPA? Введите Versant JPA.

Обратите внимание, что в приведенном выше примере Person нам нужны только две аннотации: @Entity и @Id . @Id аннотаций обозначает поле , который будет использоваться для идентичности объекта сущности в хранилище данных (или первичного ключа в реляционной жаргоне). Это действительно все, что вам нужно, чтобы сделать этот класс сущностей, используя Versant JPA. Так как Versant хранит экземпляры класса сущности как объекты, никаких дополнительных аннотаций, указывающих информацию отображения, не требуется.

JPA Persistence Unit — это логическая группа пользовательских персистентных классов со связанными параметрами, такими как соединение с базой данных:

Изображение 2: блок персистентности JPA

В модуле постоянства перечислены классы, поддерживающие постоянство (т.е. классы сущностей), которые составляют модель данных вашего приложения. Это элементы <class>, которые вы можете увидеть в приведенном выше файле persistence.xml . Экземпляры этих классов будут храниться в базе данных, определенной настройкой соединения.

Примечание. Единица постоянства определена в файле XML с именем persistence.xml, который находится в каталоге приложения META_INF .

С JPA объекты класса сущности в вашем приложении управляются EntityManager .   Фабрика менеджеров сущностей отвечает за менеджеров сущностей. Это фабрика, связанная с единицей персистентности через свойство подключения к базе данных Versant

Интерфейс EntityManager в основном предоставляет API для взаимодействия с сущностью. Сущность может находиться в разных состояниях, которые тесно связаны со службами EntityManager :

Изображение 3: Жизненный цикл сущности в JPA

Объекты, созданные впервые, находятся в состоянии «Новый» и не являются частью базы данных, и EntityManager об этом не знает. Когда EntityManager выполняет «постоянную» операцию над объектом, состояние объекта изменяется на «Управляемый». Это должно быть сделано в активной транзакции (см. Транзакции ниже), которая после фиксации эффективно сохранит сущность в базе данных.

Объекты, извлеченные из базы данных (например, с помощью запросов), также находятся в состоянии «Управляемый», поэтому при изменении в транзакции изменения будут сохранены в базе данных при следующем подтверждении.

Операция «удалить» позволяет EntityManager пометить объект для удаления (состояние изменяется с «Управляется» на «Удалено»).
и объект удаляется из базы данных при фиксации).

Наконец, сущности могут быть полностью отключены от EntityManager, поэтому они достигают состояния «Отдельно» (например, сущности переходят в это состояние, когда его EntityManager закрыт).

Наиболее важные сервисы API EntityManager:

• сохраняться — сохраняет новую сущность.
• объединить — обновляет состояние объекта в базе данных.
• detach — отсоединяет объект от базы данных.
• удалить — удаляет экземпляр объекта.

Итак, как мне начать работать с EntityManager в Versant JPA?

Первым делом нужно создать фабрику и сообщить ей, какой постоянный модуль использовать для его конфигурации

EntityManagerFactory emf =

Persistence.createEntityManagerFactory("jpa_tutorial_persist~ ence_unit");

Получившуюся фабрику теперь можно вызвать, чтобы предоставить вам EntityManager:

EntityManager em = emf.createEntityManager(); 

Все модификации постоянных объектов, включая создание новых, производятся в транзакции. Транзакция — это единица работы, выполняемая клиентом, вашим приложением и сервером базы данных.

EntityManager несет ответственность за транзакции. Вы можете получить доступ к транзакции с помощью метода менеджера getTransaction () . Вы работаете с транзакцией, помечая ее начальную и конечную точки методами begin () и commit () :

em.getTransaction().begin();

// do stuff with persistent objects . . .

em.getTransaction().commit();