fish.payara.microprofile.faulttolerance.service

Class FaultToleranceServiceImpl

java.lang.Object

fish.payara.microprofile.faulttolerance.service.FaultToleranceServiceImpl

All Implemented Interfaces:

FaultToleranceService, MonitoringDataSource, EventListener

@ContractsProvided(value=FaultToleranceService.class)
 @Service(name="microprofile-fault-tolerance-service")
 @RunLevel(value=10)
public class FaultToleranceServiceImpl
extends Object
implements EventListener, FaultToleranceService, MonitoringDataSource

Base Service for MicroProfile Fault Tolerance.

Author:

Andrew Pielage, Jan Bernitt (2.0)

Nested Class Summary

Nested classes/interfaces inherited from interface org.glassfish.api.event.EventListener

EventListener.Event<T>

Constructor Summary

Constructors

Constructor and Description
FaultToleranceServiceImpl()

Method Summary

Modifier and Type	Method and Description
void	collect(MonitoringDataCollector collector) Collects all the data points of this at the current moment.
void	delay(long delayMillis, javax.interceptor.InvocationContext context) Delays the current thread by the given duration.
void	endTrace() Ends the innermost trace.
void	event(EventListener.Event<?> event) Process a Glassfish/Payara event
Object	fallbackHandle(Class<? extends org.eclipse.microprofile.faulttolerance.FallbackHandler<?>> fallbackClass, javax.interceptor.InvocationContext context, Exception ex) Invokes the instance of the given FallbackHandler Class defined in the given context to handle the given Exception.
Object	fallbackInvoke(Method fallbackMethod, javax.interceptor.InvocationContext context) Invokes the given fallback Method in the given context.
BulkheadSemaphore	getConcurrentExecutions(int maxConcurrentThreads, javax.interceptor.InvocationContext context)
FaultToleranceConfig	getConfig(javax.interceptor.InvocationContext context, Stereotypes stereotypes) Creates an instance of a FaultToleranceConfig bound to the given InvocationContext and Stereotypes lookup.
FaultToleranceMetrics	getMetrics(javax.interceptor.InvocationContext context) Creates an instance of FaultToleranceMetrics bound to the given InvocationContext.
CircuitBreakerState	getState(int requestVolumeThreshold, javax.interceptor.InvocationContext context)
BulkheadSemaphore	getWaitingQueuePopulation(int queueCapacity, javax.interceptor.InvocationContext context)
void	postConstruct()
void	runAsynchronous(CompletableFuture<Object> asyncResult, javax.interceptor.InvocationContext context, Callable<Object> task) Runs the task asynchronously and completes the given asyncResult with the its outcome.
Future<?>	runDelayed(long delayMillis, Runnable task) Runs a given task after a certain waiting time.
void	trace(String method, javax.interceptor.InvocationContext context) Starts tracing the given context named with the given method label.

Methods inherited from class java.lang.Object

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

Constructor Detail

FaultToleranceServiceImpl

public FaultToleranceServiceImpl()

Method Detail

postConstruct

@PostConstruct
public void postConstruct()
                                  throws NamingException

Throws:

NamingException

event

public void event(EventListener.Event<?> event)

Description copied from interface: EventListener

Process a Glassfish/Payara event

Specified by:

event in interface EventListener

collect

public void collect(MonitoringDataCollector collector)

Description copied from interface: MonitoringDataSource

Collects all the data points of this at the current moment.

Specified by:

collect in interface MonitoringDataSource

Parameters:

collector - the MonitoringDataCollector instance to use to collect the data points of this source

getConfig

public FaultToleranceConfig getConfig(javax.interceptor.InvocationContext context,
                                      Stereotypes stereotypes)

Description copied from interface: FaultToleranceService

Creates an instance of a FaultToleranceConfig bound to the given InvocationContext and Stereotypes lookup.

Specified by:

getConfig in interface FaultToleranceService

Parameters:

context - currently processed context

stereotypes - way to lookup sterotype annotations

Returns:

a thread safe FaultToleranceConfig instance bound to the given context

getMetrics

public FaultToleranceMetrics getMetrics(javax.interceptor.InvocationContext context)

Description copied from interface: FaultToleranceService

