package com.codahale.metrics.health.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.util.concurrent.TimeUnit;

An annotation for marking asynchronous health check execution.
/**
 * An annotation for marking asynchronous health check execution.
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Async {
    
Enum representing the initial health states.
/**
     * Enum representing the initial health states.
     */
    enum InitialState {
        HEALTHY, UNHEALTHY
    }

    
Enum representing the possible schedule types.
/**
     * Enum representing the possible schedule types.
     */
    enum ScheduleType {
        FIXED_RATE, FIXED_DELAY
    }

    
Period between executions.
Returns:
period/**
     * Period between executions.
     *
     * @return period
     */
    long period();

    
Scheduling type of asynchronous executions.
Returns:
schedule type/**
     * Scheduling type of asynchronous executions.
     *
     * @return schedule type
     */
    ScheduleType scheduleType() default ScheduleType.FIXED_RATE;

    
Initial delay of first execution.
Returns:
initial delay/**
     * Initial delay of first execution.
     *
     * @return initial delay
     */
    long initialDelay() default 0;

    
Time unit of initial delay, period and healthyTtl.
Returns:
time unit/**
     * Time unit of initial delay, period and healthyTtl.
     *
     * @return time unit
     */
    TimeUnit unit() default TimeUnit.SECONDS;

    
Initial health state until first asynchronous execution completes.
Returns:
initial health state/**
     * Initial health state until first asynchronous execution completes.
     *
     * @return initial health state
     */
    InitialState initialState() default InitialState.HEALTHY;

    
How long a healthy result is considered valid before being ignored.
Handles cases where the asynchronous healthcheck did not run (for example thread starvation).
Defaults to 2 * period
Returns:
healthy result time to live/**
     * How long a healthy result is considered valid before being ignored.
     *
     * Handles cases where the asynchronous healthcheck did not run (for example thread starvation).
     *
     * Defaults to 2 * period
     *
     * @return healthy result time to live
     */
    long healthyTtl() default -1;

}