com.github.rollingmetrics.util

Class ResilientExecutionUtil

java.lang.Object

com.github.rollingmetrics.util.ResilientExecutionUtil

public final class ResilientExecutionUtil
extends Object

Util class which should be used for execution tasks(like histogram rotation) in background. Known clients: ResetByChunksRollingHdrHistogramImpl. For background execution this class maintains own implementation of executor SingleThreadExecutor which extremely fast and has no blocking on task queueing.

Method Summary

Modifier and Type	Method and Description
void	execute(Executor executor, Runnable task) Executes task on executor.
Executor	getBackgroundExecutor()
static ResilientExecutionUtil	getInstance()
void	setThreadFactory(ThreadFactory threadFactory) Sets the thread threadFactory which will be used for construction of SingleThreadExecutor.
void	shutdownBackgroundExecutor() If the getBackgroundExecutor() was called before, the this method perform shutdown of background execution thread.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static ResilientExecutionUtil getInstance()

Returns:

instance of ResilientExecutionUtil

execute

public void execute(Executor executor,
                    Runnable task)

Executes task on executor. If executor is terminated or overloaded then executes task in current thread.

Parameters:

executor -

task -

getBackgroundExecutor

public Executor getBackgroundExecutor()

Returns:

instance of SingleThreadExecutor

shutdownBackgroundExecutor

public void shutdownBackgroundExecutor()

If the getBackgroundExecutor() was called before, the this method perform shutdown of background execution thread.

setThreadFactory

public void setThreadFactory(ThreadFactory threadFactory)

Sets the thread threadFactory which will be used for construction of SingleThreadExecutor.

This method should be called strongly before first invocation of getBackgroundExecutor().

This method is designed to be used in restricted environments with enabled SecurityManager, when creation of new thread can fail by security limitation. Normally, you should not use this method, because DEFAULT_THREAD_FACTORY is quit enough.

Parameters:

threadFactory -

Throws:

IllegalStateException - if executor already created