blob: 267b38562e4ca9cd916fad600706e9b66670b8e6 [file] [log] [blame]
<html>
<title>Release Notes for OpenJPA 1.2.2</title>
<body>
<h1>Release Notes for OpenJPA 1.2.2</h1>
<ul>
<li><a href="#Overview">Overview</a></li>
<li><a href="#License">License</a></li>
<li><a href="#Prerequisites">Prerequisites</a></li>
<li><a href="#Documentation">Documentation</a></li>
<li><a href="#GetInvolved">Getting Involved</a></li>
<li><a href="#JIRA">JIRA Issues Resolved</a></li>
<li><a href="#Previous">RELEASE-NOTES for previous releases</a></li>
</ul>
<h2><a name="Overview"></a>Overview</h2>
<p> These notes describe the difference between OpenJPA release 1.2.2
and the preceding release: 1.2.1.
<P>
OpenJPA is a feature-rich implementation of the persistence part of
Java Community Process JSR-220 (Enterprise JavaBeans 3.0), which is
known as the Java Persistence API (JPA).
OpenJPA can be used as a stand-alone POJO persistence layer, or it can be
integrated into any EJB3.0 compliant container and many lightweight frameworks.
This release of OpenJPA is 100% compliant with the JPA specification.
</p>
<p>
Additional information on the OpenJPA project may be found at the project web
site: <a href="http://openjpa.apache.org">
http://openjpa.apache.org</a>
<h2><a name="License"></a>License</h2>
<P>Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
<BR><P><a href="http://www.apache.org/licenses/LICENSE-2.0">
http://www.apache.org/licenses/LICENSE-2.0</a>
<BR><P>Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
<BR><P>The license may also be found in LICENSE.txt which is included
in each release of OpenJPA.
<h2><a name="Prerequisites"></a>Prerequisites</h2>
<P>
In normal usage, OpenJPA requires Java 5 or higher and a relational
database of some sort.
<h2><a name="Documentation"></a>Documentation</h2>
<p>If you have questions about OpenJPA, a good source of information is the
online product manual. You can find the manual for the current release as well
as older releases of OpenJPA at
<a href="http://openjpa.apache.org/documentation.html">
http://openjpa.apache.org/documentation.html</a>
<p>If you can't find what you're looking for in the manual or would like more
clarification you please post to the OpenJPA development mailing list.
Information on all of the OpenJPA mailing lists may be found here:
<a href="http://openjpa.apache.org/mailing-lists.html">
http://openjpa.apache.org/mailing-lists.html</a>
<p>
<h2><a name="GetInvolved"></a>Getting Involved</h2>
<p>
The Apache OpenJPA project is being built by the open source community for the
open source community - we welcome your input and contributions!
<P>
What we are looking for
<ul>
<li> Source code and fixes contributions </li>
<li> Documentation assistance </li>
<li> Product and feature suggestions </li>
<li> Detailed and constructive feedback </li>
<li> Articles and whitepapers </li>
</ul>
<p>
How do I Contribute?
<ul>
<li> To discuss Apache OpenJPA topics check out the mailing lists. </li>
<li> Informal discussion also occurs on the #openjpa IRC channel on
freenode.net. </li>
<li> Bugs and other issues can be posted on the project JIRA. </li>
</ul>
<h2><a name="JIRA"</a>JIRA Issues Fixed in this release</h2>
<h3> Sub-task
</h3>
<ul>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1023'>OPENJPA-1023</a>] - Message files contain windows EOL characters
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1210'>OPENJPA-1210</a>] - Specify derby timeouts via properties.
</li>
</ul>
<h3> Bug
</h3>
<ul>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-466'>OPENJPA-466</a>] - Primary key constraint violated using (Oracle) sequence to generate ID in multithreaded app
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-714'>OPENJPA-714</a>] - &quot;Encountered unmanaged object in persistent field&quot; error while merging object tree
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-732'>OPENJPA-732</a>] - Updates to entities via Lifecycle callback methods
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-873'>OPENJPA-873</a>] - @MappedSuperClass Cause Null Pointer Exception in Class With IdClass
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-896'>OPENJPA-896</a>] - Several source files include Windows EoL chars
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1025'>OPENJPA-1025</a>] - AbstractResultList.subList throws UnsupportedOperationException
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1029'>OPENJPA-1029</a>] - SQLServerDictionary causes NumberFormatException if MS SQL Server JDBC driver is used
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1061'>OPENJPA-1061</a>] - Entities extending from a Mapped Superclass that defines the ID fields share the same ObjectID type parameter
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1067'>OPENJPA-1067</a>] - SetQueryTimeout(x) where x != 0 causes SQLException with DB2 on Z/OS
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1141'>OPENJPA-1141</a>] - NPE at org.apache.openjpa.jdbc.meta.MappingInfo.mergeJoinColumn(MappingInfo.java:1400)
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1156'>OPENJPA-1156</a>] - Path length issues on Windows
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1197'>OPENJPA-1197</a>] - NativeQueries fail with MySQL
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1308'>OPENJPA-1308</a>] - shouldn't always use CAST with UPPER and LOWER for DB2
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1326'>OPENJPA-1326</a>] - ReverseMappingTool and SchemaTool failing for Sybase
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1328'>OPENJPA-1328</a>] - Move cacheable class configuration to ClassMetaData
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1359'>OPENJPA-1359</a>] - SQLServer driver 2.0 works, but causes exception in SQLServerDictionary on the first connection
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1384'>OPENJPA-1384</a>] - ClassNotFoundException for custom DBDictionary used by EJB
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1397'>OPENJPA-1397</a>] - NULL in columns part of an @IdClass composite key leads to &quot;disappearing&quot; (null) returned objects
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1400'>OPENJPA-1400</a>] - Unable to persist a relationship to a detached Entity
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1421'>OPENJPA-1421</a>] - Reduce lock contention in JDBCStoreManager
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1441'>OPENJPA-1441</a>] - NPE when enhancing a Serializable, versioned class
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1457'>OPENJPA-1457</a>] - Remove Java.net maven repostiory from tck pom.xml
</li>
</ul>
<h3> Improvement
</h3>
<ul>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-250'>OPENJPA-250</a>] - Reduce synchronization bottlenecks in data cache, metadata repository, and lifecycle event manager
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-975'>OPENJPA-975</a>] - Oracle needs ability to not have an escape character for search strings.
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-991'>OPENJPA-991</a>] - Implement LockTimeout using db specific server-side lock timeout feature
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1045'>OPENJPA-1045</a>] - Add opt-in and opt-out configuration for L2 DataCache
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1136'>OPENJPA-1136</a>] - Add .gitignore for git users
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1171'>OPENJPA-1171</a>] - Use StringBuilder instead of StringBuffer in SQLBuffer
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1172'>OPENJPA-1172</a>] - Use java.util.concurrent.ConcurrentHashMap rather than a synchronized HashMap in ClassMapping.
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1414'>OPENJPA-1414</a>] - Performance improvements for detach
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1415'>OPENJPA-1415</a>] - Performance improvement by reduced logging of batched OLE
</li>
</ul>
<h3> Test
</h3>
<ul>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1071'>OPENJPA-1071</a>] - Derby test suit speed-up
</li>
<li>[<a href='https://issues.apache.org/jira/browse/OPENJPA-1092'>OPENJPA-1092</a>] - enable test case for jpql
</li>
</ul>
<h2><a name="Previous"></a> Previous Releases
</h2>
Release notes for earlier releases of OpenJPA may be found in SVN at the following locations.
<li><a href='http://svn.apache.org/viewvc/openjpa/tags/1.2.1/openjpa-project/RELEASE-NOTES.html?view=co'>OpenJPA 1.2.1 RELEASE-NOTES.html</a></li>
<li><a href='http://svn.apache.org/viewvc/openjpa/tags/1.2.0/openjpa-project/RELEASE-NOTES.html?view=co'>OpenJPA 1.2.0 RELEASE-NOTES.html</a></li>
</body>
</html>