Package com.google.gerrit.server.update

Class RetryableIndexQueryAction<Q extends InternalQuery<?,Q>,T>

java.lang.Object
com.google.gerrit.server.update.RetryableAction<T>
com.google.gerrit.server.update.RetryableIndexQueryAction<Q,T>
public class RetryableIndexQueryAction<Q extends InternalQuery<?,Q>,T> extends RetryableAction<T>
An action to query an index that is executed with retrying.

Instances of this class are created via RetryHelper.accountIndexQuery(String, IndexQueryAction) and RetryHelper.changeIndexQuery(String, IndexQueryAction).

In contrast to normal RetryableAction.Actions that are called via RetryableAction RetryableIndexQueryAction.IndexQueryActions get a InternalQuery provided.

In addition when an index query action is called any exception that is not an unchecked exception gets wrapped into an StorageException.

  • Method Details

    • retryOn

      public RetryableIndexQueryAction<Q,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 RetryableIndexQueryAction<Q,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 RetryableIndexQueryAction<Q,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 RetryableIndexQueryAction<Q,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 RetryableIndexQueryAction<Q,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()
      Description copied from class: RetryableAction
      Executes this action with retry.
      Overrides:
      call in class RetryableAction<T>
      Returns:
      the result of the action