Debian Codegraph @

vendor/ramsey/uuid/src/Builder/FallbackBuilder.php

raw
1 <?php
2
3 /**
4 * This file is part of the ramsey/uuid library
5 *
6 * For the full copyright and license information, please view the LICENSE
7 * file that was distributed with this source code.
8 *
9 * @copyright Copyright (c) Ben Ramsey <[email protected]>
10 * @license http://opensource.org/licenses/MIT MIT
11 */
12
13 declare(strict_types=1);
14
15 namespace Ramsey\Uuid\Builder;
16
17 use Ramsey\Uuid\Codec\CodecInterface;
18 use Ramsey\Uuid\Exception\BuilderNotFoundException;
19 use Ramsey\Uuid\Exception\UnableToBuildUuidException;
20 use Ramsey\Uuid\UuidInterface;
21
22 /**
23 * FallbackBuilder builds a UUID by stepping through a list of UUID builders until a UUID can be constructed without exceptions
24 *
25 * @immutable
26 */
27 class FallbackBuilder implements UuidBuilderInterface
28 {
29 /**
30 * @param iterable<UuidBuilderInterface> $builders An array of UUID builders
31 */
32 public function __construct(private iterable $builders)
33 {
34 }
35
36 /**
37 * Builds and returns a UuidInterface instance using the first builder that succeeds
38 *
39 * @param CodecInterface $codec The codec to use for building this instance
40 * @param string $bytes The byte string from which to construct a UUID
41 *
42 * @return UuidInterface an instance of a UUID object
43 *
44 * @pure
45 */
46 public function build(CodecInterface $codec, string $bytes): UuidInterface
47 {
48 $lastBuilderException = null;
49
50 foreach ($this->builders as $builder) {
51 try {
52 return $builder->build($codec, $bytes);
53 } catch (UnableToBuildUuidException $exception) {
54 $lastBuilderException = $exception;
55
56 continue;
57 }
58 }
59
60 throw new BuilderNotFoundException(
61 'Could not find a suitable builder for the provided codec and fields',
62 0,
63 $lastBuilderException,
64 );
65 }
66 }