blob: 61a99a2aada47dc6cbb52581706e7085e4e1c7e9 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<sections title="EclipseLink 2.2.0">
<section class="title">
<description>
<h1>EclipseLink 2.2.0 release</h1>
<p>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. </p>
</description>
</section>
<section class="main" name="New and Noteworthy">
<section>
<description>
<h4>JPA: Object-Relational</h4>
<ul>
<li>
<a
href="http://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Basic_JPA_Development/Querying/Additional_Criteria">AdditionalCriteria: Limit/Filter all query results</a>
</li>
<li>
<a
href="http://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Data_Partitioning">PartitioningPolicy: Partition row data across tables</a>
</li>
<li>
Schema Generation Enhancements:
<ul>
<li>
<a href="http://wiki.eclipse.org/EclipseLink/Examples/JPA/Indexes">@Index Generation</a>
</li>
<li>
<a
href="http://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Schema_Generation/Appending_strings_to_CREATE_TABLE_statements">CREATE TABLE customization</a>
</li>
</ul>
</li>
<li>
<a href="http://wiki.eclipse.org/EclipseLink/DesignDocs/324341">Database Cascade Delete</a>
</li>
<li>
<a
href="http://wiki.eclipse.org/EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Performance_Monitoring_and_Profiling/Performance_Monitoring">New Performance Monitor</a>
</li>
</ul>
</description>
</section>
<section>
<description>
<h4>MOXy: XML Binding</h4>
<ul>
<li>
<b>MOXy metadata enhancements:</b>
<ul>
<li>
<a
href="http://wiki.eclipse.org//EclipseLink/Examples/MOXy/GettingStarted">
Standard or extended JAXB mappings configurable with
annotations or XML
</a>
</li>
<li>
<a
href="http://wiki.eclipse.org//EclipseLink/DesignDocs/317962/Phase3"
title="EclipseLink/DesignDocs/317962/Phase3">MOXy equivalent support provided for corresponding JPA
Annotations</a>
</li>
</ul>
</li>
<li>
<a
href="http://wiki.eclipse.org//EclipseLink/UserGuide/MOXy/Runtime/Bootstrapping_Dynamic">
<b>Dynamic MOXy</b>
: JAXB without classes
</a>
</li>
<li>
<a
href="http://wiki.eclipse.org//EclipseLink/Examples/MOXy/Spring/JAXBAnnotations">
MOXy JAXB in the
<b>Spring Framework</b>
Example
</a>
</li>
<li>
<a
href="http://wiki.eclipse.org//EclipseLink/Examples/REST/GettingStarted">
<b>RESTful web service</b>
JPA &amp; JAXB Example
</a>
</li>
</ul>
</description>
</section>
<section>
<description>
<h4>DBWS: Database Web Services</h4>
<ul>
<li>
Build a DBWS service by retrieving Custom SQL result-set metadata
at design time....
<i>
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/DBWS/DBWSBasicSQL">learn
more</a>
</i>
</li>
<li>
DBWS Update operation now supporting
<b>Sparse Merges</b>
</li>
<li>
Run a DBWS service in an OSGi environment....
<i>
<a href="http://wiki.eclipse.org/EclipseLink/Development/DBWS/OSGi">
learn more</a>
</i>
</li>
<li>
Run an EclipseLink D/B web service using Java SE 6's
container-less Endpoint API....
<i>
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/DBWS/AdvancedJavase6Containerless">
learn more</a>
</i>
</li>
</ul>
</description>
</section>
<section >
<description>
<h4>Implement Standards</h4>
<ul>
<li>
JPA 2.0 (
<a href="http://www.jcp.org/en/jsr/detail?id=317">JSR 317</a>
)
</li>
<li>
JAXB 2.2 (
<a href="http://jcp.org/en/jsr/detail?id=222">JSR 222</a>
)
</li>
<li>SDO 2.1.1 (
<a href="http://jcp.org/en/jsr/detail?id=235">JSR 235</a>
)</li>
</ul>
</description>
</section>
</section>
<section class="main" name="Resolved Issues">
<description>
<p>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. </p>
<ul>
<li>
<a
href="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"
class="external text"
title="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"
rel="nofollow">All Fixed Bugs and enhancement requests</a>
<dl>
<dd>
Component:
<a
href="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"
class="external text"
title="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"
rel="nofollow">Foundation</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">JPA</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">MOXy</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">SDO</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">DBWS</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">Utils</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">Examples</a>
,
<a
href="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"
class="external text"
title="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"
rel="nofollow">Documentation</a>
</dd>
</dl>
</li>
</ul>
</description>
</section>
<section class="main" name="Known Issues">
<description>
<p>
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
<a href="http:/wiki.eclipse.org/EclipseLink/Bugs">EclipseLink/Bugs</a>
</p>
<a name="JPA_2"></a>
<h3>
<span class="mw-headline">JPA </span>
</h3>
<ul>
<li>
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=263944"
class="external text" title="https://bugs.eclipse.org/bugs/show_bug.cgi?id=263944"
rel="nofollow">263944</a>
- 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.
</li>
<li>
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=331234"
class="external text" title="https://bugs.eclipse.org/bugs/show_bug.cgi?id=331234"
rel="nofollow">331234</a>
- 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.
</li>
</ul>
<p>
<br />
</p>
<p>The following bug queries can be used by find known issues with
specific feature areas. They return bugs reported against 2.2.
</p>
<ul>
<li>
<a
href="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"
class="external text"
title="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"
rel="nofollow">All bugs reported against 2.2</a>
<ul>
<li>
By Component:
<a
href="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"
class="external text"
title="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"
rel="nofollow">JPA</a>
<a
href="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"
class="external text"
title="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"
rel="nofollow">MOXy</a>
<a
href="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"
class="external text"
title="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"
rel="nofollow">SDO</a>
<a
href="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"
class="external text"
title="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"
rel="nofollow">DBWS</a>
<a
href="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"
class="external text"
title="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"
rel="nofollow">Foundation</a>
</li>
</ul>
</li>
</ul>
</description>
</section>
<section class="main" name="Deprecated Functionality">
<description>
<p>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. </p>
<table
style="font-family: Tahoma,Verdana,Helvetica,sans-serif; font-size: 100%; border-color: rgb(204, 204, 204); border-collapse: collapse; padding: 5px 10px; color: black;"
border="1" cellpadding="5" cellspacing="0">
<tbody>
<tr
style="background: none repeat scroll 0% 0% rgb(238, 238, 238); color: rgb(102, 102, 102);">
<th> Summary</th>
<th> Details</th>
</tr>
<tr>
<td> ObjectCopyPolicy</td>
<td>
The
<a href="http://javadoc" class="external text" title="http://javadoc"
rel="nofollow">ObjectCopyPolicy</a>
has been replaced with the
<a href="http://javadoc" class="external text" title="http://javadoc"
rel="nofollow">CopyGroup</a>
. The full API from ObjectCopyPolicy is supported by CopyGroup
requiring only a minor class name change in user code.
</td>
</tr>
<tr>
<td> ObjectLevelReadQuery.addPartialAttribute</td>
<td> Partial attribute queries have been deprecated and replaced
with the use of FetchGroup</td>
</tr>
<tr>
<td> ReadObjectQuery.selectionKey (Vector)</td>
<td>
Replaced with the use of an object for single part keys and a
CacheId for composite keys. The replacement API is:
<a href="http://javadoc" class="external text" title="http://javadoc"
rel="nofollow">ReadObjectQuery#selectionId</a>
</td>
</tr>
<tr>
<td> BasicMap, BasicCollection, CollectionTable</td>
<td> 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.</td>
</tr>
</tbody>
</table>
</description>
</section>
<section class="main" name="Retention Policy">
<description>
<p>
The EclipseLink 2.2 release will remain available for download
from
the
<a href="/eclipselink/downloads/index.php">primary download page</a>
until the next release is shipped. At
that point it will be moved to
the
<a href="/eclipselink/downloads/previous_releases.php">previous releases</a>
page where it remain
for a minimum period of 2 years before becoming
available for archival.
</p>
</description>
</section>
<section class="main" name="Future Releases">
<description>
<p>
For more information about future planned EclipseLink releases and
patch sets please refer to the releases section of the
<a href="/projects/project_summary.php?projectid=rt.eclipselink">project summary. </a>
</p>
</description>
</section>
<section class="sideitem">
<description>
<h6 style="text-align:center">Getting Started</h6>
<ul>
<li>
<a href="/eclipselink/downloads/2.2.0">
Download 2.2.0
<img src="http://dev.eclipse.org/large_icons/actions/go-bottom.png"
border="0" />
</a>
</li>
<ul>
<li>
<a
href="http://wiki.eclipse.org/EclipseLink/Installing_and_Configuring_EclipseLink">Install Instructions</a>
</li>
</ul>
<li>
<a href="/eclipselink/documentation/">Documentation</a>
</li>
<li>
<a href="http://wiki.eclipse.org/EclipseLink/Examples">Examples/Tutorials</a>
</li>
</ul>
</description>
</section>
</sections>