diff options
Diffstat (limited to 'jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm')
-rw-r--r-- | jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm | 74 |
1 files changed, 57 insertions, 17 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm b/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm index 5c768c96b4..3a1dd3687d 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/tasks021.htm @@ -5,47 +5,80 @@ <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" /> -<title>Transient mapping</title> +<title>Version mapping</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-27T9:43:51Z" /> +<meta name="date" content="2012-10-11T7:52:8Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Transient mapping" /> +<meta name="doctitle" content="Version mapping" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <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" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-27</p> -<p><a id="BABHFHEI" name="BABHFHEI"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-10-11</p> +<p><a id="BABHIBII" name="BABHIBII"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> -<h1>Transient mapping</h1> -<p><a id="sthref271" name="sthref271"></a><a id="sthref272" name="sthref272"></a><a id="sthref273" name="sthref273"></a><a id="sthref274" name="sthref274"></a>Use the Transient Mapping to specify a field of the entity class that <span class="italic">is not</span> persistent.</p> -<p>To create a transient mapping:</p> +<h1>Version mapping</h1> +<p><a id="sthref282" name="sthref282"></a><a id="sthref283" name="sthref283"></a><a id="sthref284" name="sthref284"></a><a id="sthref285" name="sthref285"></a>Use a <span class="bold">Version Mapping</span> to specify the field used for optimistic locking. If the entity is associated with multiple tables, you should use a version mapping only with the primary table. You should have only a single version mapping per persistent entity. Version mappings may be used only with the following attribute types:</p> +<ul> +<li> +<p><code>int</code></p> +</li> +<li> +<p><code>Integer</code></p> +</li> +<li> +<p><code>short, Short</code></p> +</li> +<li> +<p><code>long, Long</code></p> +</li> +<li> +<p><code>Timestamp</code></p> +</li> +</ul> +<p>To create a version mapping:</p> <ol> <li> <p>In the <a href="ref_persistence_outline.htm#BABEGGFE">JPA Structure view</a>, select the field to map.</p> </li> <li> -<p>Right-click the field and then select <span class="bold">Map As Transient</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> -<div class="figure"><a id="sthref275" name="sthref275"></a> -<p class="titleinfigure">JPA Details, Transient Mapping</p> -<img src="img/jpa_details_transient.png" alt="JPA Details, Transient Mapping" title="JPA Details, Transient Mapping" /><br /></div> +<p>Right-click the field and then select <span class="bold">Map As > Version</span>. The <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a> displays the properties for the selected.</p> +<div class="figure"><a id="sthref286" name="sthref286"></a> +<p class="titleinfigure">JPA Details, Version Mapping</p> +<img src="img/jpa_details_version.png" alt="JPA Details, Version Mapping" title="JPA Details, Version Mapping" /><br /></div> <!-- class="figure" --></li> +<li> +<p>Complete each field in the <a href="reference042.htm#CACHAEBB">Version Mapping</a> area.</p> +</li> +<li> +<p>Complete the remaining areas in the <a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a>:</p> +<ul> +<li> +<p><a href="reference043.htm#CACIHAAF">Type information</a></p> +</li> +<li> +<p><a href="reference045.htm#CACJCHJB">Converters</a></p> +</li> +</ul> +</li> </ol> -<p>There are no additional options for Transient mappings. Eclipse adds the following annotation to the field:</p> +<p>Eclipse adds the following annotations to the field:</p> <pre xml:space="preserve" class="oac_no_warn"> -@Transient +@Version +@Column(table="<span class="italic"><COLUMN_TABLE></span>", name="<<span class="italic">COLUMN_NAME</span>>") + </pre> -<a id="sthref276" name="sthref276"></a> +<a id="sthref287" name="sthref287"></a> <p class="subhead2">Related tasks</p> <ul> <li> <p><a href="task_mapping.htm#BABDGBIJ">Mapping an entity</a></p> </li> </ul> -<a id="sthref277" name="sthref277"></a> +<a id="sthref288" name="sthref288"></a> <p class="subhead2">Related references</p> <ul> <li> @@ -54,8 +87,14 @@ <li> <p><a href="ref_persistence_map_view.htm#BABIFBAF">JPA Details view (for attributes)</a></p> </li> +<li> +<p><a href="reference043.htm#CACIHAAF">Type information</a></p> +</li> +<li> +<p><a href="reference045.htm#CACJCHJB">Converters</a></p> +</li> </ul> -<a id="sthref278" name="sthref278"></a> +<a id="sthref289" name="sthref289"></a> <p class="subhead2">Related concepts</p> <ul> <li> @@ -67,6 +106,7 @@ </ul> </div> <!-- class="sect2" --> +<!-- class="sect1" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> |