Difference between revisions of "EclipseLink/Release/2.2.0"

From Eclipsepedia

Jump to: navigation, search
(Resolved Issues)
(Future Releases)
(39 intermediate revisions by 7 users not shown)
Line 15: Line 15:
  
 
=== JPA ===
 
=== JPA ===
The following bugs should be noted:
+
* Monitor persistence performance with the new '''Performance Monitor'''. ...''[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Performance_Monitoring_and_Profiling/Performance_Monitoring|learn more]]''
* [https://bugs.eclipse.org/bugs/show_bug.cgi?id=263944 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.
+
* Indexes can now be generated on the Database using our '''Index generation feature'''. ...''[[EclipseLink/Examples/JPA/Indexes|learn more]]''
* [https://bugs.eclipse.org/bugs/show_bug.cgi?id=331234 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.
+
* Allow for auto appending of strings to '''CREATE TABLE statements'''. ...''[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation/Appending_strings_to_CREATE_TABLE_statements|learn more]]''
 +
* Allow Delete Cascading to be handled by the database, using '''CascadeOnDelete'''. ...''[[EclipseLink/DesignDocs/324341|learn more]]''
 +
* Filter data using our new '''AdditionalCriteria'''. ...''[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Querying/Additional_Criteria|learn more]]
 +
* Enabling EclipseLink as the JPA 2.0 provider for JTA EE applications on '''WebLogic'''...''[[EclipseLink/Development/JPA_2.0/weblogic#Enabling_JPA2_support|learn more]]''
 +
* Partition row data across tables using our new '''PartitioningPolicy'''. ...''[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Data_Partitioning|learn more]]
 +
 
 +
==== JPA OSGi ====
 +
 
 +
* EclipseLink support for JPA in OSGi is deprecated in this release and will be replaced by the OSGi Enterprise Spec compliant Gemini JPA project in a future release. OSGi developers are encouraged to migrate to Gemini JPA with EclipseLink 2.2.
  
 
=== MOXy ===
 
=== MOXy ===
 
+
* MOXy '''XML metadata''' and '''annotation support'''
=== SDO ===
+
** Standard JAXB and advanced MOXy mappings configurable with MOXy annotations or XML metadata....''[[EclipseLink/Examples/MOXy/GettingStarted|learn more]]''
 +
** MOXy equivalent support provided for corresponding JPA Annotations....''[[EclipseLink/DesignDocs/317962/Phase3|learn more]]''
 +
* Full '''Dynamic MOXy''' support....''[[EclipseLink/UserGuide/MOXy/Runtime/Bootstrapping_Dynamic|learn more]]''
 +
* Using EclipseLink JAXB with the '''Spring Framework'''....''[[EclipseLink/Examples/MOXy/Spring/JAXBAnnotations|learn more]]''
 +
* Use EclipseLink JPA & JAXB to create a '''RESTful web service'''....''[[EclipseLink/Examples/REST/GettingStarted|learn more]]''
  
 
=== DBWS ===
 
=== DBWS ===
 +
* Build a DBWS service by retrieving Custom SQL result-set metadata at design time....''[[EclipseLink/Examples/DBWS/DBWSBasicSQL|learn more]]''
 +
* DBWS Update operation now supporting '''Sparse Merges'''
 +
* Run a DBWS service in an OSGi environment....''[[EclipseLink/Development/DBWS/OSGi|learn more]]''
 +
* Run an EclipseLink D/B web service using Java SE 6's container-less Endpoint API....''[[EclipseLink/Examples/DBWS/AdvancedJavase6Containerless|learn more]]''
  
 
=== Standards Based ===
 
=== Standards Based ===
  
* JPA 2.0
+
* JPA 2.0 ([http://www.jcp.org/en/jsr/detail?id=317 JSR-317])
* JAXB 2.2
+
* JAXB 2.2 ([http://jcp.org/en/jsr/detail?id=222 JSR-222])
 
* SDO 2.1.1
 
* SDO 2.1.1
  
Line 34: Line 50:
  
 
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]]  
 
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]]  
 +
 +
===JPA ===
 +
* [https://bugs.eclipse.org/bugs/show_bug.cgi?id=263944 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.
 +
* [https://bugs.eclipse.org/bugs/show_bug.cgi?id=331234 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.
  
  
{|{{BMTableStyle}}
 
|-{{BMTHStyle}}
 
! Summary
 
! Details
 
|-
 
|}
 
  
 
The following bug queries can be used by find known issues with specific feature areas. They return bugs reported against 2.2.
 
The following bug queries can be used by find known issues with specific feature areas. They return bugs reported against 2.2.
  
* [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;product=EclipseLink;classification=RT All bugs reported against 2.2]
+
* [https://bugs.eclipse.org/bugs/buglist.cgi?columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;classification=RT;query_format=advanced;version=2.2.0;product=EclipseLink All bugs reported against 2.2]
** By Component: [https://bugs.eclipse.org/bugs/buglist.cgi?classification=RT;component=JPA;product=EclipseLink;query_format=advanced;version=2.2;query_based_on=;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc JPA] [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=MOXy;classification=RT;product=EclipseLink MOXy] [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=SDO;classification=RT;product=EclipseLink SDO] [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=DBWS;classification=RT;product=EclipseLink DBWS] [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=Foundation;classification=RT;product=EclipseLink Foundation]
+
** By Component: [https://bugs.eclipse.org/bugs/buglist.cgi?columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;classification=RT;query_format=advanced;version=2.2.0;component=JPA;product=EclipseLink JPA] [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2.0;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=MOXy;product=EclipseLink;classification=RT MOXy] [https://bugs.eclipse.org/bugs/buglist.cgi?columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;classification=RT;query_format=advanced;version=2.2.0;component=SDO;product=EclipseLink SDO] [https://bugs.eclipse.org/bugs/buglist.cgi?columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;classification=RT;query_format=advanced;version=2.2.0;component=DBWS;product=EclipseLink DBWS] [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;version=2.2.0;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=Foundation;product=EclipseLink;classification=RT Foundation]
  
 
== Resolved Issues ==
 
== Resolved Issues ==
Line 52: Line 66:
 
In addition to the features highlighted in the New and Noteworthy section this release also includes a substantial number of bug fixes and enhancement requests.  
 
In addition to the features highlighted in the New and Noteworthy section this release also includes a substantial number of bug fixes and enhancement requests.  
 
* [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed All Fixed Bugs and enhancement requests]
 
* [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed All Fixed Bugs and enhancement requests]
*: Component: [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=JPA;target_milestone=2.2.0;product=EclipseLink;classification=RT Foundation], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=JPA;product=EclipseLink;target_milestone=2.2;known_name=2.2%20Fixed JPA], [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=MOXy;target_milestone=2.2.0;product=EclipseLink;classification=RT MOXy], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=SDO;product=EclipseLink;target_milestone=2.2;known_name=2.2%20Fixed SDO], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=DBWS;product=EclipseLink;target_milestone=2.2;known_name=2.2%20Fixed DBWS], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=Utils;product=EclipseLink;target_milestone=2.2;known_name=2.2%20Fixed Utils], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=Examples;product=EclipseLink;target_milestone=2.2;known_name=2.2%20Fixed Examples], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=Documentation;product=EclipseLink;target_milestone=2.2;known_name=2.2%20Fixed Documentation]  
+
*: Component: [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;columnlist=bug_severity%2Cpriority%2Cversion%2Ctarget_milestone%2Cbug_status%2Creporter%2Cshort_desc;component=Foundation;target_milestone=2.2.0;product=EclipseLink;classification=RT Foundation], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=JPA;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed JPA], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=MOXy;product=EclipseLink;target_milestone=2.2.0;known_name=2.2%20Fixed MOXy], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=SDO;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed SDO], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=DBWS;product=EclipseLink;target_milestone=2.2.0;known_name=2.2%20Fixed DBWS], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=Utils;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed Utils], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=Examples;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed Examples], [https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.2%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=Documentation;target_milestone=2.2.0;product=EclipseLink;known_name=2.2%20Fixed Documentation]  
 
