openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From strub...@apache.org
Subject svn commit: r953480 [5/37] - in /websites/production/openjpa/content/builds/2.4.0: ./ apache-openjpa/ apache-openjpa/docs/
Date Mon, 01 Jun 2015 20:19:02 GMT
Propchange: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/introduction.html
==============================================================================
--- websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/introduction.html
(added)
+++ websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/introduction.html
Mon Jun  1 20:19:00 2015
@@ -0,0 +1,25 @@
+<html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>Part&nbsp;1.&nbsp;Introduction</title><base href="display"><link
rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook
XSL-NS Stylesheets V1.76.1"><link rel="home" href="manual.html" title="Apache OpenJPA
2.4 User's Guide"><link rel="up" href="manual.html" title="Apache OpenJPA 2.4 User's
Guide"><link rel="prev" href="manual.html" title="Apache OpenJPA 2.4 User's Guide"><link
rel="next" href="openjpa_intro.html" title="Chapter&nbsp;1.&nbsp; About"></head><body
bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table
width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Part&nbsp;1.&nbsp;Introduction</th></tr><tr><td
width="20%" align="left"><a accesskey="p" href="manual.html">Prev</a>&nbsp;</td><th
width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a
accesskey="n" href="openjpa_intro.html">Next</a></td></tr></table><hr></div><div
class="p
 art" title="Part&nbsp;1.&nbsp;Introduction" id="introduction"><div class="titlepage"><div><div><h1
class="title">Part&nbsp;1.&nbsp;Introduction</h1></div></div></div><div
class="toc"><p><b>Table of Contents</b></p><dl><dt><span
class="chapter"><a href="openjpa_intro.html">1. 
+        About
+    </a></span></dt><dt><span class="chapter"><a href="openjpa_legal.html">2.

+        Legal
+    </a></span></dt><dd><dl><dt><span class="section"><a
href="openjpa_legal.html#openjpa_legal_license">1. 
+            License
+        </a></span></dt><dt><span class="section"><a href="openjpa_legal_notice.html">2.

+            Notice
+        </a></span></dt><dt><span class="section"><a href="openjpa_legal_copyright.html">3.

+            Copyrights
+        </a></span></dt><dd><dl><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_apache">3.1. Apache</a></span></dt><dt><span
class="section"><a href="openjpa_legal_copyright.html#openjpa_legal_copyright_serp">3.2.
Serp</a></span></dt><dt><span class="section"><a href="openjpa_legal_copyright.html#openjpa_legal_copyright_sun">3.3.
Sun</a></span></dt><dt><span class="section"><a href="openjpa_legal_copyright.html#openjpa_legal_copyright_other">3.4.
Other</a></span></dt></dl></dd></dl></dd></dl></div>
+        
+        
+
+
+
+        
+
+
+
+    </div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p" href="manual.html">Prev</a>&nbsp;</td><td
width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a
accesskey="n" href="openjpa_intro.html">Next</a></td></tr><tr><td
width="40%" align="left" valign="top">Apache OpenJPA 2.4 User's Guide&nbsp;</td><td
width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td
width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;1.&nbsp;
+        About
+    </td></tr></table></div></body></html>
\ No newline at end of file

