| 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 |