NHibernate ISession Flush: где и когда его использовать, и почему?

кратко:

1. всегда использовать операции
2. не используйте Close(), вместо этого оберните ваши звонки на ISession внутри using заявление или управление жизненным циклом вашего ISession где-то еще.

С документация:

времени ISession выполнит инструкции SQL, необходимые для синхронизации ADO.NET состояние соединения с состоянием объектов держится в памяти. Этот процесс, flush, происходит по умолчанию в следующих точках

• от некоторых вызовов Find() или Enumerable()
• С NHibernate.ITransaction.Commit()
• С ISession.Flush()

инструкции SQL выдаются в следующем порядке

1. все вставки сущностей, в том же порядке соответствующие объекты были сохранены с помощью ISession.Save()
2. все обновления лица
3. все удаления коллекции
4. все удаления, обновления и вставки элементов коллекции
5. все коллекции вставки
6. все удаления сущностей, в том же порядке соответствующие объекты были удалены с помощью ISession.Delete()

(исключение состоит в том, что объекты, использующие собственную генерацию идентификаторов, вставляются при их сохранении.)

кроме тех случаев, когда вы эксплицитность Flush(), нет абсолютно никаких гарантий о том, когда сеанс выполняет ADO.NET звонки, только в том порядке, в котором они выполняются. Тем не менее, NHibernate гарантирует, что ISession.Find(..) методы никогда не вернут устаревшие данные; и они не вернут неправильные данные.

можно изменить поведение по умолчанию, чтобы сброс происходил реже. Элемент FlushMode класс определяет три различных режима: только флеш во время фиксации (и только когда NHibernate ITransaction API используется), флеш автоматически с помощью объясненная процедура, или никогда не смывать, если Flush() вызывается явно. Последний режим полезен для длительно работающих единиц работы, где ISession остается открытым и отключенным в течение длительного времени.

...

Смотрите также в этом разделе:

завершение сеанса включает в себя четыре различных этапа:

• очистить сессии
• совершение сделки
• закрыть сессия
• обработка исключений

промывка сессии

если вы случайно используете ITransaction API, вам не нужно беспокоиться об этом шаге. Он будет выполняться неявно при фиксации транзакции. В противном случае вы должны позвонить ISession.Flush() для обеспечения синхронизации всех изменений с базой данных.

фиксация транзакции базы данных

если вы используете NHibernate ITRANSACTION API, это выглядит так:

tx.Commit(); // flush the session and commit the transaction

если вы управляете ADO.NET транзакции сами вы должны вручную Commit() ADO.NET сделка.

sess.Flush();
currentTransaction.Commit();

если вы решили не фиксировать свои изменения:

tx.Rollback();  // rollback the transaction

или:

currentTransaction.Rollback();

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

закрытие ISession

вызов ISession.Close() обозначает конец сеанса. Основное значение Close() заключается в том, что ADO.NET соединение будет прервано сеансом.

tx.Commit();
sess.Close();

sess.Flush();
currentTransaction.Commit();
sess.Close();

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