Skip to content

Commit

Permalink
+ update cache docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Costin Leau committed Nov 28, 2011
1 parent 263dd55 commit ac52433
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions spring-framework-reference/src/cache.xml
Expand Up @@ -248,6 +248,11 @@ public void loadBooks(InputStream batch)]]></programlisting>
all the entires are removed in one operation as shown above. Note that the framework will ignore any key specified in this scenario as it does not apply (the entire cache is evicted not just
one entry).</para>

<para>One can also indicate whether the eviction should occur after (the default) or before the method executes (the default) through the <literal>afterInvocation</literal> attribute.
The former provides the same semantics as the rest of the annotations - once the method completes successfully, an action (in this case eviction) on the cache is executed. If the method does not
execute (as it might be cached) or an exception is thrown, the eviction does not occur. The latter (<literal>afterInvocation=false</literal>) causes the eviction to occur always, before the method
is invoked - this is useful in cases where the eviction does not need to be tied to the method outcome.</para>

<para>It is important to note that void methods can be used with <literal>@CacheEvict</literal> - as the methods act as triggers, the return values are ignored (as they don't interact with
the cache) - this is not the case with <literal>@Cacheable</literal> which adds/update data into the cache and thus requires a result.</para>
</section>
Expand Down

0 comments on commit ac52433

Please sign in to comment.