|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
declare(strict_types=1); |
|
4
|
|
|
|
|
5
|
|
|
namespace Cycle\ORM\Entity\Behavior\Uuid; |
|
6
|
|
|
|
|
7
|
|
|
use Cycle\ORM\Entity\Behavior\Uuid\Listener\Uuid2 as Listener; |
|
8
|
|
|
use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor; |
|
9
|
|
|
use Doctrine\Common\Annotations\Annotation\Target; |
|
10
|
|
|
use JetBrains\PhpStorm\ArrayShape; |
|
11
|
|
|
use Ramsey\Uuid\Type\Hexadecimal; |
|
12
|
|
|
use Ramsey\Uuid\Type\Integer as IntegerObject; |
|
13
|
|
|
|
|
14
|
|
|
/** |
|
15
|
|
|
* Uses a version 2 (DCE Security) UUID from a local domain, local |
|
16
|
|
|
* identifier, host ID, clock sequence, and the current time |
|
17
|
|
|
* |
|
18
|
|
|
* @Annotation |
|
19
|
|
|
* @NamedArgumentConstructor() |
|
20
|
|
|
* @Target({"CLASS"}) |
|
21
|
|
|
*/ |
|
22
|
|
|
#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE), NamedArgumentConstructor] |
|
23
|
|
|
final class Uuid2 extends Uuid |
|
24
|
|
|
{ |
|
25
|
|
|
/** |
|
26
|
|
|
* @param int $localDomain The local domain to use when generating bytes, |
|
27
|
|
|
* according to DCE Security |
|
28
|
|
|
* @param non-empty-string $field Uuid property name |
|
|
|
|
|
|
29
|
|
|
* @param non-empty-string|null $column Uuid column name |
|
30
|
|
|
* @param IntegerObject|string|null $localIdentifier The local identifier for the |
|
31
|
|
|
* given domain; this may be a UID or GID on POSIX systems, if the local |
|
32
|
|
|
* domain is person or group, or it may be a site-defined identifier |
|
33
|
|
|
* if the local domain is org |
|
34
|
|
|
* @param Hexadecimal|string|null $node A 48-bit number representing the hardware |
|
35
|
|
|
* address |
|
36
|
|
|
* @param int|null $clockSeq A 14-bit number used to help avoid duplicates |
|
37
|
|
|
* that could arise when the clock is set backwards in time or if the |
|
38
|
|
|
* node ID changes |
|
39
|
|
|
* @param bool $nullable Indicates whether to generate a new UUID or not |
|
40
|
|
|
* |
|
41
|
|
|
* @see \Ramsey\Uuid\UuidFactoryInterface::uuid2() |
|
42
|
|
|
*/ |
|
43
|
|
|
public function __construct( |
|
44
|
|
|
private int $localDomain, |
|
45
|
|
|
string $field = 'uuid', |
|
46
|
|
|
?string $column = null, |
|
47
|
|
|
private IntegerObject|string|null $localIdentifier = null, |
|
48
|
|
|
private Hexadecimal|string|null $node = null, |
|
49
|
|
|
private ?int $clockSeq = null, |
|
50
|
|
|
bool $nullable = false |
|
51
|
|
|
) { |
|
52
|
|
|
$this->field = $field; |
|
53
|
|
|
$this->column = $column; |
|
54
|
|
|
$this->nullable = $nullable; |
|
55
|
|
|
} |
|
56
|
|
|
|
|
57
|
|
|
protected function getListenerClass(): string |
|
58
|
|
|
{ |
|
59
|
|
|
return Listener::class; |
|
60
|
|
|
} |
|
61
|
|
|
|
|
62
|
|
|
#[ArrayShape([ |
|
63
|
|
|
'field' => 'string', |
|
64
|
|
|
'localDomain' => 'int', |
|
65
|
|
|
'localIdentifier' => 'string|null', |
|
66
|
|
|
'node' => 'string|null', |
|
67
|
|
|
'clockSeq' => 'int|null', |
|
68
|
|
|
'nullable' => 'bool' |
|
69
|
|
|
])] |
|
70
|
|
|
protected function getListenerArgs(): array |
|
71
|
|
|
{ |
|
72
|
|
|
return [ |
|
73
|
|
|
'field' => $this->field, |
|
74
|
|
|
'localDomain' => $this->localDomain, |
|
75
|
|
|
'localIdentifier' => $this->localIdentifier instanceof IntegerObject |
|
76
|
|
|
? (string) $this->localIdentifier |
|
77
|
|
|
: $this->localIdentifier, |
|
78
|
|
|
'node' => $this->node instanceof Hexadecimal ? (string) $this->node : $this->node, |
|
79
|
|
|
'clockSeq' => $this->clockSeq, |
|
80
|
|
|
'nullable' => $this->nullable |
|
81
|
|
|
]; |
|
82
|
|
|
} |
|
83
|
|
|
} |
|
84
|
|
|
|