Creates an instance of FaultToleranceMetrics bound to the given InvocationContext.

Specified by:

getMetrics in interface FaultToleranceService

Parameters:

context - currently processed context

Returns:

a thread safe FaultToleranceMetrics instance bound to the given context

getState

public CircuitBreakerState getState(int requestVolumeThreshold,
                                    javax.interceptor.InvocationContext context)

Specified by:

getState in interface FaultToleranceService

getConcurrentExecutions

public BulkheadSemaphore getConcurrentExecutions(int maxConcurrentThreads,
                                                 javax.interceptor.InvocationContext context)

Specified by:

getConcurrentExecutions in interface FaultToleranceService

getWaitingQueuePopulation

public BulkheadSemaphore getWaitingQueuePopulation(int queueCapacity,
                                                   javax.interceptor.InvocationContext context)

Specified by:

getWaitingQueuePopulation in interface FaultToleranceService

delay

public void delay(long delayMillis,
                  javax.interceptor.InvocationContext context)
           throws InterruptedException

Description copied from interface: FaultToleranceService

Delays the current thread by the given duration. The delay is traced.

Specified by:

delay in interface FaultToleranceService

Parameters:

delayMillis - the time to sleep in milliseconds

context - current context delayed

Throws:

InterruptedException - In case waiting is interrupted

runAsynchronous

public void runAsynchronous(CompletableFuture<Object> asyncResult,
                            javax.interceptor.InvocationContext context,
                            Callable<Object> task)
                     throws RejectedExecutionException

Description copied from interface: FaultToleranceService

Runs the task asynchronously and completes the given asyncResult with the its outcome.

Specified by:

runAsynchronous in interface FaultToleranceService

Parameters:

asyncResult - a not yet completed CompletableFuture that should receive the result of the operation when it is executed

context - the currently processed context (for e.g. tracing)

task - an operation that must compute a value of type Future or CompletionStage.

Throws:

RejectedExecutionException - In case the task could not be accepted for execution. Usually due to too many work in progress.

runDelayed

public Future<?> runDelayed(long delayMillis,
                            Runnable task)
                     throws Exception

Description copied from interface: FaultToleranceService

Runs a given task after a certain waiting time.

Specified by:

runDelayed in interface FaultToleranceService

Parameters:

delayMillis - time to wait in milliseconds before running the given task

task - operation to run

Returns:

A future that can be cancelled if the operation should no longer be run

Throws:

Exception

fallbackHandle

public Object fallbackHandle(Class<? extends org.eclipse.microprofile.faulttolerance.FallbackHandler<?>> fallbackClass,
                             javax.interceptor.InvocationContext context,
                             Exception ex)
                      throws Exception

Description copied from interface: FaultToleranceService

Invokes the instance of the given FallbackHandler Class defined in the given context to handle the given Exception.

Specified by:

fallbackHandle in interface FaultToleranceService

Parameters:

fallbackClass - the type of FallbackHandler to resolve or instantiate and use

context - the currently processed context to use for arguments

ex - the Exception thrown by the FT processing to handle by the FallbackHandler

Returns:

the result returned by the invoked FallbackHandler

Throws:

Exception - in case resolving, instantiating or invoking the handler method fails

fallbackInvoke

public Object fallbackInvoke(Method fallbackMethod,
                             javax.interceptor.InvocationContext context)
                      throws Exception

Description copied from interface: FaultToleranceService

Invokes the given fallback Method in the given context.

Specified by:

fallbackInvoke in interface FaultToleranceService

Parameters:

fallbackMethod - the Method to invoke

context - the currently processed context to use for target instance and method arguments

Returns:

the result returned by the invoked fallback method

Throws:

Exception - in case invoking the method fails or the invoked method threw an Exception

trace

public void trace(String method,
                  javax.interceptor.InvocationContext context)

Description copied from interface: FaultToleranceService

Starts tracing the given context named with the given method label.

Specified by:

trace in interface FaultToleranceService

Parameters:

method - the label to use for the trace

context - the currently processed context

endTrace

public void endTrace()

Description copied from interface: FaultToleranceService

Ends the innermost trace.

Specified by:

endTrace in interface FaultToleranceService