com.linecorp.armeria.client.circuitbreaker

Class CircuitBreakerRpcClient

java.lang.Object

com.linecorp.armeria.common.util.AbstractUnwrappable<Client<T_I,T_O>>

com.linecorp.armeria.client.DecoratingClient<I,O,I,O>

com.linecorp.armeria.client.SimpleDecoratingClient<I,O>

com.linecorp.armeria.client.circuitbreaker.AbstractCircuitBreakerClient<RpcRequest,RpcResponse>

com.linecorp.armeria.client.circuitbreaker.CircuitBreakerRpcClient

All Implemented Interfaces:

Client<RpcRequest,RpcResponse>, RpcClient, Unwrappable

public final class CircuitBreakerRpcClient
extends AbstractCircuitBreakerClient<RpcRequest,RpcResponse>
implements RpcClient

An RpcClient decorator that handles failures of RPC remote invocation based on circuit breaker pattern.

Method Summary

Modifier and Type	Method and Description
static CircuitBreakerRpcClientBuilder	builder(CircuitBreakerStrategyWithContent<RpcResponse> strategyWithContent) Returns a new CircuitBreakerRpcClientBuilder with the specified CircuitBreakerStrategyWithContent.
protected RpcResponse	doExecute(ClientRequestContext ctx, RpcRequest req, CircuitBreaker circuitBreaker) Invoked when the CircuitBreaker is in closed state.
static Function<? super RpcClient,CircuitBreakerRpcClient>	newDecorator(CircuitBreaker circuitBreaker, CircuitBreakerStrategyWithContent<RpcResponse> strategy) Creates a new decorator using the specified CircuitBreaker instance and CircuitBreakerStrategy.
static Function<? super RpcClient,CircuitBreakerRpcClient>	newDecorator(CircuitBreakerMapping mapping, CircuitBreakerStrategyWithContent<RpcResponse> strategy) Creates a new decorator with the specified CircuitBreakerMapping and CircuitBreakerStrategy.
static Function<? super RpcClient,CircuitBreakerRpcClient>	newPerHostAndMethodDecorator(Function<String,CircuitBreaker> factory, CircuitBreakerStrategyWithContent<RpcResponse> strategy) Creates a new decorator that binds one CircuitBreaker per host and RPC method name with the specified CircuitBreakerStrategy.
static Function<? super RpcClient,CircuitBreakerRpcClient>	newPerHostDecorator(Function<String,CircuitBreaker> factory, CircuitBreakerStrategyWithContent<RpcResponse> strategy) Creates a new decorator that binds one CircuitBreaker per host with the specified CircuitBreakerStrategy.
static Function<? super RpcClient,CircuitBreakerRpcClient>	newPerMethodDecorator(Function<String,CircuitBreaker> factory, CircuitBreakerStrategyWithContent<RpcResponse> strategy) Creates a new decorator that binds one CircuitBreaker per RPC method name with the specified CircuitBreakerStrategy.

Methods inherited from class com.linecorp.armeria.client.circuitbreaker.AbstractCircuitBreakerClient

execute, reportSuccessOrFailure, strategy, strategyWithContent

Methods inherited from class com.linecorp.armeria.common.util.AbstractUnwrappable

as, delegate, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.linecorp.armeria.client.RpcClient

execute

Methods inherited from interface com.linecorp.armeria.client.Client

as

Method Detail

newDecorator

public static Function<? super RpcClient,CircuitBreakerRpcClient> newDecorator(CircuitBreaker circuitBreaker,
                                                                               CircuitBreakerStrategyWithContent<RpcResponse> strategy)

Creates a new decorator using the specified CircuitBreaker instance and CircuitBreakerStrategy.

Since CircuitBreaker is a unit of failure detection, don't reuse the same instance for unrelated services.

Parameters:

circuitBreaker - The CircuitBreaker instance to be used

newDecorator

public static Function<? super RpcClient,CircuitBreakerRpcClient> newDecorator(CircuitBreakerMapping mapping,
                                                                               CircuitBreakerStrategyWithContent<RpcResponse> strategy)

Creates a new decorator with the specified CircuitBreakerMapping and CircuitBreakerStrategy.

Since CircuitBreaker is a unit of failure detection, don't reuse the same instance for unrelated services.

newPerMethodDecorator

public static Function<? super RpcClient,CircuitBreakerRpcClient> newPerMethodDecorator(Function<String,CircuitBreaker> factory,
                                                                                        CircuitBreakerStrategyWithContent<RpcResponse> strategy)

Creates a new decorator that binds one CircuitBreaker per RPC method name with the specified CircuitBreakerStrategy.

Since CircuitBreaker is a unit of failure detection, don't reuse the same instance for unrelated services.

Parameters:

factory - A function that takes an RPC method name and creates a new CircuitBreaker.

newPerHostDecorator

public static Function<? super RpcClient,CircuitBreakerRpcClient> newPerHostDecorator(Function<String,CircuitBreaker> factory,
                                                                                      CircuitBreakerStrategyWithContent<RpcResponse> strategy)

Creates a new decorator that binds one CircuitBreaker per host with the specified CircuitBreakerStrategy.

Since CircuitBreaker is a unit of failure detection, don't reuse the same instance for unrelated services.

Parameters:

factory - a function that takes a host name and creates a new CircuitBreaker

newPerHostAndMethodDecorator

public static Function<? super RpcClient,CircuitBreakerRpcClient> newPerHostAndMethodDecorator(Function<String,CircuitBreaker> factory,
                                                                                               CircuitBreakerStrategyWithContent<RpcResponse> strategy)

Creates a new decorator that binds one CircuitBreaker per host and RPC method name with the specified CircuitBreakerStrategy.

Since CircuitBreaker is a unit of failure detection, don't reuse the same instance for unrelated services.

Parameters:

factory - a function that takes a host+method and creates a new CircuitBreaker

builder

public static CircuitBreakerRpcClientBuilder builder(CircuitBreakerStrategyWithContent<RpcResponse> strategyWithContent)

Returns a new CircuitBreakerRpcClientBuilder with the specified CircuitBreakerStrategyWithContent.

doExecute

protected RpcResponse doExecute(ClientRequestContext ctx,
                                RpcRequest req,
                                CircuitBreaker circuitBreaker)
                         throws Exception

Description copied from class: AbstractCircuitBreakerClient

Invoked when the CircuitBreaker is in closed state.

Specified by:

doExecute in class AbstractCircuitBreakerClient<RpcRequest,RpcResponse>

Throws:

Exception