blob: f300e3aeadd6241e609e7894c3481e7b942f3044 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<sections title="EclipseLink 2.4.2 (Juno) Release">
<section class="title">
<description>
<h1>EclipseLink 2.4.2</h1>
<p> The EclipseLink 2.4 release builds on the
increased developer
flexibility and multitenant features.
EclipseLink now offers support
for NoSQL, REST, JSON as well as
additional tenant isolation modes
for PaaS and SaaS cloud enabled
application development.
</p>
</description>
</section>
<section class="main" name=" New and Noteworthy" image="/sequoyah/images/CC_news.png">
<description>
<table>
<tr>
<td colspan="2">
<h4>RESTFul Persistence</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">
Java Persistence units can now be exposed over REST
using either JSON or XML media. This allows applications to more
easily expose their persistence features for direct usage within
Thin Server Architecture solutions including HTML5 and mobile
clients.
</td>
<td width="150">
<div>
<img src="/eclipselink/images/doc_small.png" />
<a href="http://www.eclipse.org/eclipselink/documentation/2.4/solutions/restful_jpa.htm#CHDGHJID">Documentation</a>
</div>
</td>
</tr>
<tr>
<td colspan="2">
<h4>Tenant Isolation</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">
Developers can design and deploy applications where
their persistent entities
manage entities for multiple tenants in
the same application with
storage in tables per tenant uniquely
identified by name or
schema. Developers can now alternatively have
their applications customize the data source used for different
tenant's application instances.
</td>
<td>
<div>
<img src="/eclipselink/images/doc_small.png" />
<a
href="../documentation/2.4/jpa/extensions/a_multitenant.htm">Documentation</a>
</div>
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a href="http://wiki.eclipse.org/EclipseLink/Examples/JPA/Multitenant">Examples</a>
</div>
</td>
</tr>
<tr>
<td colspan="2">
<h4>NoSQL</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">
Integration NoSQL data stores into an application is
becoming a common requirement. Doing this with a common
persistence solution is a goal of the EclipseLink project. This
release introduces EclipseLink's NoSQL support for MongoDB and
Oracle NoSQL.
</td>
<td>
<div>
<img src="/eclipselink/images/doc_small.png" />
<a
href="../documentation/2.4/jpa/extensions/a_nosql.htm">Documentation</a>
</div>
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a href="http://wiki.eclipse.org/EclipseLink/Examples/JPA/NoSQL">Example</a>
</div>
</td>
</tr>
<tr>
<td colspan="2">
<h4>JSON</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 MOXy can now be used for the marshaling
and unmarshaling of JSON object. Leveraging the same context and
mappings used within
the JAXB developers can easily integrate JSON
usage to their
applications. This is core infrastructure to the
JPA-RS feature.
</td>
<td>
<div>
<img src="/eclipselink/images/doc_small.png" />
<a
href="../documentation/2.4/moxy/json.htm">JSON Binding</a>
</div>
<div>
<img src="/eclipselink/images/wiki_small.png" />
<a
href="http://wiki.eclipse.org/EclipseLink/Examples/MOXy#Working_with_JSON_.28NEW_in_2.4.29">Examples</a>
</div>
</td>
</tr>
</table>
</description>
</section>
<section class="main" name=" Enhancements and Resolved Issues"
image="/sequoyah/images/CC_bugs.png">
<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="http://wiki.eclipse.org/EclipseLink/Release/2.4.0/JAXB_RI_Extensions">Support for JAXB RI Extensions</a>
</li>
<li>
<a href="http://wiki.eclipse.org/EclipseLink/Examples/JPA/DCN">Cache invalidation using Oracle QCN/DCN</a>
</li>
<li>
<a href="http://wiki.eclipse.org/EclipseLink/Examples/MySports">MySports Example</a>
: Example updated to include @Multitenant(TABLE_PER_TENANT) and the
REST interfaces have been replaced with the usage of JPA-RS.
</li>
<li>
<a
href="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;target_milestone=2.4.0;product=EclipseLink;known_name=2.4%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;target_milestone=2.4.0;product=EclipseLink;known_name=2.4%20Fixed"
rel="nofollow">2.4.0: All Fixed Bugs and enhancement requests</a>
<dl>
<dd>
<img src="2.4.X_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.4.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.4.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.4%20Fixed;query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;component=JPA;target_milestone=2.4.0;product=EclipseLink;known_name=2.4%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.4.0;product=EclipseLink;known_name=2.4%20Fixed"
rel="nofollow">JPA</a>
,
<a
href="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=MOXy;product=EclipseLink;target_milestone=2.4.0;known_name=2.4%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=MOXy;product=EclipseLink;target_milestone=2.4.0;known_name=2.4%20Fixed"
rel="nofollow">MOXy</a>
,
<a
href="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=SDO;target_milestone=2.4.0;product=EclipseLink;known_name=2.4%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=SDO;target_milestone=2.4.0;product=EclipseLink;known_name=2.4%20Fixed"
rel="nofollow">SDO</a>
,
<a
href="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=DBWS;product=EclipseLink;target_milestone=2.4.0;known_name=2.4%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=DBWS;product=EclipseLink;target_milestone=2.4.0;known_name=2.4%20Fixed"
rel="nofollow">DBWS</a>
</dd>
</dl>
</li>
</ul>
</description>
</section>
<section class="main" name=" Known Issues"
image="http://dev.eclipse.org/huge_icons/apps/help-browser.png">
<description>
<p>
The following are known issues that have been identified as
potentially effecting users of EclipseLink 2.4.
</p>
<ul>
<li>
<a href="http://bugs.eclipse.org/370429">Bug 370429</a>
<p>
Some methods incorrectly throw a proprietary EclipseLink Exception instead of the equivalent JPA standard exception. Applications will need to catch the proprietary exceptions instead of standard ones. See the bug for more details.
</p>
</li>
<li>
<a href="http://bugs.eclipse.org/408015">Bug 408015</a>
<p>
Redeploying a JPA-RS persistence unit will not always update the persistence unit with new mappings. Workarounds are described in the bug.
</p>
</li>
</ul>
</description>
</section>
<section class="main" name=" Standards" image="/sequoyah/images/CC_code.png">
<description>
<p>EclipseLink remains focused on the delivering support for the
latest standards. EclipseLink 2.4 offers certified support for:
</p>
<ul>
<li>
Java Persistence (JPA) 2.0 -
<a href="http://www.jcp.org/en/jsr/detail?id=317">JSR 317</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"
image="http://dev.eclipse.org/huge_icons/actions/edit-clear.png">
<description>
<p>
In EclipseLink 2.4 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>
.
</p>
<ul>
<li>
<a href="http://bugs.eclipse.org/380538">Bug 380538</a>
<a href="http://bugs.eclipse.org/381207 ">Bug 381207</a>
:
Statics previously located on JAXBContextFactory have been
deprecated and new values made available on JAXBContextProperties.
</li>
<li>
The introduction of the EclipseLink NoSQL release with 2.4
required some EIS API to be moved from the core bundle into the
NoSQL bundle. If you have been using these APIs you will need to
add the NoSQL bundle to your classpath.
</li>
<li>
<a href="http://bugs.eclipse.org/399676">Bug 399676</a>
:
(2.4.2) Deprecation of non-versions REST URIs. JPA-RS accepts request urls with and without version. The URIs without version are deprecated and clients are encourage use versioned ones.
</li>
</ul>
</description>
</section>
<section class="main" name="Retention Policy">
<description>
<p>
The EclipseLink 2.4.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" 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#242">
<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.4.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.4/">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.4/index.html">2.4.2 JavaDocs</a>
</div>
</description>
</section>
</sections>