Skip to main content
diff options
authornhauge2007-05-04 19:55:48 +0000
committernhauge2007-05-04 19:55:48 +0000
commitbc72d754f082fe30ef0d7aeff54f29c64553f02a (patch)
treed69c3c3f38ea93ee78ce6d4529f80d928ee88030 /jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm
parentd8139fbb848c9509ae592b5477c85f5fd34b8ceb (diff)
178911 - Initial check-in for user.doc plugin for Dali 1.0.
Diffstat (limited to 'jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm')
1 files changed, 92 insertions, 0 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm
new file mode 100644
index 0000000000..6b407d710c
--- /dev/null
+++ b/jpa/plugins/org.eclipse.jpt.doc.user/getting_started016.htm
@@ -0,0 +1,92 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "">
+<html xmlns="" xml:lang="en" lang="en">
+<!-- Run date = May 3, 2007 9:19:07 -->
+<meta name="OAC_IGNORE_SKIP_NAV" content="true" />
+<title>Create one-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="" />
+<meta name="doctitle" content="Create one-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" />
+<p><a id="BABGBGHF" name="BABGBGHF"></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 one-to-one mappings</h1>
+<p>Use a <span class="bold">One-to-One Mapping</span> to define a relationship from an attribute to another class, with one-to-one multiplicity to a database column. In the <a href="getting_started006.htm#BABIDCBA">Tutorial Object Model</a>, the <span class="bold">address</span> field of the <span class="bold">Employee</span> class has a one-to-one relationship to the <span class="bold">Address</span> class; each employee may have a single address.</p>
+<ol type="1" start="1">
+<p>Select the <span class="bold">Employee</span> entity in the Package Explorer view.</p>
+<p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the <span class="bold">address</span> field of the <span class="bold">Employee</span> entity. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the field.</p>
+<p>In the <span class="gui-object-title">Map As</span> field, select <span class="gui-object-action">One-to-One</span>.</p>
+<div class="figure"><a id="sthref32" name="sthref32"></a>
+<p class="titleinfigure">One-to-one Mapping for address</p>
+<img src="img/persistence_view_onetoone.png" alt="This figure shows the Persistence Properties page for the address field." title="This figure shows the Persistence Properties page for the address field." /><br /></div>
+<!-- class="figure" --></li>
+<p>For the Target Entity, click <span class="bold">Browse</span> and select the <span class="bold">Address</span> persistent entity. Dali adds the <code>@OneToOne(targetEntity=dali.tutorial.model.Address.class)</code> entity to the class.</p>
+<p>Leave the other fields with their default values.</p>
+<p>Select the <span class="bold">Join Columns</span> tab to specify the relationship between the Employee and Address entities. Because you had to explicitly define the ID field for the Address entity in its ID mapping, you will need to edit the default join relationship.</p>
+<p>Select the <span class="bold">Override Default</span> option.</p>
+<p>Select the <span class="bold">address_ADDRESS_ID -&gt; ADDRESS_ID</span> relationship in the <span class="gui-object-title">Join Columns</span> area and click <span class="bold">Edit</span>.</p>
+<p>In the Edit Join Column dialog, select the following options and click <span class="bold">OK</span>.</p>
+<li type="disc">
+<p>Name: <span class="bold">ADDR_ID</span> (from the EMPLOYEE table)</p>
+<li type="disc">
+<p>Referenced Column Name: <span class="bold">ADDRESS_ID</span> (from the ADDRESS table)</p>
+<div class="figure"><a id="sthref33" name="sthref33"></a>
+<p class="titleinfigure">Editing Join Column for Address Mapping</p>
+<img src="img/edit_join_column_dialog.png" alt="This figure shows the Edit Join Column dialog for the address 1:1 mapping." title="This figure shows the Edit Join Column dialog for the address 1:1 mapping." /><br /></div>
+<!-- class="figure" --></li>
+<p>In the JPA Structure, the <span class="bold">address</span> field is identified as a one-to-one mapping, as shown in the following figure:</p>
+<div class="figure"><a id="sthref34" name="sthref34"></a>
+<p class="titleinfigure">JPA Structure for Employee Entity</p>
+<img src="img/persistence_outline_address.png" alt="This figure shows the address attribute of the Employee entity in the Persistence Outline view." title="This figure shows the address attribute of the Employee entity in the Persistence Outline view." /><br /></div>
+<!-- class="figure" -->
+<p>Next, you will <a href="getting_started017.htm#BABBEHEG">Create one-to-many mappings</a>.</p>
+<!-- class="sect3" -->
+<!-- Start Footer -->
+<div class="footer">
+<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
+<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>
+<!-- class="footer" -->

Back to the top