svn commit: r939451 - in /openjpa/branches/1.3.x/openjpa-project/src/doc/manual: jpa_overview_mapping.xml jpa_overview_meta.xml

[mi...@apache.org]

Author: mikedd
Date: Thu Apr 29 18:54:40 2010
New Revision: 939451

URL: http://svn.apache.org/viewvc?rev=939451&view=rev
Log:
Update manual on difference between nullable=false and optional=false

Modified:
    openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_mapping.xml
    openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_meta.xml

Modified: openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_mapping.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_mapping.xml?rev=939451&r1=939450&r2=939451&view=diff
==============================================================================
--- openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_mapping.xml (original)
+++ openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_mapping.xml Thu Apr 29 18:54:40 2010
@@ -99,6 +99,14 @@ JPA uses the defaults defined by the spe
 each mapping throughout this chapter, we also describe the defaults that apply
 when the mapping is absent.
     </para>
+    <note>
+        <para>
+Mapping metadata is used primarily with schema generation. This metadata should not
+be relied upon for validation prior to communicating with the database. 
+For example using the @Column(nullable=false) annotation does not do up front validation
+that the value in the entity is correct. 
+        </para>
+    </note>
     <section id="jpa_overview_mapping_table">
         <title>
             Table

Modified: openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_meta.xml
URL: http://svn.apache.org/viewvc/openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_meta.xml?rev=939451&r1=939450&r2=939451&view=diff
==============================================================================
--- openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_meta.xml (original)
+++ openjpa/branches/1.3.x/openjpa-project/src/doc/manual/jpa_overview_meta.xml Thu Apr 29 18:54:40 2010
@@ -107,6 +107,15 @@ in the Reference Guide for details. Ther
 these extension annotations.
         </para>
     </note>
+    <note>
+        <para>
+Persistence metadata may be used to validate the contents of your entities prior to communicating
+with the database. This differs from mapping meta data which is primarily used for schema generation.
+For example if you indicate that a relationship is not optional (e.g. @Basic(optional=false)) OpenJPA
+will validate that the variable in your entity is not null <emphasis>before</emphasis> inserting a row 
+in the database. 
+        </para>
+    </note>
     <mediaobject>
         <imageobject>
             <!-- PNG image data, 553 x 580 (see README) -->