Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

renamed sequential-select to outer-join 

git-svn-id: https://svn.jboss.org/repos/hibernate/trunk/Hibernate3/doc@4430 1b8cb986-b30d-0410-93ca-fae66ebed9b2
This commit is contained in:
Gavin King 2004-08-23 01:54:23 +00:00
parent 81ee870fb3
commit 13d1a06a51
2 changed files with 24 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
reference/en/modules/basic_mapping.xml
View File

@ -1905,7 +1905,7 @@
table="tablename"
schema="owner"
catalog="catalog"
sequential-select="true|false"
outer-join="true|false"
inverse="true|false">
<key ... />
@ -1934,8 +1934,8 @@
</callout>
<callout arearefs="join4">
<para>
<literal>sequential-select</literal> (optional - defaults to <literal>false</literal>):
If enabled for a join defined on a subclass, then rather than joining, a sequential
<literal>outer-join</literal> (optional - defaults to <literal>true</literal>):
If disabled for a join defined on a subclass, then rather than joining, a sequential
select will be issued if a row turns out to represent an instance of the subclass.
</para>
</callout>

35
reference/en/modules/performance.xml
View File

@ -215,7 +215,11 @@
for that class. The recommended approach is to specify the class itself:
</para>
<programlisting><![CDATA[<class name="eg.Order" proxy="eg.Order">]]></programlisting>
<programlisting><![CDATA[<class name="Order" proxy="Order">]]></programlisting>
<para>or, as a shorthand, just write <literal>lazy="true"</literal>:</para>
<programlisting><![CDATA[<class name="Order" lazy="true">]]></programlisting>
<para>
The runtime type of the proxies will be a subclass of <literal>Order</literal>. Note that
@ -227,9 +231,9 @@
classes, eg.
</para>
<programlisting><![CDATA[<class name="eg.Cat" proxy="eg.Cat">
<programlisting><![CDATA[<class name="Cat" proxy="Cat">
......
<subclass name="eg.DomesticCat" proxy="eg.DomesticCat">
<subclass name="DomesticCat" proxy="DomesticCat">
.....
</subclass>
</class>]]></programlisting>
@ -281,9 +285,9 @@ System.out.println( dc.getWeight() ); // 11.0]]></programlisting>
that declares its business methods. You should specify these interfaces in the mapping file. eg.
</para>
<programlisting><![CDATA[<class name="eg.Cat" proxy="eg.ICat">
<programlisting><![CDATA[<class name="CatImpl" proxy="Cat">
......
<subclass name="eg.DomesticCat" proxy="eg.IDomesticCat">
<subclass name="DomesticCatImpl" proxy="DomesticCat">
.....
</subclass>
</class>]]></programlisting>
@ -293,16 +297,16 @@ System.out.println( dc.getWeight() ); // 11.0]]></programlisting>
<literal>DomesticCat</literal> implements the interface <literal>IDomesticCat</literal>. Then
proxies for instances of <literal>Cat</literal> and <literal>DomesticCat</literal> may be returned
by <literal>load()</literal> or <literal>iterate()</literal>. (Note that <literal>find()</literal>
does not return proxies.)
does not usually return proxies.)
</para>
<programlisting><![CDATA[ICat cat = (ICat) session.load(Cat.class, catid);
Iterator iter = session.iterate("from cat in class eg.Cat where cat.name='fritz'");
ICat fritz = (ICat) iter.next();]]></programlisting>
<programlisting><![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);
Iterator iter = session.iterate("from cat in class CatImpl where cat.name='fritz'");
Cat fritz = (Cat) iter.next();]]></programlisting>
<para>
Relationships are also lazily initialized. This means you must declare any properties to be of
type <literal>ICat</literal>, not <literal>Cat</literal>.
type <literal>Cat</literal>, not <literal>CatImpl</literal>.
</para>
<para>
@ -534,7 +538,7 @@ ICat fritz = (ICat) iter.next();]]></programlisting>
<entry><literal>org.hibernate.cache.TreeCacheProvider</literal></entry>
<entry>clustered (ip multicast), transactional</entry>
<entry>yes (replication)</entry>
<entry></entry>
<entry>yes</entry>
</row>
</tbody>
</tgroup>
@ -716,9 +720,12 @@ ICat fritz = (ICat) iter.next();]]></programlisting>
<para>
Whenever you pass an object to <literal>save()</literal>, <literal>update()</literal>
or <literal>saveOrUpdate()</literal> and whenever you retrieve an object using
<literal>load()</literal>, <literal>find()</literal>, <literal>iterate()</literal>,
or <literal>filter()</literal>, that object is added to the internal cache of the
<literal>Session</literal>. When <literal>flush()</literal> is subsequently called,
<literal>load()</literal>, <literal>get()</literal>, <literal>list()</literal>,
<literal>iterate()</literal> or <literal>scroll()</literal>, that object is added
to the internal cache of the <literal>Session</literal>.
</para>
<para>
When <literal>flush()</literal> is subsequently called,
the state of that object will be synchronized with the database. If you do not want
this synchronization to occur or if you are processing a huge number of objects and
need to manage memory efficiently, the <literal>evict()</literal> method may be