NHibernate ISession Flush: Où et quand l'utiliser, et pourquoi?

brièvement:

1. Toujours utiliser des transactions
2. N'utilisez pas Close() , à la place enveloppez vos appels sur un ISession à l'intérieur d'un using déclaration ou gérer le cycle de vie de votre ISession ailleurs .

à Partir de la documentation :

de temps en temps le ISession exécutera le Les déclarations SQL nécessaires pour synchroniser ADO.NET l'état de la connexion avec l'état des objets gardés en mémoire. Ce processus, flush, se produit par défaut aux points suivants

• de certaines invocations de Find() ou Enumerable()
• de NHibernate.ITransaction.Commit()
• de ISession.Flush()

les déclarations SQL sont publiées dans l'ordre suivant

1. toutes les insertions d'entités, dans le même ordre les objets correspondants ont été sauvegardés en utilisant ISession.Save()
2. toutes les mises à jour des entités
3. toutes les suppressions de collection
4. suppression, mise à jour et insertion de tous les éléments de la collection
5. toutes les insertions de collecte
6. toutes les suppressions d'entités, dans le même ordre les objets correspondants ont été supprimés en utilisant ISession.Delete()

(une exception est que les objets utilisant la génération native ID sont insérés quand ils sont sauvegardés.)

sauf lorsque vous explicitez Flush() , il n'y a absolument aucune garantie sur le moment où la Session exécute le ADO.NET les appels, seulement l'ordre dans lequel ils sont exécutés . Cependant, NHibernate garantit que les méthodes ISession.Find(..) ne retourneront jamais les données périmées; renvoie les mauvaises données.

il est possible de changer le comportement par défaut de sorte que flush se produit moins fréquemment. La classe FlushMode définit trois modes différents: seulement flush au moment de la propagation (et seulement lorsque L'API ITransaction est utilisée), flush automatiquement en utilisant la routine expliquée, ou never flush à moins que Flush() ne soit explicitement appelé. Le dernier mode est utile pour les unités de travail de longue durée, où un ISession est maintenu ouvert et déconnecté pendant un long moment.

...

voir aussi cette section :

la fin d'une session comporte quatre phases distinctes:

• vider la session
• valider la transaction
• clôture de la session
• gérer les exceptions

Rinçage de la Session

si vous utilisez l'API ITransaction , vous n'avez pas à vous soucier de cette étape. Elle sera exécutée implicitement lorsque la transaction est engagée. Sinon, vous devez appeler ISession.Flush() pour vous assurer que toutes les modifications sont synchronisées avec la base de données.

Valider la transaction de base de données

si vous utilisez L'API NHibernate ITransaction, cela ressemble à:

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

si vous gérez ADO.NET transactions vous-même vous devriez manuellement Commit() le ADO.NET transaction.

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

si vous décidez de ne pas effectuer vos modifications:

tx.Rollback();  // rollback the transaction

ou:

currentTransaction.Rollback();

si vous annulez la transaction, vous devez immédiatement fermer et rejeter la session en cours pour vous assurer que L'état interne de NHibernate est cohérent.

Clôture de la session

Un appel à ISession.Close() marque la fin d'une session. L'implication principale de Close () est que le ADO.NET la session abandonnera la connexion.

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

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

si vous avez fourni votre propre connexion, Close() renvoie une référence à celle-ci, de sorte que vous pouvez la fermer manuellement ou la retourner à la piscine. Sinon Close() le renvoie à la piscine.