Propchange: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/introduction.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.2.html
==============================================================================
--- websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.2.html (added)
+++ websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.2.html Mon
Jun  1 20:19:00 2015
@@ -0,0 +1,207 @@
+<html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>2.&nbsp; OpenJPA 2.2.0</title><base href="display"><link
rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook
XSL-NS Stylesheets V1.76.1"><link rel="home" href="manual.html" title="Apache OpenJPA
2.4 User's Guide"><link rel="up" href="migration_considerations.html" title="Appendix&nbsp;3.&nbsp;
Migration Considerations"><link rel="prev" href="migration_considerations.html" title="Appendix&nbsp;3.&nbsp;
Migration Considerations"><link rel="next" href="jpa_2.3.html" title="3.&nbsp; OpenJPA
2.3.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">2.&nbsp;
+            OpenJPA 2.2.0
+        </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="migration_considerations.html">Prev</a>&nbsp;</td><th width="60%"
align="center">Appendix&nbsp;3.&nbsp;
+        Migration Considerations
+    </th><td width="20%" align="right">&nbsp;<a accesskey="n" href="jpa_2.3.html">Next</a></td></tr></table><hr></div><div
class="section" title="2.&nbsp; OpenJPA 2.2.0"><div class="titlepage"><div><div><h2
class="title" style="clear: both" id="jpa_2.2">2.&nbsp;
+            OpenJPA 2.2.0
+        </h2></div></div></div><div class="toc"><dl><dt><span
class="section"><a href="jpa_2.2.html#jpa_2.2_incompatibilities">2.1. Incompatibilities</a></span></dt><dd><dl><dt><span
class="section"><a href="jpa_2.2.html#jpa_2.2_allocationSize">2.1.1. 
+                    allocationSize Property of Sequence Generator
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_metamodelArrays">2.1.2. 
+                    MetaModel Attributes for Arrays  
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_SupportsSetClob">2.1.3. 
+                    supportsSetClob Property.  
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_UseNativeSequenceCache">2.1.4. 
+                    useNativeSequenceCache Property.  
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_cascadePersist">2.1.5. 
+                    Cascade persist behavior
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_LifecycleEventManager">2.1.6. 
+                    Life Cycle Event Manager Callback Behavior 
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_sharedCacheMode">2.1.7. 
+                    shared-cache-mode Property
+                </a></span></dt></dl></dd></dl></div>
+        
+        <div class="section" title="2.1.&nbsp;Incompatibilities"><div class="titlepage"><div><div><h3
class="title" id="jpa_2.2_incompatibilities">2.1.&nbsp;Incompatibilities</h3></div></div></div><div
class="toc"><dl><dt><span class="section"><a href="jpa_2.2.html#jpa_2.2_allocationSize">2.1.1.

