Viewing file:  Retry.php (3.28 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?php
/**
* Copyright 2016 Google Inc. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
namespace Google\Cloud\Core;
/**
* Retry implementation.
*
* Unlike {@see Google\Cloud\Core\ExponentialBackoff}, Retry requires an implementor
* to supply wait times for each iteration.
*/
class Retry
{
/**
* @var int
*/
private $retries;
/**
* @var callable
*/
private $delayFunction;
/**
* @var callable|null
*/
private $retryFunction;
/**
* @param int|null $retries Maximum number of retries for a failed request.
* @param callable $delayFunction A function returning an array of format
* `['seconds' => (int >= 0), 'nanos' => (int >= 0)] specifying how
* long an operation should pause before retrying. Should accept a
* single argument of type `\Exception`.
* @param callable $retryFunction [optional] returns bool for whether or not
* to retry.
*/
public function __construct(
$retries,
callable $delayFunction,
callable $retryFunction = null
) {
$this->retries = $retries !== null ? (int) $retries : 3;
$this->delayFunction = $delayFunction;
$this->retryFunction = $retryFunction;
}
/**
* Executes the retry process.
*
* @param callable $function
* @param array $arguments [optional]
* @return mixed
* @throws \Exception The last exception caught while retrying.
*/
public function execute(callable $function, array $arguments = [])
{
$delayFunction = $this->delayFunction;
$retryAttempt = 0;
$continue = true;
do {
try {
$res = call_user_func_array($function, $arguments);
$continue = false;
return $res;
} catch (\Exception $exception) {
if ($this->retryFunction) {
if (!call_user_func($this->retryFunction, $exception, $retryAttempt)) {
throw $exception;
}
}
if ($retryAttempt < $this->retries) {
$delay = $delayFunction($exception);
$delay += [
'seconds' => 0,
'nanos' => 0
];
time_nanosleep($delay['seconds'], $delay['nanos']);
$retryAttempt++;
} else {
$continue = false;
throw $exception;
}
}
} while ($continue);
}
/**
* @param callable $delayFunction
* @return void
*/
public function setDelayFunction(callable $delayFunction)
{
$this->delayFunction = $delayFunction;
}
}
|