Skip to main content
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to 'jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm')
-rw-r--r--jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm89
1 files changed, 89 insertions, 0 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm
new file mode 100644
index 0000000000..93ea9d8163
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started018.htm
@@ -0,0 +1,89 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "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:08 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create many-to-one mappings</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta http-equiv="Content-Script-Type" content="text/javascript" />
+<meta name="generator" content="Oracle DARB XHTML Converter - Version 4.5.3 Build 02" />
+<meta name="date" content="2005-07-10T12:57:20+08:00" />
+<meta name="robots" content="all" scheme="http://www.robotstxt.org/" />
+<meta name="doctitle" content="Create many-to-one mappings" />
+<meta name="relnum" content="Release 1.0.0" />
+<meta name="partnum" content="" />
+<link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" />
+<link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" />
+<link rel="start" href="../../index.htm" title="Home" type="text/html" />
+<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
+</head>
+<body>
+<p><a id="BABCHIHI" name="BABCHIHI"></a></p>
+<div class="sect3"><!-- infolevel="all" infotype="General" -->
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr valign="bottom">
+<td align="left" width="86%">
+<h1>Create many-to-one mappings</h1>
+</td>
+</tr>
+</table>
+<p>Use a <span class="bold">May-to-One Mapping</span> to define a relationship from an attribute to another class, with many-to-one multiplicity to a database column. In the <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a>, the <span class="bold">owner</span> field of the <span class="bold">PhoneNumber</span> class has a one-to-many relationship to the <span class="bold">Employee</span> class; there are many phone numbers that each employee may have.</p>
+<p>This is the "back mapping" of the one-to-many mapping you previously defined.</p>
+<ol type="1" start="1">
+<li>
+<p>Select the <span class="bold">PhoneNumber</span> entity in the Package Explorer view.</p>
+</li>
+<li>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">owner</span> field of the <span class="bold">PhoneNumber</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+</li>
+<li>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">Many to One</span>.</p>
+<div class="figure"><a id="sthref37" name="sthref37"></a>
+<p class="titleinfigure">Many to One Mapping for owner</p>
+<img src="img/persistence_view_manytoone.png" alt="This figure shows the Persistence Properties page for the owner field." title="This figure shows the Persistence Properties page for the owner field." /><br /></div>
+<!-- class="figure" --></li>
+<li>
+<p>Leave the other fields with their default values. Dali correctly completes the information based on the database structure and previously defined mappings.</p>
+</li>
+<li>
+<p>Use the <span class="bold">Join Columns</span> area to specify the relationship between the PhoneNumber and Employee entities. Because you had to explicitly define the ID field for the Employee entity in its ID mapping, you will need to edit the default join relationship.</p>
+</li>
+<li>
+<p>Select the <span class="bold">Override Default</span> option.</p>
+</li>
+<li>
+<p>Select the <span class="bold">owner_EMP_ID -&gt; EMP_ID</span> relationship in the <span class="gui-object-title">Join Columns</span> area and click <span class="bold">Edit</span>.</p>
+</li>
+<li>
+<p>In the Edit Join Column dialog, select the following options and click <span class="bold">OK</span>.</p>
+<ul>
+<li type="disc">
+<p>Name: <span class="bold">EMP_ID</span> (from the PHONE table)</p>
+</li>
+<li type="disc">
+<p>Referenced Column Name: <span class="bold">EMP_ID</span> (from the EMPLOYEE table)</p>
+</li>
+</ul>
+</li>
+</ol>
+<p>In the JPA Structure, the <span class="bold">owner</span> field is identified as a many-to-one mapping as shown in the following figure:</p>
+<div class="figure"><a id="sthref38" name="sthref38"></a>
+<p class="titleinfigure">JPA Structure for PhoneNumber Entity</p>
+<img src="img/persistence_outline_owner.png" alt="This figure shows the owner attribute of the PhoneNumber entity in the Persistence Outline view." title="This figure shows the owner attribute of the PhoneNumber entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Next, you will <a href="getting_started019.htm#BABIDFFG">Create version mappings</a></p>
+</div>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<tr>
+<td align="left" width="86%"><a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Copyright&nbsp;&copy;&nbsp;2006, 2007,&nbsp;Oracle.&nbsp;All&nbsp;rights&nbsp;reserved.</span></a></td>
+</tr>
+</table>
+</div>
+<!-- class="footer" -->
+</body>
+</html>

Back to the top