net.uncontended.precipice

Class DefaultRunService

java.lang.Object

net.uncontended.precipice.AbstractService

net.uncontended.precipice.DefaultRunService

All Implemented Interfaces:

RunService, Service

public class DefaultRunService
extends AbstractService
implements RunService

Field Summary

Fields inherited from class net.uncontended.precipice.AbstractService

actionMetrics, circuitBreaker, isShutdown, semaphore

Fields inherited from interface net.uncontended.precipice.Service

MAX_CONCURRENCY_LEVEL, MAX_TIMEOUT_MILLIS

Constructor Summary

Constructors

Constructor and Description
DefaultRunService(PrecipiceSemaphore semaphore)
DefaultRunService(PrecipiceSemaphore semaphore, ActionMetrics actionMetrics)
DefaultRunService(PrecipiceSemaphore semaphore, ActionMetrics actionMetrics, CircuitBreaker circuitBreaker)
DefaultRunService(PrecipiceSemaphore semaphore, ActionMetrics actionMetrics, CircuitBreaker circuitBreaker, java.util.concurrent.atomic.AtomicBoolean isShutdown)
DefaultRunService(PrecipiceSemaphore semaphore, CircuitBreaker breaker)

Method Summary

Modifier and Type	Method and Description
<T> T	run(ResilientAction<T> action) Performs a ResilientAction that will be run synchronously on the calling thread.
void	shutdown() Attempts to shutdown the service.

Methods inherited from class net.uncontended.precipice.AbstractService

acquirePermitOrRejectIfActionNotAllowed, getActionMetrics, getCircuitBreaker

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.uncontended.precipice.Service

getActionMetrics, getCircuitBreaker

Constructor Detail

DefaultRunService

public DefaultRunService(PrecipiceSemaphore semaphore)

DefaultRunService

public DefaultRunService(PrecipiceSemaphore semaphore,
                         ActionMetrics actionMetrics)

DefaultRunService

public DefaultRunService(PrecipiceSemaphore semaphore,
                         CircuitBreaker breaker)

DefaultRunService

public DefaultRunService(PrecipiceSemaphore semaphore,
                         ActionMetrics actionMetrics,
                         CircuitBreaker circuitBreaker)

DefaultRunService

public DefaultRunService(PrecipiceSemaphore semaphore,
                         ActionMetrics actionMetrics,
                         CircuitBreaker circuitBreaker,
                         java.util.concurrent.atomic.AtomicBoolean isShutdown)

Method Detail

run

public <T> T run(ResilientAction<T> action)
          throws java.lang.Exception

Description copied from interface: RunService

Performs a ResilientAction that will be run synchronously on the calling thread. However, at the completion of the task, the result will be delivered to the promise provided. And the provided callback will be executed.

If the ResilientAction throws a ActionTimeoutException, the result of the action will be a timeout. Any other exception and the result of the action will be an error.

Specified by:

run in interface RunService

Type Parameters:

T - the type of the result of the action

Parameters:

action - the action to run

Returns:

a ResilientPromise representing result of the action

Throws:

RejectedActionException - if the action is rejected

java.lang.Exception

shutdown

public void shutdown()

Description copied from interface: Service

Attempts to shutdown the service. Actions after this call will throw a RejectedActionException. Implementations may differ on if pending or executing actions are cancelled.

Specified by:

shutdown in interface Service