Глава 11. Работа с объектами

1. 11.1. Состояния объектов Hibernate
2. 11.2. Делаем объекты постоянными (persistent)
3. 11.3. Загрузка объекта
4. 11.4. Запросы
   1. 11.4.1. Выполнение запросов
   2. 11.4.2. Фильтрация коллекций
   3. 11.4.3. Запросы Criteria
   4. 11.4.4. Запросы на нативном SQL
5. 11.5. Изменение постоянных объектов
6. 11.6. Изменение отсоединённых (detached) объектов
7. 11.7. Автоматическое обнаружение состояния
8. 11.8. Удаление постоянных объектов
9. 11.9. Репликация объекта между двумя разными хранилищами данных
10. 11.10. Сброс (flush) сессии
11. 11.11. Переходное постоянство (Transitive persistence)
12. 11.12. Использование метаданных

Hibernate — это полное объектно-реляционное решение для отображений, которое не только скрывает от разработчика детали системы управления базами данных, но также предлагает управление состояниями объектов. Это, вместо управления инструкциями SQL на низком уровне, даёт возможность работать с JDBC/SQL на высоком уровне в естественном для Java-приложений объектно-ориентированным стиле.

Другими словами, разработчики приложений Hibernate всегда должны думать о состоянии своих объектов, а не только о выполнении SQL-инструкций.

11.1. Состояния объектов Hibernate

Hibernate определяет и поддерживает следующие состояния объектов:

• Переходный (Transient) — объект является переходным, если он только что был создан с использованием оператора new и не связан с Hibernate Session. Он не имеет постоянного (persistent) представления в базе данных и ему не присвоено значение идентификатора. Переходные экземпляры будут уничтожены сборщиком мусора, если приложение больше не содержит на них ссылку. Используйте Hibernate Session, чтобы сделать объект постоянным (persistent) (Hibernate позаботится о инструкциях SQL, которые должны быть выполнены для этого перехода).
• Постоянный (Persistent) — экземпляр имеет представление в базе данных и значение идентификатора. Он может быть просто сохранён или загружен, однако он по определению входит в сферу сессии (Session). Hibernate будет обнаруживать любые изменения, сделанные для объекта в постоянном состоянии, и синхронизировать состояние с базой данных, когда единица работы (unit of work) завершается. Разработчики не выполняют вручную инструкции UPDATE или DELETE, когда объект нужно сделать переходным.
• Отсоединённый (Detached) — это объект, который был постоянным, но его сессия закрыта. Ссылка на объект по-прежнему действительна, и отсоединённый экземпляр может быть даже изменён в этом состоянии. Отсоединённый экземпляр может быть повторно присоединён к новой сессии (Session) в более поздний момент времени, делавшись снова (и все изменения) постоянным. Эта особенность позволяет использовать модель программирования для длительных единиц работы, в которых пользователю требуется время для мышления (user think-time). Мы называем их транзакциями приложений, т. е. единицей работы с точки зрения пользователя.

Рассмотрим более подробно состояния и переход состояний (и методы Hibernate, которые инициируют переход).

11.2. Делаем объекты постоянными (persistent)

Вновь сохданные экземпляры постоянного класса считаются переходными по Hibernate. Мы можем сделать переходный экземпляр постоянным, связав его с сессией:

DomesticCat fritz = new DomesticCat();
fritz.setColor(Color.GINGER);
fritz.setSex('M');
fritz.setName("Fritz");
Long generatedId = (Long) sess.save(fritz);

Если у Cat есть сгенерированный идентификатор, идентификатор генерируется и назначается Cat вызовом save(). Если у Cat есть присвоенный (assigned) идентификатор или составной ключ, идентификатор должен быть присвоен экземпляру cat перед вызовом save(). Вы также можете использовать persist() вместо save(), с семантикой, определённой в раннем черновике EJB3.

• persist() делает переходный экземпляр постоянным. Тем не менее, это не гарантирует, что значение идентификатора будет присвоено постоянному экземпляру немедленно, присвоение может произойти во время сброса (flush). persist() также гарантирует, что он не будет выполнять оператор INSERT, если он вызывается за пределами границ транзакции. Это полезно при длительном «общении» с расширенным контекстом Session/persistence.
• save() гарантирует возврат идентификатора. Если INSERT должен быть выполнен для получения идентификатора (например, «идентичность» (identity) генератора, а не «последовательность» (sequence)), этот INSERT происходит немедленно, независимо от того, находитесь ли вы внутри или вне транзакции. Это проблематично при долго идущем «общении» с расширенным контекстом Session/persistence.

В качестве альтернативы вы можете назначить идентификатор, используя перегруженную версию save().