+                    allocationSize Property of Sequence Generator
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_metamodelArrays">2.1.2. 
+                    MetaModel Attributes for Arrays  
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_SupportsSetClob">2.1.3. 
+                    supportsSetClob Property.  
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_UseNativeSequenceCache">2.1.4. 
+                    useNativeSequenceCache Property.  
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_cascadePersist">2.1.5. 
+                    Cascade persist behavior
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_LifecycleEventManager">2.1.6. 
+                    Life Cycle Event Manager Callback Behavior 
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_sharedCacheMode">2.1.7. 
+                    shared-cache-mode Property
+                </a></span></dt></dl></div>
+            
+       	    <p>
+                The following sections indicate changes that are incompatible
+                between OpenJPA 2.1.x releases and the 2.2.0 release.
+            </p>
+            <div class="section" title="2.1.1.&nbsp; allocationSize Property of Sequence
Generator"><div class="titlepage"><div><div><h4 class="title" id="jpa_2.2_allocationSize">2.1.1.&nbsp;
+                    allocationSize Property of Sequence Generator
+                </h4></div></div></div>
+                
+                
+                <p>
+                    In previous releases, specifying the <code class="literal">allocationSize</code>
property of
+                    <a class="link" href="jpa_overview_mapping_sequence.html#jpa_overview_mapping_sequence_seqgen"
title="5.1.&nbsp; Sequence Generator">sequence generator</a>
+                    affected only sequence definition in the database. During
+                    schema creation, the <code class="literal">INCREMENT BY</code>
clause of
+                    <code class="literal">CREATE SEQUENCE</code> statement always
+                    had a value of 1 and on DB2, Oracle and PostgreSQL databases a <code
class="literal">CACHE</code> clause
+                    was added with the value of <code class="literal">allocationSize</code>
property. Such a statement caused
+                    sequence values being cached in the database. Starting with OpenJPA 2.2.0,
+                    sequence values are cached in the jvm memory and the <code class="literal">allocationSize</code>
+                    property determines size of that cache. The <code class="literal">CACHE</code>
clause is no longer used,
+                    instead the <code class="literal">INCREMENT BY</code> clause
gets its value equal to the
+                    <code class="literal">allocationSize</code> property. Such
a strategy reduces the number of database roundtrips
+                    required for retrieving sequence values considerably.
+                </p>
+                <p>
+                    In order for the existing applications to work with OpenJPA
+                    2.2.0, you have to manually recreate or redefine sequences, specifying
+                    the correct <code class="literal">INCREMENT BY</code> value
and, possibly, correct initial sequence value.
+                    Note that the default value of the <code class="literal">allocationSize</code>
property is 50 and that
+                    value is used if the property is not specified.
+                </p>
+                <p>
+                    The requirement for sequence modification applies to all databases that
support sequences, regardless of
+                    the <code class="literal">CACHE</code> clause being supported.
The only exception is Firebird database -
+                    since with this database the increment step is determined during sequence
+                    value fetch, no migration activity is needed.
+                </p>
+                <p>
+                    To maintain the old behavior of sequence generator in OpenJPA 2.2.0,
you can:
+                    </p><div class="itemizedlist"><ul class="itemizedlist"
type="disc"><li class="listitem">
+                            <p>
+                                Set the <code class="literal">allocationSize</code>
property value to 1.
+                            </p>
+                        </li><li class="listitem">
+                            <p>
+                                Additionally, if the <code class="literal">CACHE</code>
clause has to be emitted in sequence definition,
+                                this can be accomplished by overriding the
+                                <a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/sql/DBDictionary.html#getCreateSequenceSQL(org.apache.openjpa.jdbc.schema.Sequence)"
target="_top">
+                                <code class="methodname">DBDictionary.getCreateSequenceSQL</code></a>
method.
+                            </p>
+                        </li></ul></div><p>
+                </p>
+            </div>
+            <div class="section" title="2.1.2.&nbsp; MetaModel Attributes for Arrays"><div
class="titlepage"><div><div><h4 class="title" id="jpa_2.2_metamodelArrays">2.1.2.&nbsp;
+                    MetaModel Attributes for Arrays  
+                </h4></div></div></div>
+                
+                
+                <p>
+                    In previous releases OpenJPA's MetaModel implementation generated a ListAttribute
for every array. This behavior is correct if the array 
+                    is annotated as a PersistentCollection, but not correct for un-annotated
arrays (e.g. byte[], char[]). In OpenJPA 2.2.0 this behavior was corrected 
+                    so that arrays which are not stored as PersistentCollections will use
a SingularAttribute instead of a ListAttribute. 
+                </p>
+                <p>
+                    If your application uses the MetaModel API and your entities contain
arrays of any of the following types: byte[], Byte[], char[], Character[] and
+                    do not use the @PersistentCollection annotation with those fields you
will need to update your application to use OpenJPA 2.2.0.
+                </p>
+                <p> In order for the existing applications to work with OpenJPA you
may: 
+                    </p><div class="itemizedlist"><ul class="itemizedlist"
type="disc"><li class="listitem">
+                            <p> Regenerate the canonical metamodel classes</p>
+                        </li><li class="listitem">
+                            <p> Set the Compatibility property <code class="literal">UseListAttributeForArrays</code>
to <code class="literal">true</code> in persistence.xml 
+                                </p><pre class="programlisting"> &lt;property
name="openjpa.Compatibility" value="UseListAttributeForArrays=true"/&gt;</pre><p>
+                            </p>
+                        </li></ul></div><p>    
+                </p>
+            </div>
+            <div class="section" title="2.1.3.&nbsp; supportsSetClob Property."><div
class="titlepage"><div><div><h4 class="title" id="jpa_2.2_SupportsSetClob">2.1.3.&nbsp;
+                    supportsSetClob Property.  
+                </h4></div></div></div>
+                
+                
+                <p>
+                    In OpenJPA 2.2.0, code was added to allow the setting of CLOB or XML
data larger than 4000 bytes.  This functionality
+                    was eventually back ported to previous releases, and enabled by the <code
class="literal">supportsSetClob</code> property on the OracleDictionary.  Setting
this property 
+                    has no effect in 2.2.0 and later releases and any occurrence of it should
be removed.
+                </p>
+            </div>            
+            <div class="section" title="2.1.4.&nbsp; useNativeSequenceCache Property."><div
class="titlepage"><div><div><h4 class="title" id="jpa_2.2_UseNativeSequenceCache">2.1.4.&nbsp;
+                    useNativeSequenceCache Property.  
+                </h4></div></div></div>
+                
+                
+                <p>
+                    In OpenJPA 2.2.0, code was added which changed the way sequences were
generated, please see 
+                    <a class="xref" href="jpa_2.2.html#jpa_2.2_allocationSize" title="2.1.1.&nbsp;
allocationSize Property of Sequence Generator">Section&nbsp;2.1.1, &#8220;
+                    allocationSize Property of Sequence Generator
+                &#8221;</a> for details.  This functionality was eventually back
ported 
+                    to previous releases, and enabled by the <code class="literal">useNativeSequenceCache</code>
property on the DBDictionary.  Setting this property 
+                    has no effect in 2.2.0 and later releases and any occurrence of it should
be removed.  If previous behavior is
+                    desired (i.e. <code class="literal">useNativeSequenceCache=true</code>),
please see the details described in section 
+                    <a class="xref" href="jpa_2.2.html#jpa_2.2_allocationSize" title="2.1.1.&nbsp;
allocationSize Property of Sequence Generator">Section&nbsp;2.1.1, &#8220;
+                    allocationSize Property of Sequence Generator
+                &#8221;</a>.
+                </p>
+            </div>            
+        	<div class="section" title="2.1.5.&nbsp; Cascade persist behavior"><div
class="titlepage"><div><div><h4 class="title" id="jpa_2.2_cascadePersist">2.1.5.&nbsp;
+                    Cascade persist behavior
+                </h4></div></div></div>
+                
+                
+				<p>
+					In previous releases, OpenJPA would check the database for the
+					existence of the related Entity before persisting the relationship to
+					that Entity. This resulted in an extra Select being sent to the
+					database. In 2.2.0, code was added so that when cascading a persist to
+					a related Entity without persistence state, the persist (insert) will
+					happen without first checking the database. This may result in an
+					EntityExistsException if the related Entity already exists in the
+					database. To revert this behavior to the previous release, set the
+					value of the <code class="literal">openjpa.Compatibility</code>
+					property <code class="literal">CheckDatabaseForCascadePersistToDetachedEntity</code>
+					to <code class="literal">true</code>.
+				</p>
+            </div>
+            <div class="section" title="2.1.6.&nbsp; Life Cycle Event Manager Callback
Behavior"><div class="titlepage"><div><div><h4 class="title" id="jpa_2.2_LifecycleEventManager">2.1.6.&nbsp;
+                    Life Cycle Event Manager Callback Behavior 
+                </h4></div></div></div>
+                
+                
+                <p>
+                    Life cycle event manager is used to manage entity's life cycle event
callback.
+                    In previous releases, Life cycle event manager is scoped to EntityManagerFactory.
+                    This means listeners registered to an individual EntityManager may get
life cycle
+                    event callbacks for entity that it does not manage. 
+                </p>
+                <p>
+                    From 2.2.1 release, the default callback behavior of the life cycle event
manager
+                    is changed to scope to each EntityManager.                     
+                    To revert this behavior to the previous release, set the
+                    value of the <code class="literal">openjpa.Compatibility</code>
+                    property <code class="literal">SingletonLifecycleEventManager</code>
+                    to <code class="literal">true</code>.
+                </p>
+            </div>
+            <div class="section" title="2.1.7.&nbsp; shared-cache-mode Property"><div
class="titlepage"><div><div><h4 class="title" id="jpa_2.2_sharedCacheMode">2.1.7.&nbsp;
+                    shared-cache-mode Property
+                </h4></div></div></div>
+                
+                
+                <p>
+                     In the previous release, when the shared-cache-mode is enabled and the
DataCache property is not set 
+                     or set to false, there will be no data caching.
+                </p>
+                <p>
+                     From 2.2.2 release, the caching will be turned on if the shared-cache-mode
is enabled. Please see the 
+                     details described in section <a class="xref" href="ref_guide_caching.html#ref_guide_shared_cache_mode_integration"
title="1.1.2.&nbsp; Integration with JPA standard shared cache mode">Section&nbsp;1.1.2,
&#8220;
+                Integration with JPA standard shared cache mode
+            &#8221;</a>.
+                </p>
+            </div>
+        </div>
+    </div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p" href="migration_considerations.html">Prev</a>&nbsp;</td><td
width="20%" align="center"><a accesskey="u" href="migration_considerations.html">Up</a></td><td
width="40%" align="right">&nbsp;<a accesskey="n" href="jpa_2.3.html">Next</a></td></tr><tr><td
width="40%" align="left" valign="top">Appendix&nbsp;3.&nbsp;
+        Migration Considerations
+    &nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td
width="40%" align="right" valign="top">&nbsp;3.&nbsp;
+            OpenJPA 2.3.0
+        </td></tr></table></div></body></html>
\ No newline at end of file

