Java. Object-oriented mapping. Работаем с чистым Hibernate без прямого использования JDBC.

Этот пост - продолжение предыдущего. Из него используются таблицы в базе.

Если hibernate еще не скачан - делаем это. http://www.hibernate.org/

Настраиваем eclipse, добавляя следующие либы

${Hibernate_Install_Dir}/hibernate3.jar ${Hibernate_Install_Dir}/lib/antlr.jar ${Hibernate_Install_Dir}/lib/asm.jar ${Hibernate_Install_Dir}/lib/asm-attrs.jars ${Hibernate_Install_Dir}/lib/cglib.jar ${Hibernate_Install_Dir}/lib/commons-collections.jar ${Hibernate_Install_Dir}/lib/commons-logging.jar ${Hibernate_Install_Dir}/lib/dom4j.jar ${Hibernate_Install_Dir}/lib/ehcache.jar ${Hibernate_Install_Dir}/lib/jta.jar ${Hibernate_Install_Dir}/lib/log4j.jar

Создаем определения проецирования.

Сперва, попросим Hibernate получить и отправить объект book для нас. Для простоты, проигнорируем таблицы publisher и chapter. Создадим xml файл "Book.hbm.xml". Этот файл ни что иное, как определение проецирования для класса Book. Объекты book именуются "Persistent objects" или "Entites", потому что они могут быть сохранены в базе данных и могут представлять реальные сущности.

Любой хранимый объект должен иметь идентификатор. Он будет использован Hibernate для идентификации того, что объект уникальный. Мы выберем ISBN в роли идентификатора объекта Book.

Настройка Hibernate

Сперва необходимо установить настройки приложения. Например, какой тип объектов сохраняется? Какой тип баз данных используется? Как коннектиться к базе?

Перед тем, как использовать Hibernate  для получения и сохранения объектов, сперва необходимо использовать следующий фрагмент кода для построения "session factory". Фабрика сессий - глобальный объект для обслуживания сессий в Hibernate. Сессия - это как подключение к базе для работы с хранимыми объектами.

import org.hibernate.SessionFactory; import org.hibernate.cfg.Configuration; public class test { public static void main(String[] args) { Configuration configuration = new Configuration().addResource( "com/metaarchit/bookshop/Book.hbm.xml").setProperty( "hibernate.dialect", "org.hibernate.dialect.HSQLDialect") .setProperty("hibernate.connection.driver_class", "org.hsqldb.jdbcDriver").setProperty( "hibernate.connection.url", "jdbc:hsqldb:hsql://localhost/BookShopDB").setProperty( "hibernate.connection.username", "sa").setProperty( "hibernate.connection.password", ""); SessionFactory factory = configuration.buildSessionFactory(); } }

Вместо использования addResource() для добавления файлов проецирования, можно использовать также addClass() для добавления классов.

Configuration configuration = new Configuration() .addClass(com.metaarchit.bookshop.Book.class) .setProperty("hibernate.dialect", "org.hibernate.dialect.HSQLDialect") .setProperty("hibernate.connection.driver_class", "org.hsqldb.jdbcDriver") .setProperty("hibernate.connection.url", "jdbc:hsqldb:hsql://localhost/BookShopDB") .setProperty("hibernate.connection.username", "sa") .setProperty("hibernate.connection.password", ""); SessionFactory factory = configuration.buildSessionFactory();

Если в приложении содержатся сотни определений проецирования, можно запаковать их в jar файл и добавить в конфигурацию Hibernate. 

Configuration configuration = new Configuration() .addJar(new File("mapping.jar")) .setProperty("hibernate.dialect", "org.hibernate.dialect.HSQLDialect") .setProperty("hibernate.connection.driver_class", "org.hsqldb.jdbcDriver") .setProperty("hibernate.connection.url", "jdbc:hsqldb:hsql://localhost/BookShopDB") .setProperty("hibernate.connection.username", "sa") .setProperty("hibernate.connection.password", ""); SessionFactory factory = configuration.buildSessionFactory();

Конфигурация через XML

Другой вариант настройки Hibernate - использование XML файлов. Мы создаем файл hibernate.cfg.xml в корне проекта.

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <property name="connection.driver_class">org.hsqldb.jdbcDriver</property> <property name="connection.url">jdbc:hsqldb:hsql://localhost/BookShopDB</property> <property name="connection.username">sa</property> <property name="connection.password"></property> <property name="dialect">org.hibernate.dialect.HSQLDialect</property> <mapping resource="com/metaarchit/bookshop/Book.hbm.xml" ></mapping> </session-factory> </hibernate-configuration>

В таком случае фрагмент кода для построения фабрики сессии может быть упрощен. 

Configuration configuration = new Configuration().configure(); SessionFactory factory = configuration.buildSessionFactory();

Получение и сохранение объектов

Открытие и закрытие сессий.

Как и в JDBC, есть несколько рутинных действий. Сперва просим у фабрики сессий открыть новую сессию для нас. После окончания работы, мы должны помнить о том, чтобы его закрыть. 

Session session = factory.openSession(); try { // Using the session to retrieve objects } finally { session.close(); }

Получение объектов

Задав идентификатор (в нашем случае ISBN), можно получить книгу из базы данных. Есть два варианта как это сделать:

Book book = (Book) session.load(Book.class, isbn);

или

Book book = (Book) session.get(Book.class, isbn);

Разница между load() и get() заключается в том, что в случае, когда ID не может быть найден, load() выкинет исключение "org.hibernate.ObjectNotFoundException", в то время, как get() просто возвратит null.  Второе различие состоит в том, что load() возвращает лишь прокси и база данных не будет затронута пока прокси не выполнится. get() затрагивает базу тут же.

Язык. используемый в Hibernate называется Hibernate Query Language (HQL). 

Например, следующий код запрашивает объекты book:

Query query = session.createQuery("from Book"); List books = query.list();

Если Вы уверены, что будет лишь одно совпадение объекта, можно использовать uniqueResult() для получения результата:

Query query = session.createQuery("from Book where isbn = ?"); Page 5 of 8 query.setString(0, isbn); Book book = (Book) query.uniqueResult();

Транзакции.

Если у вас не одна команда, а набор, в таком случае лучше использовать транзакции. Если что-то пойдет не так во время обновления базы, транзакция откатиться назад и все изменения будут отменены.

Session session = factory.openSession(); Transaction tx = null; try { tx = session.beginTransaction(); // Using the session to persist objects tx.commit(); } catch (HibernateException e) { if (tx != null) tx.rollback(); throw e; } finally { session.close(); }

Если Вы не хотите определять транзакции в приложении, вы можете установить значение autocommit в true (который по умолчанию false) в XML файле настроек. 

В таком случае, любой апдейт будет вкомичен тут же.

<property name="connection.autocommit">true</property>

Единственное, что нужно помнить про автокоммиты - это то, что их необходимо сливать перед закрытием сессии. Проблема в том, что Hibernate не записывает изменения в базу сразу же. Вместо этого он выжидает набора команд для повышения производительности.

session.flush();

Сохранение объектов

Для сохранения новосозданных объектов, можно использовать метод save(). 

session.save(book);

Для обновления существующих объектов можно использовать метод update(). 

session.update(book);

Для удаления существующего объекта, можно использовать метод delete(). 

session.delete(book);