Package io.helidon.config

Class RetryPolicies.Builder

java.lang.Object

io.helidon.config.RetryPolicies.Builder

All Implemented Interfaces:

java.util.function.Supplier<RetryPolicy>

Enclosing class:

RetryPolicies

public static class RetryPolicies.Builder
extends java.lang.Object
implements java.util.function.Supplier<RetryPolicy>

A builder of the default RetryPolicy.

Method Summary

Modifier and Type	Method	Description
RetryPolicy	build()	Builds a new execute policy.
RetryPolicies.Builder	callTimeout(java.time.Duration callTimeout)	Sets a limit for each invocation.
RetryPolicies.Builder	delay(java.time.Duration delay)	Sets an initial delay between invocations, that is repeatedly multiplied by delayFactor.
RetryPolicies.Builder	delayFactor(double delayFactor)	Sets a factor that prolongs the delay for an every new execute.
RetryPolicies.Builder	executor(java.util.concurrent.ScheduledExecutorService executorService)	Sets a custom executor used to invoke a method call.
static RetryPolicies.Builder	from(Config metaConfig)	Initializes retry policy instance from configuration properties.
RetryPolicy	get()
RetryPolicies.Builder	overallTimeout(java.time.Duration overallTimeout)	Sets a overall limit for all invocation, including delays.

Methods inherited from class java.lang.Object

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

Method Detail

from

public static RetryPolicies.Builder from(Config metaConfig)
                                  throws ConfigMappingException,
                                         MissingValueException

Initializes retry policy instance from configuration properties.

Mandatory properties, see RetryPolicies.repeat(int):

• retries - type int

Optional properties:

• delay - type Duration, see delay(Duration)
• delay-factor - type double, see delayFactor(double)
• call-timeout - type Duration, see callTimeout(Duration)
• overall-timeout - type Duration, see overallTimeout(Duration)

Parameters:

metaConfig - meta-configuration used to initialize returned polling strategy builder instance from.

Returns:

new instance of polling strategy builder described by metaConfig

Throws:

MissingValueException - in case the configuration tree does not contain all expected sub-nodes required by the mapper implementation to provide instance of Java type.

ConfigMappingException - in case the mapper fails to map the (existing) configuration tree represented by the supplied configuration node to an instance of a given Java type.

See Also:

PollingStrategies.regular(Duration)

delay

public RetryPolicies.Builder delay(java.time.Duration delay)

Sets an initial delay between invocations, that is repeatedly multiplied by delayFactor.

The default value is 200ms.

Parameters:

delay - an overall timeout

Returns:

a modified builder instance

delayFactor

public RetryPolicies.Builder delayFactor(double delayFactor)

Sets a factor that prolongs the delay for an every new execute.

The default value is 2.

Parameters:

delayFactor - a delay prolonging factor

Returns:

a modified builder instance

callTimeout

public RetryPolicies.Builder callTimeout(java.time.Duration callTimeout)

Sets a limit for each invocation.

The default value is 500ms.

Parameters:

callTimeout - an invocation timeout - a limit per call

Returns:

a modified builder instance

overallTimeout

public RetryPolicies.Builder overallTimeout(java.time.Duration overallTimeout)

Sets a overall limit for all invocation, including delays.

The default value is 2s.

Parameters:

overallTimeout - an overall timeout

Returns:

a modified builder instance

executor

public RetryPolicies.Builder executor(java.util.concurrent.ScheduledExecutorService executorService)

Sets a custom executor used to invoke a method call.

By default single-threaded executor is used.

Parameters:

executorService - the custom scheduled executor service

Returns:

a modified builder instance

build

public RetryPolicy build()

Builds a new execute policy.

Returns:

the new instance

get

public RetryPolicy get()

Specified by:

get in interface java.util.function.Supplier<RetryPolicy>