Книга: ASP.NET MVC Framework

NHibernate

NHibernate

Еще одним вариантом организации доступа к данным может стать популярная ORM-библиотека NHibernate — довольно старый механизм, портированный на платформу .NET Framework из Java-проекта Hibernate. Как ORM, Hibernate давно заслужила право называться зрелой, гибкой, мощной и главное производительной библиотекой. Адаптация под .NET, хотя и не совсем полностью реализует функционал Hibernate версии 3, но предлагает все тот же механизм, сравнимый по мощности и производительности с предком.

NHibernate, как и другие ORM, использует для реализации доступа к данным мэппинг в виде XML-файла. Этот файл должен быть оформлен согласно схеме nhibernate-mapping.xsd, которая идет в комплекте поставки. По традиции названия всех таких файлов мэппинга формируются как class_name.hbm.xml. Такой файл может выглядеть примерно так:

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn: nhibernate-mapping-2.2"
  namespace="MyNamespace" assembly="MyNamespace">
<class name="Customer" table="Customers">
  <id name="customerId">
    <column name="customerId" not-null="true" />
    <generator/>
  </id>
  <property name="name" />
  <property name="phone" />
  <property name="address" />
</class>
</hibernate-mapping>

Здесь создается мэппинг класса Customer на таблицу Customers в базе данных, которая содержит ряд полей: customerId, name, phone, address. Для подключения к базе данных должен быть создан другой конфигурационный файл, похожий на этот:

<?xml version="1.0" encoding="utf-8"?>
<hibernate-configuration>
  <session-factory xmlns="urn: nhibernate-configuration-2.2">
    <property name=''connection.provider">
      NHibernate.Connection.DriverConnectionProvider
    </property>
    <property name=''connection.driver_class">
      NHibernate.Driver.SqlClientDriver
    </property>
    <property name="dialect">
      NHibernate.Dialect.MsSql2005Dialect
    </property>
    <property name="connection.connection_string">
      Server=(local);
      Initial Catalog=MyDatabase;
      Integrated Security=SSPI;
    </property>
    <mapping resource="MyNamespace.Customer.hbm.xml"
       assembly="MyNamespace" />
  </session-factory>
</hibernate-configuration>

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

? Fluent NHibernate (http://fluentNHibernate.org/);

? MyGeneration (http://www.mygenerationsoftware.com/portal/default.aspx);

? NHibernate 1.2 Generator (http://gennit.com/);

? NHibernate Query Generator

(http://ayende.com/projects/downloads/NHibernate-query-generator.aspx);

? NHibernate Entity Generator (http://www.softpedia.com/get/Programming/Other-Programming-Files/NHibernate-Entity-Generator.shtml);

? NHibernate Helper Kit (http://www.codeproject.com/KB/dotnet/NHibernate_Helper_Kit.aspx);

? многие другие (http://stackoverflow.com/questions/41752/nhibernate-generators).

Для работы с NHibernate используются пространства имен NHibernate и NHibernate.Cfg. Второе служит для загрузки файла конфигурации, например, как показано в следующем примере:

ISessionFactory sessionFactory = new Configuration()
  .Configure("Nhibernate.cfg.xml").BuildSessionFactory();

где Nhibernate.cfg.xml — ваш файл конфигурации.

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

ISession session;
ITransaction tran;
try
{
  session = sessionFactory.OpenSession();
  tran = session.BeginTransaction();
  // делаем какую-то работу
  tran.Commit();
  session.Close();
}
catch (Exception ex)
{
  tran.Rollback();
  session.Close();
}

Как вы можете заметить, NHibernate реализует механизм транзакций с возможностью откатывать ненужные изменения.

Работа с объектами NHibernate возможна с помощью одного из трех вариантов:

? Hibernate Query Language (HQL) — языка во многом похожего на язык LINQ c SQL-синтаксисом;

? Query By Criteria (QBC) — объектный вариант, который позволяет строить выражения запросов динамически через объектно-ориентированный API;

? через обыкновенные SQL-запросы.

Приведем простой пример использования HQL:

string result = (string)session.createQuery(@"select phone
         from Customer as c
         where c.name = 'Сергей Иванов'").UniqueResult();

Пример вернет телефон заказчика по его имени. Перепишем этот пример с использованием Query By Criteria:

ICriteria crit = session.CreateCriteria(typeof(Customer));
crit.Add(Expression.Eq("name", "Сергей Иванов"));
crit.SetMaxResults(1);
string phone = (string) crit.UniqueResult();

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

Кроме того, в будущих версиях NHibernate может появиться полноценная поддержка LINQ. По крайней мере, частичная реализация уже существует в NHibernate Contrib (https://nhcontrib.svn.sourceforge.net/svnroot/nhcontrib/trunk/). Эта возможность позволит оперировать NHibernate-объектами в привычном для LINQ-разработчиков стиле и, наверняка, увеличит привлекательность библиотеки.

Оглавление книги