blob: 123f64d2d85b2354729b4a297652d3947cee88a6 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<sections title="EclipseLink 2.5.2 Release">
<section class="title">
<description>
<h1>EclipseLink 2.5.2</h1>
<p> The primary focus of the EclipseLink 2.5 release is the delivery
of the JPA 2.1 (JSR 338) Reference Implementation.
</p>
<p>
New features include:
<ul>
<li>Full JPA 2.1 support</li>
<li>Maven Central support</li>
<li>New DB platforms: HANA and Pervasive</li>
<li>JPA-RS Enhancements</li>
<li>MOXy - NamedObjectGraphs</li>
</ul>
</p>
</description>
</section>
<section class="main" name="New and Noteworthy">
<description>
<table>
<tr>
<td colspan="2">
<h4>JPA 2.1</h4>
</td>
</tr>
<tr
style="padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<td valign="top">
The features in this section are some of the new features added in JPA 2.1.
<ul>
<li>Criteria Bulk Update/Delete</li>
<li>Stored Procedures</li>
<li>JPQL Generic function support</li>
<li>Injectable Entity Listeners</li>
<li>Treat</li>
<li>Converters</li>
<li>DDL Gen</li>
<li>JPA 2.1 - Entity Graphs</li>
</ul>
</td>
<td width="150">
<div>
<img src="/eclipselink/images/doc_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Release/2.5/JPA21">Documentation</a>
</div>
</td>
</tr>
<tr>
<td colspan="2">
<h4>Maven Central</h4>
</td>
</tr>
<tr
style="padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<td valign="top">
EclipseLink has established Maven publication through the Sonatype OSS Nexus instance to Maven Central
</td>
<td width="150">
<div>
<img src="/eclipselink/images/doc_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Build/Infrastructure#Maven_Repository">Documentation</a>
</div>
</td>
</tr>
<tr>
<td colspan="2">
<h4>MOXy Named Object Graphs</h4>
</td>
</tr>
<tr
style="padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<td valign="top">
Allow a subset of attributes to be marshaled and
unmarshaled
</td>
<td width="150">
<div>
<img src="/eclipselink/images/doc_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/MOXy/MOXy_JSON_Provider/JSONwithPadding">JSON with Padding</a>
</div>
</td>
</tr>
<tr>
<td colspan="2">
<h4>JSON and XML Mappings with JAX-RS</h4>
</td>
</tr>
<tr
style="padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<td valign="top">
</td>
<td width="150">
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/MOXy/MOXy_JSON_Provider/JSONwithPadding">JSON with Padding</a>
</div>
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a href="http://bugs.eclipse.org/401442">MOXyJsonProvider</a>
</div>
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/MOXy/Mappings/Bidirectional">@XmlInverseReference</a>
</div>
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/MOXy/JSON_CollectionProperties">@XmlElementWrapper</a>
</div>
</td>
</tr>
</table>
</description>
</section>
<section class="main" name=" Enhancements and 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 enhancements.
</p>
<ul>
<li>
<a
href="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;target_milestone=2.5.2;product=EclipseLink;known_name=2.5%20Fixed"
class="external text"
title="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;target_milestone=2.5.2;product=EclipseLink;known_name=2.5%20Fixed"
rel="nofollow">2.5.2: All Fixed Bugs and enhancement requests</a>
<dl>
<dd>
<img src="2.5.0_bugs.png" />
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.5.2;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.5.2;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.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=JPA;target_milestone=2.5.2;product=EclipseLink;known_name=2.5%20Fixed"
class="external text"
title="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.4%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=JPA;target_milestone=2.5.2;product=EclipseLink;known_name=2.5%20Fixed"
rel="nofollow">JPA</a>
,
<a
href="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=MOXy;product=EclipseLink;target_milestone=2.5.2;known_name=2.5%20Fixed"
class="external text"
title="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=MOXy;product=EclipseLink;target_milestone=2.5.2;known_name=2.5%20Fixed"
rel="nofollow">MOXy</a>
,
<a
href="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=SDO;target_milestone=2.5.2;product=EclipseLink;known_name=2.5%20Fixed"
class="external text"
title="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=SDO;target_milestone=2.5.2;product=EclipseLink;known_name=2.5%20Fixed"
rel="nofollow">SDO</a>
,
<a
href="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=DBWS;product=EclipseLink;target_milestone=2.5.2;known_name=2.5%20Fixed"
class="external text"
title="https://bugs.eclipse.org/bugs/buglist.cgi?resolution=FIXED;classification=RT;query_based_on=2.5%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=DBWS;product=EclipseLink;target_milestone=2.5.2;known_name=2.5%20Fixed"
rel="nofollow">DBWS</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.5.
</p>
<ul>
<li> As of the 2.5.2 patch set, builds will no longer be published to the download.eclipse.org Maven repository. Builds will continue to be published oss.sonatype.com</li>
<li>
<a href="https://bugs.eclipse.org/374771">Bug 374771</a>
<p>
Some TREAT expressions in the where clause will not work properly.
</p>
</li>
<li>
<a href="http://bugs.eclipse.org/404294">Bug 404294</a>
<p>
Application managed persistence contexts (EntityManager)
using JTA transactions must join the active transaction where as
previously it automatically joined.
Without the joinTransaction
call, the changes made in the Entitymanager will not be commited
when the JTA transaction compltes.
</p>
</li>
<li>
<a href="http://bugs.eclipse.org/407570">Bug 407570</a>
<p>
Attribute defined in an unmapped POJO and inhertited by an Entity, may not be be persisted. Simplest solution is to ensure that all the persisted attributes are mapped (ie. @MappedSuperclass). See the bug for futher details.
</p>
</li>
<li>
<a href="http://bugs.eclipse.org/408015">Bug 408015</a>
<p>
Redploying a JPA-RS persistence unit will not always update the persistence unit with new mappings. Two workarounds are described in the bug.
</p>
</li>
<li>
<p>
When running EclipseLink 2.5 in Glassfish 4.0, you must specify a valid datasource in the persistence.xml through either the jta-data-source or non-jta-data-source tags.
</p>
</li>
</ul>
</description>
</section>
<section class="main" name=" Standards">
<description>
<p>EclipseLink remains focused on the delivering support for the
latest standards. EclipseLink 2.5 offers certified support for:
</p>
<ul>
<li>
Java Persistence (JPA) 2.1 -
<a href="http://www.jcp.org/en/jsr/detail?id=338">JSR 338</a>
</li>
<li>
Java Architecture for XML Binding (JAXB) 2.2 -
<a href="http://jcp.org/en/jsr/detail?id=222">JSR 222</a>
</li>
<li>
Service Data Objects (SDO) 2.1.1 -
<a href="http://jcp.org/en/jsr/detail?id=235">JSR 235</a>
</li>
</ul>
</description>
</section>
<section class="main" name=" Deprecated Functionality">
<description>
<p>
In EclipseLink 2.5 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.
<a href="index.php">release pages</a>
<ul>
<li>
<a href="http://bugs.eclipse.org/399676">Bug 399676: Deprecation of non-versions REST URIs</a>
<p>
JPA-RS accepts request urls with and without version. The URIs without
version are deprecated and clients
are encourage use versioned ones.
</p>
</li>
</ul>
</p>
</description>
</section>
<section class="main" name="Retention Policy">
<description>
<p>
The previous EclipseLink 2.5 releases will remain available for download
from 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" name="Getting Started">
<description>
<div style="text-align:center;padding:0.5em;margin:0.5em 0.5em 1em 1em;">
<a href="/juno">
<img src="/juno/images/eclipse_juno242x132.jpg" width="200" />
</a>
</div>
<div
style="padding:0.5em;margin:0.5em 0.5em 1em 1em;background:#FDD017;-moz-border-radius:4px;"
valign="middle">
<a href="http://www.eclipse.org/eclipselink/downloads/index.php#2.5">
<table>
<tr>
<td>
<img src="http://dev.eclipse.org/huge_icons/actions/go-down.png"
border="0" />
</td>
<td width="100%" valign="middle">
<div style="text-align:center">
<font size="+1">
Download 2.5.2
</font>
</div>
</td>
<td>
<img src="http://dev.eclipse.org/huge_icons/actions/go-down.png"
border="0" />
</td>
</tr>
</table>
</a>
</div>
<div
style="text-align:center;padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<img src="/eclipselink/images/doc_small.png" />
<a href="/eclipselink/documentation/2.5/">Documentation Center</a>
</div>
<div
style="text-align:center;padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<img src="/eclipselink/images/wiki_small.png" />
<a href="http://wiki.eclipse.org/EclipseLink/Examples">Examples and Tutorials</a>
</div>
<div
style="text-align:center;padding:0.5em;margin:0.5em 0.5em 1em 1em;border:1px solid #D9D9D9;background:#EFEFEF;-moz-border-radius:4px;">
<img src="/eclipselink/images/doc_small.png" />
<a href="/eclipselink/api/2.5/index.html">2.5.2 JavaDocs</a>
</div>
</description>
</section>
</sections>