Minor doc addition

git-svn-id: https://svn.jboss.org/repos/hibernate/trunk/Hibernate3/doc@9935 1b8cb986-b30d-0410-93ca-fae66ebed9b2
This commit is contained in:
Christian Bauer 2006-05-19 07:18:08 +00:00
parent e1ce3d4887
commit 12aaf715fd
1 changed files with 11 additions and 3 deletions

View File

@ -455,7 +455,7 @@ cats.close()]]></programlisting>
</sect3> </sect3>
<sect3 id="objectstate-querying-executing-named"> <sect3 id="objectstate-querying-executing-named" revision="1">
<title>Externalizing named queries</title> <title>Externalizing named queries</title>
<para> <para>
@ -464,7 +464,7 @@ cats.close()]]></programlisting>
be interpreted as markup.) be interpreted as markup.)
</para> </para>
<programlisting><![CDATA[<query name="eg.DomesticCat.by.name.and.minimum.weight"><![CDATA[ <programlisting><![CDATA[<query name="ByNameAndMaximumWeight"><![CDATA[
from eg.DomesticCat as cat from eg.DomesticCat as cat
where cat.name = ? where cat.name = ?
and cat.weight > ? and cat.weight > ?
@ -474,7 +474,7 @@ cats.close()]]></programlisting>
Parameter binding and executing is done programatically: Parameter binding and executing is done programatically:
</para> </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.setString(0, name);
q.setInt(1, minWeight); q.setInt(1, minWeight);
List cats = q.list();]]></programlisting> List cats = q.list();]]></programlisting>
@ -485,6 +485,14 @@ List cats = q.list();]]></programlisting>
existing queries to Hibernate by placing them in mapping files. existing queries to Hibernate by placing them in mapping files.
</para> </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> </sect3>
</sect2> </sect2>