cayenne-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Cayenne Website > Cayenne 3.1M2 is Released
Date Tue, 08 Mar 2011 12:11:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2036/9/1/_/styles/combined.css?spaceKey=CAYSITE&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/CAYSITE/2011/03/08/Cayenne+3.1M2+is+Released">Cayenne
3.1M2 is Released</a></h2>
    <h4>Blog post  <b>added</b> by             <a href="https://cwiki.apache.org/confluence/display/~andrus">Andrus
Adamchik</a>
    </h4>
         <br/>
    <div class="notificationGreySide">
         <p>We keep improving Cayenne 3.1 with the new M2 milestone release. If you've
already experimented with 3.1, M2 is a must-have upgrade - it fixes a number of bugs that
affected runtime stability (<a href="https://issues.apache.org/jira/browse/CAY-1515" class="external-link"
rel="nofollow">CAY-1515</a>, <a href="https://issues.apache.org/jira/browse/CAY-1519"
class="external-link" rel="nofollow">CAY-1519</a>). If you haven't, maybe it is time
to try it out? <img class="emoticon" src="/confluence/images/icons/emoticons/wink.gif"
height="20" width="20" align="absmiddle" alt="" border="0"/> Usual disclaimer applies about
M2 being an early alpha and the new APIs being subject to change. In addition to the numerous
bugfixes in the runtime and the Modeler, the new release introduces a  set of brand new powerful
tools for object lifecycle management. We'll briefly describe them here. Please check <a
href="http://cayenne.apache.org/doc/guide-to-31-features.html" class="external-link" rel="nofollow">Guide
to 3.1 Features</a> for more details.</p>

<p>1. Cayenne now allows to declare listener methods with annotations. Configuring listener
methods in the Modeler (or via API for that matter) was arguably the most tedious mapping
task in Cayenne. What's even worse, if you reuse your model in more than one app, you may
not want the listeners to be shared, so you don't want them to be in the model at all. M2
solves that by letting you to annotate the listener class, and registering a listener object
where you need it with a single method call. A listener object can of course have multiple
annotated callback methods:</p>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>MyListener listener = new MyListener();
runtime.getChannel().getEntityResolver().getCallbackRegistry().addListener(listener);</pre>
</div></div>

<p>While JPA users may think that lifecycle annotations is old news, Cayenne goes a
bit further than JPA here. Cayenne annotations let you attach a listener not just to specific
entities, but also to entities whose names are not known to the listener upfront. A listener
annotation may reference an arbitrary user-defined annotation which is then placed on entity
classes. All of this completely changes how you manage your listeners. It becomes simple,
clear and flexible. </p>

<p>2. Another cool lifecycle management tool is <tt>DataChannelFilter</tt>.
A chain of filters can be configured by the user to intercept and react to the data traffic
(selects, commits) between DataContext and DataDomain. This was sort of possible before by
decorating a DataChannel, however the new approach is much less invasive, and more importantly,
the filter object can also have annotated listener methods that are aware of the ongoing select
or commit operation. That's what ultimately makes it usable in real-life situations. <a
href="http://svn.apache.org/repos/asf/cayenne/main/tags/3.1M2/framework/cayenne-lifecycle/src/main/java/org/apache/cayenne/lifecycle/cache/CacheInvalidationFilter.java"
class="external-link" rel="nofollow">CacheInvalidationFilter</a> in <tt>cayenne-lifeycle</tt>
module (<tt>cayenne-lifecycle</tt> is described below) is a good example of how
a filter collects some information about an ongoing persistence operation in a ThreadLocal
object, and then processes aggregated information at the end of this operation.</p>

<p>3. We are taking advantage of the above feature by providing a <tt>cayenne-lifecycle</tt>
extensions module that implements a few common lifecycle management scenarios - object audit,
automated cache group invalidation, and handling a new kind of "to-any" relationship (we tentatively
called that one a UuidRelationship). You may use <tt>cayenne-lifecycle</tt> goodies
as is, extend them, or simply refer to it as an example of what is possible with the new lifecycle
tools. There's still lots of experimentation going on here, so its API is likely to change.</p>

<p>Finally, 3.1M2 download link: <a href="http://cayenne.apache.org/download.html"
class="external-link" rel="nofollow">http://cayenne.apache.org/download.html</a></p>


    </div>
    <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
       </div>
       <a href="https://cwiki.apache.org/confluence/display/CAYSITE/2011/03/08/Cayenne+3.1M2+is+Released">View
Online</a>
           </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message