com.netflix.loadbalancer.reactive

Interface ExecutionListener<I,O>

Type Parameters:

I - Input type used by ExecutionContext passed to listener where it can call ExecutionContext.getRequest() to examine the request object of the execution

O - Output type from the load balancer execution, used by onExecutionSuccess(ExecutionContext, Object, com.netflix.loadbalancer.reactive.ExecutionInfo) API

public interface ExecutionListener<I,O>

A listener to be invoked by load balancer at different stage of execution.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ExecutionListener.AbortExecutionException An exception to indicate that the listener wants to abort execution

Method Summary

Methods

Modifier and Type	Method and Description
void	onExceptionWithServer(ExecutionContext<I> context, java.lang.Throwable exception, ExecutionInfo info) Called when an exception is received from executing the request on a server.
void	onExecutionFailed(ExecutionContext<I> context, java.lang.Throwable finalException, ExecutionInfo info) Called when the request is considered failed after all retries.
void	onExecutionStart(ExecutionContext<I> context) Called when execution is about to start.
void	onExecutionSuccess(ExecutionContext<I> context, O response, ExecutionInfo info) Called when the request is executed successfully on the server
void	onStartWithServer(ExecutionContext<I> context, ExecutionInfo info) Called when a server is chosen and the request is going to be executed on the server.

Method Detail

onExecutionStart

void onExecutionStart(ExecutionContext<I> context)
                      throws ExecutionListener.AbortExecutionException

Called when execution is about to start.

Throws:

ExecutionListener.AbortExecutionException - if the listener would like to abort the execution

onStartWithServer

void onStartWithServer(ExecutionContext<I> context,
                     ExecutionInfo info)
                       throws ExecutionListener.AbortExecutionException

Called when a server is chosen and the request is going to be executed on the server.

Throws:

ExecutionListener.AbortExecutionException - if the listener would like to abort the execution

onExceptionWithServer

void onExceptionWithServer(ExecutionContext<I> context,
                         java.lang.Throwable exception,
                         ExecutionInfo info)

Called when an exception is received from executing the request on a server.

Parameters:

exception - Exception received

onExecutionSuccess

void onExecutionSuccess(ExecutionContext<I> context,
                      O response,
                      ExecutionInfo info)

Called when the request is executed successfully on the server

Parameters:

response - Object received from the execution

onExecutionFailed

void onExecutionFailed(ExecutionContext<I> context,
                     java.lang.Throwable finalException,
                     ExecutionInfo info)

Called when the request is considered failed after all retries.

Parameters:

finalException - Final exception received. This may be a wrapped exception indicating that all retries have been exhausted.