File: AbstractIdGenerator.php

package info (click to toggle)
doctrine 2.14.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 10,612 kB
  • sloc: php: 113,660; xml: 4,630; makefile: 28; sh: 14
file content (93 lines) | stat: -rw-r--r-- 2,473 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
<?php

declare(strict_types=1);

namespace Doctrine\ORM\Id;

use Doctrine\Deprecations\Deprecation;
use Doctrine\ORM\EntityManager;
use Doctrine\ORM\EntityManagerInterface;
use InvalidArgumentException;
use LogicException;

use function get_debug_type;
use function sprintf;

abstract class AbstractIdGenerator
{
    /** @var bool */
    private $alreadyDelegatedToGenerateId = false;

    /**
     * Generates an identifier for an entity.
     *
     * @deprecated Call {@see generateId()} instead.
     *
     * @param object|null $entity
     *
     * @return mixed
     */
    public function generate(EntityManager $em, $entity)
    {
        if ($this->alreadyDelegatedToGenerateId) {
            throw new LogicException(sprintf(
                'Endless recursion detected in %s. Please implement generateId() without calling the parent implementation.',
                get_debug_type($this)
            ));
        }

        Deprecation::trigger(
            'doctrine/orm',
            'https://github.com/doctrine/orm/pull/9325',
            '%s::generate() is deprecated, call generateId() instead.',
            get_debug_type($this)
        );

        $this->alreadyDelegatedToGenerateId = true;

        try {
            return $this->generateId($em, $entity);
        } finally {
            $this->alreadyDelegatedToGenerateId = false;
        }
    }

    /**
     * Generates an identifier for an entity.
     *
     * @param object|null $entity
     *
     * @return mixed
     */
    public function generateId(EntityManagerInterface $em, $entity)
    {
        Deprecation::trigger(
            'doctrine/orm',
            'https://github.com/doctrine/orm/pull/9325',
            'Not implementing %s in %s is deprecated.',
            __FUNCTION__,
            get_debug_type($this)
        );

        if (! $em instanceof EntityManager) {
            throw new InvalidArgumentException('Unsupported entity manager implementation.');
        }

        return $this->generate($em, $entity);
    }

    /**
     * Gets whether this generator is a post-insert generator which means that
     * {@link generateId()} must be called after the entity has been inserted
     * into the database.
     *
     * By default, this method returns FALSE. Generators that have this requirement
     * must override this method and return TRUE.
     *
     * @return bool
     */
    public function isPostInsertGenerator()
    {
        return false;
    }
}