Skip to main content
diff options
authormtaal2006-09-26 08:45:14 -0400
committermtaal2006-09-26 08:45:14 -0400
commit72159b8a00d87c3253eaa54ac0a011a921972c45 (patch)
parent2873c8165e3804f757d0523792ded982653040f8 (diff)
Update docs for always_version option
2 files changed, 15 insertions, 2 deletions
diff --git a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml
index 06c06d5c7..d8a30e483 100644
--- a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml
+++ b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/hibernate_details.xml
@@ -9,7 +9,7 @@
@author <a href="">Martin Taal</a>
- @version $Revision: 1.2 $ $Date: 2006/09/13 16:05:49 $
+ @version $Revision: 1.3 $ $Date: 2006/09/26 12:45:14 $
@@ -74,6 +74,16 @@
<p>Primitive features and single refererences are eagerly loaded. ELists are
lazily loaded. In the future probably also single-references will be lazily loaded.</p>
+ <section><title>Synthetic ID and Version properties</title>
+ <p>When Teneo detects that a certain type does not have an id or version annotated property then
+ it will add these automatically. The synthetic id and version are hidden for the developer. You can
+ retrieve the hidden synthetic id or version through the class org.eclipse.emf.teneo.hibernate.mapping.identifier.IdentifierCacheHandler.
+ You can prevent the automatic adding of a synthetic version property by setting the PersistenceOptions.ALWAYS_VERSION
+ to false, see <a href="options.html">here</a>. If this property is false then only efeatures with a version annotation are
+ translated into a version mapping.</p>
+ <p>Synthetic id and version use object equality (==), this means that synthetic id and version will not
+ work if objects are transferred to other systems and back (for example in case of client-server communication).</p>
+ </section>
<section id="cutpaste">
<title>Move an EObject between EContainers or support cut and paste in the EMF editor</title>
<p>In the standard approach it is not possible to move an EObject from one containment relation to another containment relation. A move
diff --git a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml
index 7b490d7eb..47d3ca906 100644
--- a/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml
+++ b/doc/org.eclipse.emf.teneo.doc/doc/hibernate/options.xml
@@ -9,7 +9,7 @@
@author <a href="">Martin Taal</a>
- @version $Revision: 1.3 $ $Date: 2006/09/13 16:05:49 $
+ @version $Revision: 1.4 $ $Date: 2006/09/26 12:45:14 $
@@ -26,6 +26,9 @@
<p>Options are passed to the HbDataStore using a Properties object which is set using the HbDataStore.setPersistenceProperties method.</p>
<p>Boolean options can have the lower case String values: "false" or "true".</p>
+ <li><strong>PersistenceOptions.ALWAYS_VERSION</strong>: this option (boolean, default: true) determines if the system should automatically
+ add a version attribute to each class mapping. If set to true (the default) then the system will add a version property to the mapping if
+ no other eattribute has a version annotation. If set to false then the version property is not added automatically.</li>
<li><strong>PersistenceOptions.DISABLE_ECONTAINER_MAPPING</strong>: this option (boolean) controls if the container relations
are mapped explicitly in the database, see also <a href="hibernate_relations.html#Storing+container+relation">here</a>.</li>
<li><strong>PersistenceOptions.FETCH_CONTAINMENT_EAGERLY</strong>: if set to "true" will set the fetch strategy of all

Back to the top