Propchange: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.2.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.3.html
==============================================================================
--- websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.3.html (added)
+++ websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.3.html Mon
Jun  1 20:19:00 2015
@@ -0,0 +1,85 @@
+<html><head>
+      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+   <title>3.&nbsp; OpenJPA 2.3.0</title><base href="display"><link
rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook
XSL-NS Stylesheets V1.76.1"><link rel="home" href="manual.html" title="Apache OpenJPA
2.4 User's Guide"><link rel="up" href="migration_considerations.html" title="Appendix&nbsp;3.&nbsp;
Migration Considerations"><link rel="prev" href="jpa_2.2.html" title="2.&nbsp; OpenJPA
2.2.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">3.&nbsp;
+            OpenJPA 2.3.0
+        </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="jpa_2.2.html">Prev</a>&nbsp;</td><th width="60%" align="center">Appendix&nbsp;3.&nbsp;
+        Migration Considerations
+    </th><td width="20%" align="right">&nbsp;</td></tr></table><hr></div><div
class="section" title="3.&nbsp; OpenJPA 2.3.0"><div class="titlepage"><div><div><h2
class="title" style="clear: both" id="jpa_2.3">3.&nbsp;
+            OpenJPA 2.3.0
+        </h2></div></div></div><div class="toc"><dl><dt><span
class="section"><a href="jpa_2.3.html#jpa_2.3_incompatibilities">3.1. Incompatibilities</a></span></dt><dd><dl><dt><span
class="section"><a href="jpa_2.3.html#jpa_2.3_MappingTool">3.1.1. 
+                    MappingTool Behavior for DB2 and Derby
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.3.html#jpa_2.3_RequiresSearchStringEscapeForLike">3.1.2. 
+                    RequiresSearchStringEscapeForLike DBDictionary Property
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.3.html#ReturnNullOnEmptyAggregateResult">3.1.3. 
+                    Return value of aggregate functions in SELECT clause 
+                </a></span></dt></dl></dd></dl></div>
+        
+        <div class="section" title="3.1.&nbsp;Incompatibilities"><div class="titlepage"><div><div><h3
class="title" id="jpa_2.3_incompatibilities">3.1.&nbsp;Incompatibilities</h3></div></div></div><div
class="toc"><dl><dt><span class="section"><a href="jpa_2.3.html#jpa_2.3_MappingTool">3.1.1.

