Package com.google.gerrit.server.update

Class RetryableChangeAction<T>

java.lang.Object

com.google.gerrit.server.update.RetryableAction<T>

com.google.gerrit.server.update.RetryableChangeAction<T>

public class RetryableChangeAction<T>
extends RetryableAction<T>

A change action that is executed with retrying.

Instances of this class are created via RetryHelper.changeUpdate(String, ChangeAction).

In contrast to normal RetryableAction.Actions that are called via RetryableAction RetryableChangeAction.ChangeActions get a BatchUpdate.Factory provided.

In addition when a change action is called any exception that is not an unchecked exception and neither UpdateException nor RestApiException get wrapped into an UpdateException.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	RetryableChangeAction.ChangeAction<T>

Nested classes/interfaces inherited from class com.google.gerrit.server.update.RetryableAction

RetryableAction.Action<T>, RetryableAction.ActionType

Method Summary

Modifier and Type	Method	Description
T	call()	Executes this action with retry.
RetryableChangeAction<T>	defaultTimeoutMultiplier(int multiplier)	Increases the default timeout by the given multiplier.
RetryableChangeAction<T>	listener(com.github.rholder.retry.RetryListener retryListener)	Sets a listener that is invoked when the action is retried.
RetryableChangeAction<T>	onAutoTrace(Consumer<String> traceIdConsumer)	Sets a callback that is invoked when auto-retry with tracing is triggered.
RetryableChangeAction<T>	retryOn(Predicate<Throwable> exceptionPredicate)	Adds an additional condition that should trigger retries.
RetryableChangeAction<T>	retryWithTrace(Predicate<Throwable> exceptionPredicate)	Sets a condition that should trigger auto-retry with tracing.

Methods inherited from class java.lang.Object

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

Method Detail

retryOn

public RetryableChangeAction<T> retryOn(Predicate<Throwable> exceptionPredicate)

Description copied from class: RetryableAction

Adds an additional condition that should trigger retries.

For some exceptions retrying is enabled globally (see ExceptionHook.shouldRetry(String, String, Throwable)). Conditions for those exceptions do not need to be specified here again.

This method can be invoked multiple times to add further conditions that should trigger retries.

Overrides:

retryOn in class RetryableAction<T>

Parameters:

exceptionPredicate - predicate that decides if the action should be retried for a given exception

Returns:

this instance to enable chaining of calls

retryWithTrace

public RetryableChangeAction<T> retryWithTrace(Predicate<Throwable> exceptionPredicate)

Description copied from class: RetryableAction

Sets a condition that should trigger auto-retry with tracing.

This condition is only relevant if an exception occurs that doesn't trigger (normal) retry.

Auto-retry with tracing automatically captures traces for unexpected exceptions so that they can be investigated.

Every call of this method overwrites any previously set condition for auto-retry with tracing.

Overrides:

retryWithTrace in class RetryableAction<T>

Parameters:

exceptionPredicate - predicate that decides if the action should be retried with tracing for a given exception

Returns:

this instance to enable chaining of calls

onAutoTrace

public RetryableChangeAction<T> onAutoTrace(Consumer<String> traceIdConsumer)

Description copied from class: RetryableAction

Sets a callback that is invoked when auto-retry with tracing is triggered.

Via the callback callers can find out with trace ID was used for the retry.

Every call of this method overwrites any previously set trace ID consumer.

Overrides:

onAutoTrace in class RetryableAction<T>

Parameters:

traceIdConsumer - trace ID consumer

Returns:

this instance to enable chaining of calls

listener

public RetryableChangeAction<T> listener(com.github.rholder.retry.RetryListener retryListener)

Description copied from class: RetryableAction

Sets a listener that is invoked when the action is retried.

Every call of this method overwrites any previously set listener.

Overrides:

listener in class RetryableAction<T>

Parameters:

retryListener - retry listener

Returns:

this instance to enable chaining of calls

defaultTimeoutMultiplier

public RetryableChangeAction<T> defaultTimeoutMultiplier(int multiplier)

Description copied from class: RetryableAction

Increases the default timeout by the given multiplier.

Every call of this method overwrites any previously set timeout.

Overrides:

defaultTimeoutMultiplier in class RetryableAction<T>

Parameters:

multiplier - multiplier for the default timeout

Returns:

this instance to enable chaining of calls

call

public T call()
       throws UpdateException,
              RestApiException

Description copied from class: RetryableAction

Executes this action with retry.

Overrides:

call in class RetryableAction<T>

Returns:

the result of the action

Throws:

UpdateException

RestApiException