EclipseLink/Release/2.2.0

EclipseLink 2.2.0 Release Notes

The EclipseLink 2.2 release focuses on providing advanced persistence features for user of relational, XML and Web Services to expose extended persistence features that naturally extend the industry standards in these spaces. As well as these new features, a great emphasis was placed on bug fixing in this release.

New and Noteworthy

JPA

The following bugs should be noted:

263944 - Removed an unmapped access element from the transformation element of the eclipselink orm schema. The correct access attribute metadata remains and should be the one that is used. See the bug for more details.

331234 - Corrected a JPA specification violation surrounding the xml-mapping-metadata-complete flag. The incorrect behavior however may have been employed by some users meaning they could encounter some issues and need to re-configure their xml metadata. See the bug for more details.

MOXy

SDO

DBWS

Standards Based

JPA 2.0

JAXB 2.2

SDO 2.1.1

Known Issues

The following are known issues that have been identified as potentially effecting users of EclipseLink 2.2. For a list of all open bugs and enhancement requests please see the queries at EclipseLink/Bugs

Summary

Details

The following bug queries can be used by find known issues with specific feature areas. They return bugs reported against 2.2.

Property Name Generation from Introspector.decapitalize

The decapitalize method will now leave the property name in uppercase if the first and second characters are uppercase. EclipseLink will use the property name as ID, as detailed in the specification.

Note that this may require a change in some JPQL. For example, if previously you had a method with an annotation such as getcCustomers that would have properties named cCustomers, you will now have Customers.

Deprecated Functionality

In EclipseLink 2.2 the following features/API have been deprecated. Please upgrade to the suggested alternatives to avoid issues in the future when these deprecated features/AIP might be removed.

Summary

Details

ObjectCopyPolicy

The ObjectCopyPolicy has been replaced with the CopyGroup. The full API from ObjectCopyPolicy is supported by CopyGroup requiring only a minor class name change in user code.

ObjectLevelReadQuery.addPartialAttribute

Partial attribute queries have been deprecated and replaced with the use of FetchGroup

ReadObjectQuery.selectionKey (Vector)

Replaced with the use of an object for single part keys and a CacheId for composite keys. The replacement API is: ReadObjectQuery#selectionId.

BasicMap, BasicCollection, CollectionTable

Deprecated in 2.0, these native mappings and supported configuration annotations are now supported by JPA 2.0's ElementCollection mapping and supported configuration annotations and orm.xml.

Removed Functionality

TODO: Was any previously deprecated functionality removed or any functionality that could not be deprecated first removed?

Retention Policy

The EclipseLink 2.2 (Helios) release will remain available for download from the primary download page until the next release is shipped. At that point it will be moved to the previous releases where it remain for a minimum period of 2 years before becoming available for archival.

Future Releases

For more information about future planned EclipseLink releases and patch sets please refer to the releases section of the project summary.