Skip to main content
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornhauge2007-05-10 01:22:37 +0000
committernhauge2007-05-10 01:22:37 +0000
commit6a5e934be68521a0d2a5b39670bc15a262d32883 (patch)
tree7bf87391bc129471bfa5ed95a5890cca9e939840 /jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm
parent74e0f27246b007af1ffec6ef6843d865684338f5 (diff)
downloadwebtools.dali-6a5e934be68521a0d2a5b39670bc15a262d32883.tar.gz
webtools.dali-6a5e934be68521a0d2a5b39670bc15a262d32883.tar.xz
webtools.dali-6a5e934be68521a0d2a5b39670bc15a262d32883.zip
178911 - New documentation updates.
Diffstat (limited to 'jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm')
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm77
1 files changed, 47 insertions, 30 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm
index cb21d3e933..a7191764be 100644
--- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks011.htm
@@ -2,7 +2,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
-<!-- Run date = May 3, 2007 9:19:10 -->
+<!-- Run date = May 9, 2007 10:03:43 -->
<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
<title>Many-to-many mapping</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
@@ -29,7 +29,7 @@
</td>
</tr>
</table>
-<p><a id="sthref126" name="sthref126"></a><a id="sthref127" name="sthref127"></a><a id="sthref128" name="sthref128"></a><a id="sthref129" name="sthref129"></a>Use a <span class="bold">Many-to-Many Mapping</span> to define a many-valued association with many-to-many multiplicity. A many-to-many mapping has two sides: the <span class="italic">owning side</span> and <span class="italic">non-owning side</span>. You must specify the join table on the owning side. For bidirectional mappings, either side may be the owning side.</p>
+<p><a id="sthref129" name="sthref129"></a><a id="sthref130" name="sthref130"></a><a id="sthref131" name="sthref131"></a><a id="sthref132" name="sthref132"></a>Use a <span class="bold">Many-to-Many Mapping</span> to define a many-valued association with many-to-many multiplicity. A many-to-many mapping has two sides: the <span class="italic">owning side</span> and <span class="italic">non-owning side</span>. You must specify the join table on the owning side. For bidirectional mappings, either side may be the owning side.</p>
<ol type="1" start="1">
<li>
<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p>
@@ -43,29 +43,29 @@
<table class="RuleInformal" title="This table lists the fields in the Persistence Properties view for this mapping." summary="This table lists the fields in the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
<thead>
<tr align="left" valign="top">
-<th align="left" valign="bottom" id="r1c1-t8">Property</th>
-<th align="left" valign="bottom" id="r1c2-t8">Description</th>
-<th align="left" valign="bottom" id="r1c3-t8">Default</th>
+<th align="left" valign="bottom" id="r1c1-t9">Property</th>
+<th align="left" valign="bottom" id="r1c2-t9">Description</th>
+<th align="left" valign="bottom" id="r1c3-t9">Default</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
-<td align="left" id="r2c1-t8" headers="r1c1-t8">Map As</td>
-<td align="left" headers="r2c1-t8 r1c2-t8">Defines this mapping as a <span class="bold">Many to Many Mapping</span>.
+<td align="left" id="r2c1-t9" headers="r1c1-t9">Map As</td>
+<td align="left" headers="r2c1-t9 r1c2-t9">Defines this mapping as a <span class="bold">Many to Many Mapping</span>.
<p>This field corresponds to the <code>@ManyToMany</code> annotation.</p>
</td>
-<td align="left" headers="r2c1-t8 r1c3-t8">Many to Many</td>
+<td align="left" headers="r2c1-t9 r1c3-t9">Many to Many</td>
</tr>
<tr align="left" valign="top">
-<td align="left" id="r3c1-t8" headers="r1c1-t8">Target Entity</td>
-<td align="left" headers="r3c1-t8 r1c2-t8">The entity to which this attribute is mapped.</td>
-<td align="left" headers="r3c1-t8 r1c3-t8">null
+<td align="left" id="r3c1-t9" headers="r1c1-t9">Target Entity</td>
+<td align="left" headers="r3c1-t9 r1c2-t9">The entity to which this attribute is mapped.</td>
+<td align="left" headers="r3c1-t9 r1c3-t9">null
<p>You do not need to explicitly specify the target entity, since it can be inferred from the type of object being referenced.</p>
</td>
</tr>
<tr align="left" valign="top">
-<td align="left" id="r4c1-t8" headers="r1c1-t8">Fetch</td>
-<td align="left" headers="r4c1-t8 r1c2-t8">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
+<td align="left" id="r4c1-t9" headers="r1c1-t9">Fetch</td>
+<td align="left" headers="r4c1-t9 r1c2-t9">Defines how data is loaded from the database. See <a href="ref_mapping_general.htm#CACGGGHB">"Fetch Type"</a> for details.
<ul>
<li type="disc">
<p>Eager</p>
@@ -75,45 +75,62 @@
</li>
</ul>
</td>
-<td align="left" headers="r4c1-t8 r1c3-t8">Eager</td>
+<td align="left" headers="r4c1-t9 r1c3-t9">Lazy</td>
</tr>
<tr align="left" valign="top">
-<td align="left" id="r5c1-t8" headers="r1c1-t8">Mapped By</td>
-<td align="left" headers="r5c1-t8 r1c2-t8">The database field that owns the relationship.</td>
-<td align="left" headers="r5c1-t8 r1c3-t8"><br /></td>
+<td align="left" id="r5c1-t9" headers="r1c1-t9">Mapped By</td>
+<td align="left" headers="r5c1-t9 r1c2-t9">The database field that owns the relationship.</td>
+<td align="left" headers="r5c1-t9 r1c3-t9"><br /></td>
+</tr>
+<tr align="left" valign="top">
+<td align="left" id="r6c1-t9" headers="r1c1-t9">Order By</td>
+<td align="left" headers="r6c1-t9 r1c2-t9">Specify the default order for objects returned from a query. See <a href="ref_mapping_general.htm#CACDADIH">"Order By"</a> for details.
+<ul>
+<li type="disc">
+<p>No ordering</p>
+</li>
+<li type="disc">
+<p>Primary key</p>
+</li>
+<li type="disc">
+<p>Custom</p>
+</li>
+</ul>
+</td>
+<td align="left" headers="r6c1-t9 r1c3-t9">No ordering</td>
</tr>
</tbody>
</table>
<br /></div>
<!-- class="inftblruleinformal" --></li>
<li>
-<p>Use this table to complete the fields in the <a href="reference005.htm#CACBAEBC">Join Table Information</a> area in the <span class="gui-object-title">JPA Details</span> view.</p>
+<p>Use this table to complete the fields in the <a href="reference006.htm#CACBAEBC">Join Table Information</a> area in the <span class="gui-object-title">JPA Details</span> view.</p>
<div class="inftblruleinformal">
<table class="RuleInformal" title="This table lists the fields in the Join Table tab of the Persistence Properties view for this mapping." summary="This table lists the fields in the Join Table tab of the Persistence Properties view for this mapping." dir="ltr" border="1" width="100%" frame="border" rules="all" cellpadding="3" cellspacing="0">
<thead>
<tr align="left" valign="top">
-<th align="left" valign="bottom" id="r1c1-t9">Property</th>
-<th align="left" valign="bottom" id="r1c2-t9">Description</th>
-<th align="left" valign="bottom" id="r1c3-t9">Default</th>
+<th align="left" valign="bottom" id="r1c1-t10">Property</th>
+<th align="left" valign="bottom" id="r1c2-t10">Description</th>
+<th align="left" valign="bottom" id="r1c3-t10">Default</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
-<td align="left" id="r2c1-t9" headers="r1c1-t9">Name</td>
-<td align="left" headers="r2c1-t9 r1c2-t9">Name of the join table that contains the foreign key column.</td>
-<td align="left" headers="r2c1-t9 r1c3-t9">You must specify the join table on the owning side.
+<td align="left" id="r2c1-t10" headers="r1c1-t10">Name</td>
+<td align="left" headers="r2c1-t10 r1c2-t10">Name of the join table that contains the foreign key column.</td>
+<td align="left" headers="r2c1-t10 r1c3-t10">You must specify the join table on the owning side.
<p>By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</p>
</td>
</tr>
<tr align="left" valign="top">
-<td align="left" id="r3c1-t9" headers="r1c1-t9">Join Columns</td>
-<td align="left" headers="r3c1-t9 r1c2-t9">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
-<td align="left" headers="r3c1-t9 r1c3-t9">By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</td>
+<td align="left" id="r3c1-t10" headers="r1c1-t10">Join Columns</td>
+<td align="left" headers="r3c1-t10 r1c2-t10">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
+<td align="left" headers="r3c1-t10 r1c3-t10">By default, the name is assumed to be the primary tables associated with the entities concatenated with an underscore.</td>
</tr>
<tr align="left" valign="top">
-<td align="left" id="r4c1-t9" headers="r1c1-t9">Inverse Join Columns</td>
-<td align="left" headers="r4c1-t9 r1c2-t9">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
-<td align="left" headers="r4c1-t9 r1c3-t9">By default, the mapping is assumed to have a single join.</td>
+<td align="left" id="r4c1-t10" headers="r1c1-t10">Inverse Join Columns</td>
+<td align="left" headers="r4c1-t10 r1c2-t10">Select <span class="bold">Override Default</span>, then Add, Edit, or Remove the join columns.</td>
+<td align="left" headers="r4c1-t10 r1c3-t10">By default, the mapping is assumed to have a single join.</td>
</tr>
</tbody>
</table>

Back to the top