com.jcabi.aspects

Annotation Type Cacheable

@Documented
@Retention(value=RUNTIME)
@Target(value={METHOD,CONSTRUCTOR})
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:

0.8

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

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.

Default:

java.util.concurrent.TimeUnit.MINUTES

forever

public abstract boolean forever

Keep in cache forever.

Default:

false