com.ryantenney.metrics.annotation

Annotation Type CachedGauge

@Retention(value=RUNTIME)
@Target(value=METHOD)
public @interface CachedGauge

An annotation for marking a method as a gauge, which caches the result for a specified time.

Given a method like this:

     @CachedGauge(name = "queueSize", timeout = 30, timeoutUnit = TimeUnit.SECONDS)
     public int getQueueSize() {
         return queue.getSize();
     }
 
 

A gauge for the defining class with the name queueSize will be created which uses the annotated method's return value as its value, and which caches the result for 30 seconds.

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
long	timeout The amount of time to cache the result

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	absolute If true, use the given name as an absolute name.
String	name The name of the counter.
TimeUnit	timeoutUnit The unit of timeout

Element Detail

timeout

public abstract long timeout

The amount of time to cache the result

name

public abstract String name

The name of the counter.

Default:

""

absolute

public abstract boolean absolute

If true, use the given name as an absolute name. If false, use the given name relative to the annotated class.

Default:

false

timeoutUnit

public abstract TimeUnit timeoutUnit

The unit of timeout

Default:

java.util.concurrent.TimeUnit.MILLISECONDS