DomesticCat pk = new DomesticCat();
pk.setColor(Color.TABBY);
pk.setSex('F');
pk.setName("PK");
pk.setKittens( new HashSet() );
pk.addKitten(fritz);
sess.save( pk, new Long(1234) );

Если объект, который вы делаете постоянным, имеет связанные объекты (например, коллекция kittens в предыдущем примере), эти объекты могут быть сделаны постоянными в любом порядке, если вы не имеете ограничения NOT NULL для столбца внешнего ключа. Риск нарушить ограничения внешнего ключа никогда не возникнет. Однако вы можете нарушить ограничение NOT NULL, если сохраните объекты вызовом save() в неправильном порядке.

Обычно вы не беспокоитесь об этой детали, так как обычно используете функцию переходного постоянства (transitive persistence) Hibernate для автоматического сохранения связанных объектов. Тогда даже нарушения ограничений NOT NULL не встретятся — Hibernate позаботится обо всём. Переходное постоянство (Transitive persistence) обсуждается далее в этой главе.

11.3. Загрузка объекта

Методы load() из Session предоставляют способ получения постоянного экземпляра, если вы знаете его идентификатор. load() принимает объект класса и загружает состояние в только что созданный экземпляр этого класса в постоянном состоянии.

Cat fritz = (Cat) sess.load(Cat.class, generatedId);

// вам нужно обернуть примитивные идентификаторы
long id = 1234;
DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );

Кроме того, вы можете загрузить состояние в данный экземпляр:

Cat cat = new DomesticCat();
// загрузить состояние в cat
sess.load( cat, new Long(pkId) );
Set kittens = cat.getKittens();

Имейте в виду, что load() выдает невосстанавливаемое исключение, если нет соответствующей записи в базе данных. Если класс отображён на прокси, load() просто возвращает неинициализированный прокси и фактически не попадает в базу данных до тех пор, пока вы не вызовете метод прокси. Это полезно, если вы хотите создать связь с объектом, не загружая его из базы данных. Он также позволяет загружать несколько экземпляров в виде пакета, если batch-size определён для отображения классов.

Если вы не уверены, что существует подходящая запись, вы должны использовать метод get(), который немедленно обратится к базе данных и возвратит null, если нет соответствующей записи.

Cat cat = (Cat) sess.get(Cat.class, id);
if (cat == null) {
    cat = new Cat();
    sess.save(cat, id);
}
return cat;

Вы даже можете загрузить объект, с помощью SQL SELECT ... FOR UPDATE, используя LockMode. Дополнительную информацию см. в документации по API.

Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);

Любые связанные экземпляры или содержащиеся коллекции не будут выбраны FOR UPDATE, если вы не решите указать lock или all как каскадный стиль для ассоциации.

Можно повторно загрузить объект и все его коллекции в любое время, используя метод refresh(). Это полезно, когда триггеры базы данных используются для инициализации некоторых свойств объекта.

sess.save(cat);
sess.flush(); //принудительно выполнить SQL INSERT
sess.refresh(cat); //перечитать состояние (после запуска триггера)

Как много загрузит Hibernate из базы данных и сколько SQL SELECT будут использовано? Это зависит от стратегии выборки (fetching strategy) и объясняется в разделе 20.1 «Стратегии выборки (fetching strategy)».

11.4. Запросы

Если вы не знаете идентификаторы объектов, которые вы ищете, вам нужен запрос. Hibernate поддерживает простой, но мощный объектно-ориентированный язык запросов (HQL). Для создания программных запросов Hibernate поддерживает сложные функциональные возможности: Criteria и Example (QBC и QBE). Вы также можете выразить свой запрос в нативном SQL вашей базы данных, с дополнительной поддержкой Hibernate для преобразования результатов в объекты.

11.4.1. Выполнение запросов

HQL и нативные SQL-запросы представлены экземпляром org.hibernate.Query. Этот интерфейс предлагает методы привязки (binding) параметров, обработки набора результатов и выполнения фактического запроса. Вы всегда получаете Query с использованием текущего Session:

List cats = session.createQuery(
    "from Cat as cat where cat.birthdate < ?")
    .setDate(0, date)
    .list();

List mothers = session.createQuery(
    "select mother from Cat as cat join cat.mother as mother where cat.name = ?")
    .setString(0, name)
    .list();

List kittens = session.createQuery(
    "from Cat as cat where cat.mother = ?")
    .setEntity(0, pk)
    .list();

Cat mother = (Cat) session.createQuery(
    "select cat.mother from Cat as cat where cat = ?")
    .setEntity(0, izi)
    .uniqueResult();]]

Query mothersWithKittens = (Cat) session.createQuery(
    "select mother from Cat as mother left join fetch mother.kittens");
Set uniqueMothers = new HashSet(mothersWithKittens.list());