+                    MappingTool Behavior for DB2 and Derby
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.3.html#jpa_2.3_RequiresSearchStringEscapeForLike">3.1.2. 
+                    RequiresSearchStringEscapeForLike DBDictionary Property
+                </a></span></dt><dt><span class="section"><a
href="jpa_2.3.html#ReturnNullOnEmptyAggregateResult">3.1.3. 
+                    Return value of aggregate functions in SELECT clause 
+                </a></span></dt></dl></div>
+            
+       	    <p>
+                The following sections indicate changes that are incompatible
+                between OpenJPA 2.2.x releases and the 2.3.0 release.
+            </p>    
+            <div class="section" title="3.1.1.&nbsp; MappingTool Behavior for DB2
and Derby"><div class="titlepage"><div><div><h4 class="title" id="jpa_2.3_MappingTool">3.1.1.&nbsp;
+                    MappingTool Behavior for DB2 and Derby
+                </h4></div></div></div>
+                
+                <p>
+                    In previous releases, the MappingTool mapped <code class="literal">java.math.BigDecimal</code>
fields to the database type
+                    DOUBLE, and as such, ignored <code class="literal">column</code>
and <code class="literal">precision</code> values that might have been specified
via the
+                    <code class="literal">javax.persistence.Column</code> annotation.
+                </p>
+                <p>
+                    From the 2.3.0 release, <code class="literal">java.math.BigDecimal</code>
fields are now mapped to the database type DECIMAL
+                    and it is very likely that you will need to specify <code class="literal">column</code>
and <code class="literal">precision</code> via
+                    the <code class="literal">javax.persistence.Column</code>
annotation.
+                </p>
+            </div>
+            <div class="section" title="3.1.2.&nbsp; RequiresSearchStringEscapeForLike
DBDictionary Property"><div class="titlepage"><div><div><h4 class="title"
id="jpa_2.3_RequiresSearchStringEscapeForLike">3.1.2.&nbsp;
+                    RequiresSearchStringEscapeForLike DBDictionary Property
+                </h4></div></div></div>
+                
+                
+                <p>
+                    In previous releases, the default value for the property RequiresSearchStringEscapeForLike
is true and caused the 
+                    unexpected escape clause appended to the SQL statement.
+                    For example, user created a named query like this:
+                    </p><pre class="programlisting"> SELECT o.computerName FROM
CompUser o WHERE o.name LIKE ?</pre><p>
+                    At run time the following query is generated: 
+                    </p><pre class="programlisting"> SELECT t0.computerName FROM
CompUser t0 WHERE (t0.name LIKE ? ESCAPE '\')</pre><p>                     
+                    ESCAPE '\' shouldn't be appended to the query.
+                </p>
+                <p>
+                    From the 2.3.0 release, RequiresSearchStringEscapeForLike property is
set to false by default. You can configure 
+                    RequiresSearchStringEscapeForLike property to be true if the old behavior
is desired. 
+                </p>
+            </div>
+            <div class="section" title="3.1.3.&nbsp; Return value of aggregate functions
in SELECT clause"><div class="titlepage"><div><div><h4 class="title"
id="ReturnNullOnEmptyAggregateResult">3.1.3.&nbsp;
+                    Return value of aggregate functions in SELECT clause 
+                </h4></div></div></div>
+                
+                
+                <p>
+                    The JPA specification states "If SUM, AVG, MAX, or MIN is used, and there
are no values to which the aggregate function can be
+                    applied, the result of the aggregate function is NULL."  Prior to this
update, OpenJPA incorrectly returned 0 for SUM, AVG, MIN, 
+                    and MAX when a state field being aggregated is numeric.  This behavior
affects both JPQL and Criteria queries.  With this update,
+                    OpenJPA will return a null result value for these aggregate functions
when a query returns no result.
+                </p>
+                <p>
+                    To re-enable the prior behavior, you need to set the following persistence
property in your persistence.xml or when
+                    creating an EntityManagerFactory.
+                    </p><pre class="programlisting">
+    &lt;property name="openjpa.Compatibility" value="ReturnNullOnAggregateResult=false"/&gt;
+                    </pre><p>
+                </p>
+            </div>
+        </div>
+    </div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p" href="jpa_2.2.html">Prev</a>&nbsp;</td><td
width="20%" align="center"><a accesskey="u" href="migration_considerations.html">Up</a></td><td
width="40%" align="right">&nbsp;</td></tr><tr><td width="40%"
align="left" valign="top">2.&nbsp;
+            OpenJPA 2.2.0
+        &nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td
width="40%" align="right" valign="top">&nbsp;</td></tr></table></div></body></html>
\ No newline at end of file

Propchange: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/jpa_2.3.html
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message