Class RetryPolicy (2.15.1)

Version 2.15.1

• 2.32.0-rc (latest)
• 2.31.0
• 2.30.0
• 2.29.0
• 2.28.0
• 2.27.0
• 2.26.0
• 2.25.1
• 2.24.0
• 2.23.0
• 2.22.0
• 2.21.0
• 2.20.0
• 2.19.0
• 2.18.0
• 2.17.0
• 2.16.0
• 2.15.1
• 2.14.0
• 2.13.0
• 2.12.0
• 2.11.0
• 2.10.1

Define the interface for retry policies.

Functions

OnFailure(Status const &)

Return true if the retry loop should continue after status.

This functions are typically used in a retry loop, where they control whether to continue, whether a failure should be retried, and finally how to format the error message.

std::unique_ptr<RetryPolicy> policy = ....;
Status status;
while (!policy->IsExhausted()) {
  auto response = try_rpc();  // typically `response` is StatusOr<T>
  if (response.ok()) return response;
  status = std::move(response).status();
  if (!policy->OnFailure(response->status())) {
    if (policy->IsPermanentFailure(response->status()) {
      return StatusModifiedToSayPermanentFailureCausedTheProblem(status);
    }
    return StatusModifiedToSayPolicyExhaustionCausedTheProblem(status);
  }
  // sleep, which may exhaust the policy, even if it was not exhausted in
  // the last call.
}
return StatusModifiedToSayPolicyExhaustionCausedTheProblem(status);

Parameter
Name	Description
status	Status const &

Returns
Type	Description
bool

IsExhausted() const

Return true if the retry policy should stop as the retry limit has been reached.

This functions are typically used in a retry loop, where they control whether to continue, whether a failure should be retried, and finally how to format the error message.

std::unique_ptr<RetryPolicy> policy = ....;
Status status;
while (!policy->IsExhausted()) {
  auto response = try_rpc();  // typically `response` is StatusOr<T>
  if (response.ok()) return response;
  status = std::move(response).status();
  if (!policy->OnFailure(response->status())) {
    if (policy->IsPermanentFailure(response->status()) {
      return StatusModifiedToSayPermanentFailureCausedTheProblem(status);
    }
    return StatusModifiedToSayPolicyExhaustionCausedTheProblem(status);
  }
  // sleep, which may exhaust the policy, even if it was not exhausted in
  // the last call.
}
return StatusModifiedToSayPolicyExhaustionCausedTheProblem(status);

Returns
Type	Description
bool

IsPermanentFailure(Status const &) const

Return true if status is treated as a permanent (and therefore non-retryable) error.

This functions are typically used in a retry loop, where they control whether to continue, whether a failure should be retried, and finally how to format the error message.

std::unique_ptr<RetryPolicy> policy = ....;
Status status;
while (!policy->IsExhausted()) {
  auto response = try_rpc();  // typically `response` is StatusOr<T>
  if (response.ok()) return response;
  status = std::move(response).status();
  if (!policy->OnFailure(response->status())) {
    if (policy->IsPermanentFailure(response->status()) {
      return StatusModifiedToSayPermanentFailureCausedTheProblem(status);
    }
    return StatusModifiedToSayPolicyExhaustionCausedTheProblem(status);
  }
  // sleep, which may exhaust the policy, even if it was not exhausted in
  // the last call.
}
return StatusModifiedToSayPolicyExhaustionCausedTheProblem(status);

Parameter
Name	Description
status	Status const &

Returns
Type	Description
bool