[seam-commits] Seam SVN: r8288 - trunk.

[seam-commits at lists.jboss.org]

Author: dan.j.allen
Date: 2008-05-27 12:41:08 -0400 (Tue, 27 May 2008)
New Revision: 8288

Modified:
   trunk/seam21migration.txt
Log:
note about change to default name of Seam-managed Hibernate session


Modified: trunk/seam21migration.txt
===================================================================
--- trunk/seam21migration.txt	2008-05-27 16:35:44 UTC (rev 8287)
+++ trunk/seam21migration.txt	2008-05-27 16:41:08 UTC (rev 8288)
@@ -26,9 +26,44 @@
 EntityConverter configuration
 -----------------------------
 
-If you need to configure which entity manager to use, this is now done on the 
+If you need to configure which entity manager to use, this is now done on the
 entity-loader component. See the documentation for details. 
 
+Assumed name for managed Hibernate session
+------------------------------------------
+
+Several areas of Seam, including the Seam Application Framework, rely on a
+naming convention for the Seam-managed persistence context (JPA) and Hibernate
+session. Prior to Seam 2.1, the assumed name of the managed Hibernate session
+was "session". However, session is a very overloaded name in Seam and the Java
+Servlet API. To make it less ambigous, the default was changed to
+"hibernateSession".
+
+The benefit now is that when you inject or resolve the Hibernate session, you
+know that is the refernece you are getting (rather than the HTTP session, mail
+session, or some other "session").
+
+You would inject it as follows:
+
+ at In private Session hibernateSession;
+
+or
+
+ at In(name = "hibernateSession") private Session session;
+
+If the name of your Seam-managed Hibernate session is "session", you can still
+inject this reference explictly using the session property:
+
+<framework:hibernate-entity-home session="#{session}".../>
+<transaction:entity-transaction session="#{session}".../>
+
+The alternative is to override the getPersistenceContextName() method on any
+persistence controller in the Seam Application Framework:
+
+public String getPersistenceContextName() {
+	"session";
+}
+
 Security
 --------
 
@@ -41,4 +76,4 @@
 In Seam 2.1, rule-based permission checks are now carried out by the RuleBasedPermissionResolver,
 requiring that it is configured with the security rules instead of Identity:
 
-  <security:rule-based-permission-resolver security-rules="#{securityRules}"/>
\ No newline at end of file
+  <security:rule-based-permission-resolver security-rules="#{securityRules}"/>