+
===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 ==
 
== Deprecated Functionality ==
Line 82: Line 90:
 
|}
 
|}
  
== Removed Functionality==
 
  
TODO: Was any previously deprecated functionality removed or any functionality that could not be deprecated first removed?
 
  
 
== Retention Policy ==
 
== Retention Policy ==
  
The EclipseLink 2.2 (Helios) release will remain available for download from the [http://www.eclipse.org/eclipselink/downloads/index.php primary download page] until the next release is shipped. At that point it will be moved to the [http://www.eclipse.org/eclipselink/downloads/previous_releases.php previous releases] where it remain for a minimum period of 2 years before becoming available for archival.
+
The EclipseLink 2.2 release will remain available for download from the [http://www.eclipse.org/eclipselink/downloads/index.php primary download page] until the next release is shipped. At that point it will be moved to the [http://www.eclipse.org/eclipselink/downloads/previous_releases.php previous releases] where it remain for a minimum period of 2 years before becoming available for archival.
  
 
== Future Releases ==
 
== Future Releases ==
  
 
For more information about future planned EclipseLink releases and patch sets please refer to the releases section of the [http://www.eclipse.org/projects/project_summary.php?projectid=rt.eclipselink project summary].
 
For more information about future planned EclipseLink releases and patch sets please refer to the releases section of the [http://www.eclipse.org/projects/project_summary.php?projectid=rt.eclipselink project summary].
 +
 +
[[Category:EclipseLink|Release/2.2.0]]

Revision as of 14:57, 24 October 2011

HeliosEclipseLink

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

  • Monitor persistence performance with the new Performance Monitor. ...learn more
  • Indexes can now be generated on the Database using our Index generation feature. ...learn more
  • Allow for auto appending of strings to CREATE TABLE statements. ...learn more
  • Allow Delete Cascading to be handled by the database, using CascadeOnDelete. ...learn more
  • Filter data using our new AdditionalCriteria. ...learn more
  • Enabling EclipseLink as the JPA 2.0 provider for JTA EE applications on WebLogic...learn more
  • Partition row data across tables using our new PartitioningPolicy. ...learn more

JPA OSGi

  • EclipseLink support for JPA in OSGi is deprecated in this release and will be replaced by the OSGi Enterprise Spec compliant Gemini JPA project in a future release. OSGi developers are encouraged to migrate to Gemini JPA with EclipseLink 2.2.

MOXy

  • MOXy XML metadata and annotation support
    • Standard JAXB and advanced MOXy mappings configurable with MOXy annotations or XML metadata....learn more
    • MOXy equivalent support provided for corresponding JPA Annotations....learn more
  • Full Dynamic MOXy support....learn more
  • Using EclipseLink JAXB with the Spring Framework....learn more
  • Use EclipseLink JPA & JAXB to create a RESTful web service....learn more

DBWS

  • Build a DBWS service by retrieving Custom SQL result-set metadata at design time....learn more
  • DBWS Update operation now supporting Sparse Merges
  • Run a DBWS service in an OSGi environment....learn more
  • Run an EclipseLink D/B web service using Java SE 6's container-less Endpoint API....learn more

Standards Based

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

JPA

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


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

Resolved Issues

In addition to the features highlighted in the New and Noteworthy section this release also includes a substantial number of bug fixes and enhancement requests.

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.


Retention Policy

The EclipseLink 2.2 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.