openjpa/openjpa-project/CHANGES.txt

316 lines
15 KiB
Plaintext

Release Notes for OpenJPA
* Overview
* License
* Prerequisites
* Documentation
* Getting Involved
* Bugs
* Improvements
* New Features
* Task
* Test
Overview
These notes describe the difference between OpenJPA release 1.0.0 and the
preceding releases, 0.9.6 and 0.9.7. 1.0.0 is the first major release
since OpenJPA graduated to an Apache top level project (TLP), and contains
many new features and bugfixes.
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.
Additional information on the OpenJPA project may be found at the project
web site: http://openjpa.apache.org
License
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
http://www.apache.org/licenses/LICENSE-2.0
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.
The license may also be found in LICENSE.txt which is included in each
release of OpenJPA.
Prerequisites
OpenJPA requires Java 1.5 but will not compile with Java 6. For more
detail please see http://issues.apache.org/jira/browse/OPENJPA-5
Documentation
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
http://openjpa.apache.org/documentation.html
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:
http://openjpa.apache.org/mailing-lists.html
Getting Involved
The Apache OpenJPA project is being built by the open source community for
the open source community - we welcome your input and contributions!
What we are looking for
* Source code and fixes contributions
* Documentation assistance
* Product and feature suggestions
* Detailed and constructive feedback
* Articles and whitepapers
How do I Contribute?
* To discuss Apache OpenJPA topics check out the mailing lists.
* Informal discussion also occurs on the #openjpa IRC channel on
freenode.net.
* Bugs and other issues can be posted on the project JIRA.
OpenJPA 0.9.7 Release Notes
Bugs
The following bugs have been fixed for release 0.9.7
* [OPENJPA-16] - NPE in createQuery for EJB QL with nested correlated
subqueries
* [OPENJPA-21] - Time is missing from list of mutable classes.
* [OPENJPA-22] - locate & substring queries fail both db2 & derby,
cannot use parameter markers in expression ?-?
* [OPENJPA-23] - -418 sqlexception using DB2 and EJB QL with SQRT or MOD
* [OPENJPA-24] - Allow OpenJPA to be extensible
* [OPENJPA-25] - Incorrect SQL generated for queries involving more than
one AbstractSchemaNames, generated SQL FROM clause is missing 'Table
alias'
* [OPENJPA-35] - In-memory Delete operation fails with active DataCache
* [OPENJPA-41] - transforming classes doesn't work
* [OPENJPA-48] - parsing error - cast of subselect does not work
* [OPENJPA-50] - bad sql pushdown, cast changes datatype
* [OPENJPA-53] - bad sql pushdown for nested subselects, missing nested
subselect
* [OPENJPA-54] - bad sql pushdown, should use all syntax
* [OPENJPA-56] - in derby concat with input parameter needs a cast,
otherwise becomes long varchar and some operations do not work
* [OPENJPA-60] - Specifying the wrong persistence implementation in
persistence.xml leads to misleading error message
* [OPENJPA-62] - Ejbql join queries show invalid null Entities when run
in a new persistence context where no entity instances exist.
* [OPENJPA-71] - Caching primitive array types consumes excessive memory
* [OPENJPA-77] - Problems in default setting in DB2Dictionary , also
missing support for DB2 z/OS platforms
* [OPENJPA-80] - Bad Escaping for LIKE in MySQL
* [OPENJPA-98] - Java deadlock when insert in t1 and find in t2 when
using IBM JVM 1.5.0
* [OPENJPA-100] - entries failing to be processed for persistence unit
rooted in an EAR
* [OPENJPA-102] - JTA transaction rollback, nonexistant instances,
transactional persistence context => failures during afterCompletion()
and close()
* [OPENJPA-103] - Default Listeners not being processed correctly
* [OPENJPA-104] - OpenJPA does not detach instances on rollback()
* [OPENJPA-107] - @SqlResultSetMappings fails in mapping tool with
java.lang.ArrayStoreException
* [OPENJPA-108] - @AttributeOverrides fails in mapping tool with
java.lang.ArrayStoreException
* [OPENJPA-109] - every NativeQuery using SqlResultSetMapping fails at
runtime with There is no query result mapping for "null" with name
"xxx" when the entity is persisted in a different method than the
method doing the query.
* [OPENJPA-110] - Every NamedNativeQuery using ResultSetMapping fails at
runtime with class cast exception when try to iterate over list
* [OPENJPA-111] - native queries fail when use named parameters
* [OPENJPA-115] - Bottleneck(s) with using OpenJPA in a
Container-managed environment
* [OPENJPA-116] - EntityManager.getDelegate should throw an
IllegalStateException
* [OPENJPA-118] - AutoDetach property has no effect
* [OPENJPA-119] - EntityManager.clear() should not implicitly invoke the
flush operation
* [OPENJPA-121] - Table name defaults to the class name instead of the
entity name
* [OPENJPA-122] - EntityManager does not throw exceptions after close()
in required cases
* [OPENJPA-132] - java.lang.NoSuchMethodError for entity with ID of type
java.sql.Date
* [OPENJPA-133] - Can't find non-public callback methods with superclass
or interface parameters
* [OPENJPA-134] - Extra unneeded SQL joins for OneToMany relationship
with fetch type EAGER
* [OPENJPA-139] - PersistenceException merging an entity with a Calendar
field.
* [OPENJPA-140] - Wrong package name in test classes
* [OPENJPA-142] - Entity name is ignored when specified in the orm.xml
file
* [OPENJPA-144] - JDBCConfigurationImpl does not support JNDI lookup for
non-jta-data-source.
* [OPENJPA-146] - Entity enhancement fails while using EmbeddedId on a
MappedSuperclass
* [OPENJPA-150] - @Column in @AttributeOverride not honoring table
attribute that maps to a secondary table in mappedsuperclass entity
* [OPENJPA-154] - OptimisticLockException working with Savepoints
* [OPENJPA-155] - java.lang.ArrayIndexOutOfBoundsException during commit
* [OPENJPA-157] - NullPointerException when running query with null
parameter
* [OPENJPA-162] - @OrderBy on @OneToMany does not allow ordering by @Id
value
* [OPENJPA-174] - error when find()'ing an abstract class
* [OPENJPA-175] - Eager selects by PagingResultObjectProvider may not
use the FetchBatchSize
* [OPENJPA-179] - Schemas defined in orm.xml are only applied when a
name is also specified.
* [OPENJPA-181] - ClassCastException when executing bulk delete on an
entity that owns a OneToOne with a Cascade.DELETE when DataCache is on
* [OPENJPA-185] - optional attribute is not overriden by xml descriptor
* [OPENJPA-186] - Build failure of OpenJPA sources from trunk
* [OPENJPA-202] - after invoking LRS processing in a client by calling an
@LRS annotated relationship, the next em.clear()/em.close() gets
org.apache.openjpa.persistence.InvalidStateException: You cannot
transfer large result set fields from one object or field to another
* [OPENJPA-208] - NoResultException and NonUniqueResultException are not
thrown when expected
* [OPENJPA-214] - Need to support floating point primary keys
Improvements
Improvements made for release 0.9.7
* [OPENJPA-10] - persistence unit name should be default diagnostic
context for standard OpenJPA log impl
* [OPENJPA-37] - Support ant typedefs for OpenJPA tasks
* [OPENJPA-55] - Allow executeUpdate() invocations on native queries
* [OPENJPA-57] - persistence_1_0.xsd is missing
* [OPENJPA-63] - Better pessimistic lock support for DB2 v8.2+
* [OPENJPA-151] - Added field in enhanced vesrion of a class is not
serialized. Hence the change in detached+serialized instances is not
registered under certain conditions.
* [OPENJPA-153] - WebSphere and non-jta-data-source and default
ManagedRuntime
* [OPENJPA-158] - OpenJPA logs overly-verbose at INFO level
* [OPENJPA-161] - Overuse of synchronization in AbstractBrokerFactory
* [OPENJPA-166] - Track the reason why a setRollbackOnly invocation
was made
* [OPENJPA-176] - Exception prefixes should be human-readable
* [OPENJPA-196] - Ease the restrictions on forcing a matche between
the number of declared and assigned positional parameters
New Features
Features added for release 0.9.7
* [OPENJPA-92] - Support for H2 Database Engine
* [OPENJPA-93] - Sequence generation in a JTA environment should not
require non-JTA datasource
* [OPENJPA-94] - Allow MappingTool and persistence.xml to support
drop-create for database schema
* [OPENJPA-182] - db2 update lock syntax WITH USE AND KEEP UPDATE
LOCKS
Task
Tasks done for release 0.9.7
* [OPENJPA-36] - Add cwiki url to incubator status page
Test
Additional testing done for release 0.9.7
* [OPENJPA-40] - Testing OpenJPA and Spring integration fails
OpenJPA 1.0.0 Release Notes
Bugs fixed
* [OPENJPA-61] - Missing usage of TransactionSynchronizationRegistry
* [OPENJPA-86] - "uuid-hex" generator does not make affect in orm.xml
* [OPENJPA-143] - Problems with Single Table Inheritance Strategy (and
Discriminator Type of Integer)
* [OPENJPA-165] - QueryImpl.setFirstResult does not take already set
maxResults into account
* [OPENJPA-177] - When using NOT NULL constraint on foreign key it is
not possible to use CascadeType.ALL and GeneratedId
* [OPENJPA-199] - bulk update gets parsing exception trying to update
an attribute of an embedded class
* [OPENJPA-244] - Java 2 Security enablement
* [OPENJPA-248] - ForeignKey cascade delete action not working
* [OPENJPA-257] - Getter/Setter type inconsistency in Entity IdClass
* [OPENJPA-269] - Informix doesn't support subselects or using table
aliases in a delete statement.
* [OPENJPA-271] - DB2 missing JDBC driver 2 support
* [OPENJPA-272] - @GenerateValue (AUTO) doesn't work with Property
level access
* [OPENJPA-274] - JPQL queries cannot access version fields, including
bulk updates
* [OPENJPA-278] - OpenJPAQuery.getDataStoreActions() returns an empty
String array
* [OPENJPA-280] - Enhancement failure for inherited fields introduced
with change 532137
* [OPENJPA-281] - EAGER not the default fetch type without the @Basic
annotation
* [OPENJPA-284] - TableJDBCSeq for GeneratedValue.TABLE did not handle
initialValue correctly
* [OPENJPA-285] - Multiple deploy/undeploy leaks memory in PCRegistry
* [OPENJPA-287] - Generated methods on superclasses are not visible to
subclasses
* [OPENJPA-294] - Exception while enchnancing the java classes using
OpenJPA PCEnhancerTask with build.xml
* [OPENJPA-296] - UUID algorithm generating non-unique values
sometimes
* [OPENJPA-304] - Problems with DepthFirstAnalysis and the IBM JDK
* [OPENJPA-308] - Postgres: bytea vs. oid handling in
PreparedStatement.setNull() calls
* [OPENJPA-311] - Problem loading classes with OSGi classloaders
* [OPENJPA-312] - derby fails with duplicate primary key(s) in group
by list
* [OPENJPA-313] - list of objects returned by query partially correct
* [OPENJPA-314] - Unenhanced complex id in MappedSuperclass causes NPE
* [OPENJPA-315] - Unenhanced generated id field of a primitive wrapper
type causes NPE
* [OPENJPA-320] - Do not use System Tables (SYS*) with DB2
* [OPENJPA-321] - DB2 ABS Casting problem
* [OPENJPA-322] - Timezone on the Calendar object lost in proxying
* [OPENJPA-323] - Cleanup some message text
* [OPENJPA-256] - java.lang.ClassNotFoundException:
org.apache.openjpa.util.CacheMap in a jetty spring environment
Sub-task
* [OPENJPA-279] - Fixed missing lookup for non-jta-data-source in
JDBCConfigurationImpl.
* [OPENJPA-297] - Lazy loading must be ignored in certain unenhanced
cases
* [OPENJPA-298] - Miscellaneous documentation improvements
* [OPENJPA-299] - Provide a means to enable the old enhancing agent
Improvements
* [OPENJPA-259] - Ability to parse EJB QL multiline queries in orm.xml
* [OPENJPA-266] - Add Extensibility: Change "private" field/method to
"protected" or "public" in OpenJPA classes to be extendable
* [OPENJPA-275] - Bulk updates: version information should be
automatically maintained when the query does not
New Feature
* [OPENJPA-168] - sql optimize n rows query hint
* [OPENJPA-239] - Option for the reverse mapping tool to generate
mapping annotations
* [OPENJPA-262] - Event notification of BrokerFactory creation
* [OPENJPA-263] - Introducing getAll(List) method for data cache to be
called by loadAll() will allow data cache plug-ins to leverage the
advantage of any third-party cache that provides a way to get
multiple object in one call by providing a list of keys (oids).
* [OPENJPA-317] - API formalization pre-1.0