com.jcabi.aspects

Annotation Type Cacheable

@Documented
@Retention(value=RUNTIME)
@Target(value=METHOD)
public @interface Cacheable

Makes a method response cacheable in memory for some time.

For example, this load() method loads some data from the network and we want it to cache loaded data for 5 seconds (to avoid delays):

 @Cacheable(lifetime = 5, unit = TimeUnit.SECONDS)
 String load(String resource) throws IOException {
   return "something";
 }

You can cache them forever, which means that once calculated and cached value will never expire (may be a nice alternative to static initializers):

 @Cacheable(forever = true)
 String load(String resource) throws IOException {
   return "something";
 }

Since version 0.7.14 you can also annotate methods that should flush cache of the object, for example:

public class Page {
   @Cacheable
   public String get() {
     // load data from external source, e.g. the network
     return data;
   }
   @Cacheable.Flush
   public void set(String data) {
     // save data to the network
   }
 }

Since 0.7.18 you can control when exactly flushing happens, with Cacheable.FlushBefore and Cacheable.FlushAfter annotations (Cacheable.Flush is deprecated).

Since:

0.7.7

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

See Also:

http://www.jcabi.com/jcabi-aspects/

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	forever Keep in cache forever.
int	lifetime Lifetime of an object in cache, in time units.
TimeUnit	unit Time units of object lifetime.

Element Detail

lifetime

public abstract int lifetime

Lifetime of an object in cache, in time units.

Default:

1

unit

public abstract TimeUnit unit

Time units of object lifetime.

The minimum unit you can use is a second. We simply can't cache for less than a second, because cache is being cleaned every second.

Default:

java.util.concurrent.TimeUnit.MINUTES

forever

public abstract boolean forever

Keep in cache forever.

Default:

false