[Hibernate-commits] Hibernate Code SVN: r9935 - trunk/Hibernate3/doc/reference/en/modules

[<hib...@li...>]

Author: chr...@jb...
Date: 2006-05-19 03:18:08 -0400 (Fri, 19 May 2006)
New Revision: 9935

Modified:
   trunk/Hibernate3/doc/reference/en/modules/session_api.xml
Log:
Minor doc addition

Modified: trunk/Hibernate3/doc/reference/en/modules/session_api.xml
===================================================================
--- trunk/Hibernate3/doc/reference/en/modules/session_api.xml	2006-05-18 22:27:26 UTC (rev 9934)
+++ trunk/Hibernate3/doc/reference/en/modules/session_api.xml	2006-05-19 07:18:08 UTC (rev 9935)
@@ -455,7 +455,7 @@
 
             </sect3>
 
-            <sect3 id="objectstate-querying-executing-named">
+            <sect3 id="objectstate-querying-executing-named" revision="1">
                 <title>Externalizing named queries</title>
 
                 <para>
@@ -464,7 +464,7 @@
                     be interpreted as markup.)
                 </para>
 
-                <programlisting><![CDATA[<query name="eg.DomesticCat.by.name.and.minimum.weight"><![CDATA[
+                <programlisting><![CDATA[<query name="ByNameAndMaximumWeight"><![CDATA[
     from eg.DomesticCat as cat
         where cat.name = ?
         and cat.weight > ?
@@ -474,7 +474,7 @@
                     Parameter binding and executing is done programatically:
                 </para>
 
-                <programlisting><![CDATA[Query q = sess.getNamedQuery("eg.DomesticCat.by.name.and.minimum.weight");
+                <programlisting><![CDATA[Query q = sess.getNamedQuery("ByNameAndMaximumWeight");
 q.setString(0, name);
 q.setInt(1, minWeight);
 List cats = q.list();]]></programlisting>
@@ -485,6 +485,14 @@
                     existing queries to Hibernate by placing them in mapping files.
                 </para>
 
+                <para>
+                    Also note that a query declaration inside a <literal>&lt;hibernate-mapping&gt;</literal>
+                    element requires a global unique name for the query, while a query declaration inside a
+                    <literal>&lt;class&gt;</literal> element is made unique automatically by prepending the
+                    fully qualified name of the class, for example
+                    <literal>eg.Cat.ByNameAndMaximumWeight</literal>.
+                </para>
+
             </sect3>
 
         </sect2>