doc'd not-found

git-svn-id: https://svn.jboss.org/repos/hibernate/trunk/Hibernate3/doc@6301 1b8cb986-b30d-0410-93ca-fae66ebed9b2
This commit is contained in:
Gavin King 2005-04-03 04:50:04 +00:00
parent c160bbd680
commit 4a17055749
2 changed files with 29 additions and 2 deletions

View File

@ -1361,6 +1361,7 @@
<area id="manytoone11" coords="12 60"/>
<area id="manytoone12" coords="13 60"/>
<area id="manytoone13" coords="14 60"/>
<area id="manytoone14" coords="15 60"/>
</areaspec>
<programlisting><![CDATA[<many-to-one
name="propertyName"
@ -1376,6 +1377,7 @@
not-null="true|false"
optimistic-lock="true|false"
lazy="true|false"
not-found="ignore|exception"
entity-name="EntityName"
/>]]></programlisting>
<calloutlist>
@ -1462,6 +1464,13 @@
on class or collection mappings, but uses interception for deferred loading.
</para>
</callout>
<callout arearefs="manytoone14">
<para>
<literal>not-found</literal> (optional - defaults to <literal>exception</literal>):
Specifies how foreign keys that reference missing rows will be handled:
<literal>ignore</literal> will treat a missing row as a null association.
</para>
</callout>
</calloutlist>
</programlistingco>

View File

@ -463,6 +463,7 @@ kittens = cat.getKittens(); // Okay, kittens collection is a Set
<area id="manytomany3" coords="4 60"/>
<area id="manytomany4" coords="5 60"/>
<area id="manytomany5" coords="6 60"/>
<area id="manytomany6" coords="7 60"/>
</areaspec>
<programlisting><![CDATA[<many-to-many
column="column_name"
@ -470,6 +471,7 @@ kittens = cat.getKittens(); // Okay, kittens collection is a Set
class="ClassName"
fetch="select|join"
unique="true|false"
not-found="ignore|exception"
entity-name="EntityName"
/>]]></programlisting>
<calloutlist>
@ -507,6 +509,13 @@ kittens = cat.getKittens(); // Okay, kittens collection is a Set
effectively one to many.
</para>
</callout>
<callout arearefs="manytomany6">
<para>
<literal>not-found</literal> (optional - defaults to <literal>exception</literal>):
Specifies how foreign keys that reference missing rows will be handled:
<literal>ignore</literal> will treat a missing row as a null association.
</para>
</callout>
</calloutlist>
</programlistingco>
@ -606,10 +615,12 @@ kittens = cat.getKittens(); // Okay, kittens collection is a Set
<programlistingco>
<areaspec>
<area id="onetomany1" coords="1 60"/>
<area id="onetomany1" coords="2 60"/>
<area id="onetomany2" coords="3 60"/>
</areaspec>
<programlisting><![CDATA[<one-to-many
class="ClassName"
not-found="ignore|exception"
entity-name="EntityName"/>]]></programlisting>
<calloutlist>
<callout arearefs="onetomany1">
@ -617,8 +628,15 @@ kittens = cat.getKittens(); // Okay, kittens collection is a Set
<literal>class</literal> (required): The name of the associated class.
</para>
</callout>
<callout arearefs="onetomany2">
<para>
<literal>not-found</literal> (optional - defaults to <literal>exception</literal>):
Specifies how cached identifiers that reference missing rows will be handled:
<literal>ignore</literal> will treat a missing row as a null association.
</para>
</callout>
</calloutlist>
</programlistingco>
</programlistingco>
<para>
Notice that the <literal>&lt;one-to-many&gt;</literal> element does not need to