com.signalfx.codahale.metrics.SettableLongGauge Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of signalfx-codahale Show documentation

Dropwizard Codahale metrics plugin for signalfx

There is a newer version: 1.0.43

package com.signalfx.codahale.metrics;

import com.codahale.metrics.Gauge;
import com.codahale.metrics.Metric;

/**
 * 
 * Works like a Gauge, but rather than getting its value from a callback, the value
 * is set when needed.  This can be somewhat convienent, but direct use of a Gauge is likely better
 * 
 * 
 *     Usage example:
 *     
{@code
 *       MetricRegister metricRegistry;
 *       SettableLongGauge settable = metricRegistry.register("metric.name", new SettableLongGauge());
 *       // ...
 *       settable.setValue(100);
 *       // ...
 *       settable.setValue(200);
 *     }
 *
 *     
 */
public class SettableLongGauge implements Metric, Gauge {
    /**
     * Current value.  Assignment will be atomic.  See 17.7
     */
    private volatile long value = 0;

    /**
     * Set the current value the {@link Gauge} will return to something else.
     * @param value    last set value
     * @return itself
     */
    public SettableLongGauge setValue(long value) {
        this.value = value;
        return this;
    }

    /**
     * The last value set by {@link #setValue(long)}}
     * @return Last set value, or zero.
     */
    public Long getValue() {
        return value;
    }

    public final static class Builder implements MetricBuilder {
        public static final Builder INSTANCE = new Builder();

        private Builder() {
        }

        @Override
        public SettableLongGauge newMetric() {
            return new SettableLongGauge();
        }

        @Override
        public boolean isInstance(Metric metric) {
            return metric instanceof SettableLongGauge;
        }
    }
}