diff options
author | Devian <devianleong@gmail.com> | 2021-04-22 17:11:12 +0800 |
---|---|---|
committer | Devian <devianleong@gmail.com> | 2021-04-22 17:11:12 +0800 |
commit | bf68fa166afb95d682007e7671c2b0692227bec5 (patch) | |
tree | 26091a1e5a821905b8bdba73fd1ddb95e12f887e /vendor/doctrine/persistence/lib/Doctrine/Common | |
parent | 745cf2431a71d0e6c5f08f8605839279b2f7496e (diff) |
Initial
Diffstat (limited to 'vendor/doctrine/persistence/lib/Doctrine/Common')
-rw-r--r-- | vendor/doctrine/persistence/lib/Doctrine/Common/Persistence/PersistentObject.php | 238 |
1 files changed, 0 insertions, 238 deletions
diff --git a/vendor/doctrine/persistence/lib/Doctrine/Common/Persistence/PersistentObject.php b/vendor/doctrine/persistence/lib/Doctrine/Common/Persistence/PersistentObject.php deleted file mode 100644 index d75f127..0000000 --- a/vendor/doctrine/persistence/lib/Doctrine/Common/Persistence/PersistentObject.php +++ /dev/null @@ -1,238 +0,0 @@ -<?php - -namespace Doctrine\Common\Persistence; - -use BadMethodCallException; -use Doctrine\Common\Collections\ArrayCollection; -use Doctrine\Common\Collections\Collection; -use Doctrine\Persistence\Mapping\ClassMetadata; -use Doctrine\Persistence\ObjectManager; -use Doctrine\Persistence\ObjectManagerAware; -use InvalidArgumentException; -use RuntimeException; - -use function lcfirst; -use function substr; - -/** - * PersistentObject base class that implements getter/setter methods for all mapped fields and associations - * by overriding __call. - * - * This class is a forward compatible implementation of the PersistentObject trait. - * - * Limitations: - * - * 1. All persistent objects have to be associated with a single ObjectManager, multiple - * ObjectManagers are not supported. You can set the ObjectManager with `PersistentObject#setObjectManager()`. - * 2. Setters and getters only work if a ClassMetadata instance was injected into the PersistentObject. - * This is either done on `postLoad` of an object or by accessing the global object manager. - * 3. There are no hooks for setters/getters. Just implement the method yourself instead of relying on __call(). - * 4. Slower than handcoded implementations: An average of 7 method calls per access to a field and 11 for an association. - * 5. Only the inverse side associations get autoset on the owning side as well. Setting objects on the owning side - * will not set the inverse side associations. - * - * @deprecated Deprecated `PersistentObject` class in 1.2. Please implement this functionality - * directly in your application if you want ActiveRecord style functionality. - * - * @example - * - * PersistentObject::setObjectManager($em); - * - * class Foo extends PersistentObject - * { - * private $id; - * } - * - * $foo = new Foo(); - * $foo->getId(); // method exists through __call - */ -abstract class PersistentObject implements ObjectManagerAware -{ - /** @var ObjectManager|null */ - private static $objectManager = null; - - /** @var ClassMetadata|null */ - private $cm = null; - - /** - * Sets the object manager responsible for all persistent object base classes. - * - * @return void - */ - public static function setObjectManager(?ObjectManager $objectManager = null) - { - self::$objectManager = $objectManager; - } - - /** - * @return ObjectManager|null - */ - public static function getObjectManager() - { - return self::$objectManager; - } - - /** - * Injects the Doctrine Object Manager. - * - * @return void - * - * @throws RuntimeException - */ - public function injectObjectManager(ObjectManager $objectManager, ClassMetadata $classMetadata) - { - if ($objectManager !== self::$objectManager) { - throw new RuntimeException('Trying to use PersistentObject with different ObjectManager instances. ' . - 'Was PersistentObject::setObjectManager() called?'); - } - - $this->cm = $classMetadata; - } - - /** - * Sets a persistent fields value. - * - * @param string $field - * @param mixed[] $args - * - * @return void - * - * @throws BadMethodCallException When no persistent field exists by that name. - * @throws InvalidArgumentException When the wrong target object type is passed to an association. - */ - private function set($field, $args) - { - if ($this->cm->hasField($field) && ! $this->cm->isIdentifier($field)) { - $this->$field = $args[0]; - } elseif ($this->cm->hasAssociation($field) && $this->cm->isSingleValuedAssociation($field)) { - $targetClass = $this->cm->getAssociationTargetClass($field); - if (! ($args[0] instanceof $targetClass) && $args[0] !== null) { - throw new InvalidArgumentException("Expected persistent object of type '" . $targetClass . "'"); - } - - $this->$field = $args[0]; - $this->completeOwningSide($field, $targetClass, $args[0]); - } else { - throw new BadMethodCallException("no field with name '" . $field . "' exists on '" . $this->cm->getName() . "'"); - } - } - - /** - * Gets a persistent field value. - * - * @param string $field - * - * @return mixed - * - * @throws BadMethodCallException When no persistent field exists by that name. - */ - private function get($field) - { - if ($this->cm->hasField($field) || $this->cm->hasAssociation($field)) { - return $this->$field; - } - - throw new BadMethodCallException("no field with name '" . $field . "' exists on '" . $this->cm->getName() . "'"); - } - - /** - * If this is an inverse side association, completes the owning side. - * - * @param string $field - * @param ClassMetadata $targetClass - * @param object $targetObject - * - * @return void - */ - private function completeOwningSide($field, $targetClass, $targetObject) - { - // add this object on the owning side as well, for obvious infinite recursion - // reasons this is only done when called on the inverse side. - if (! $this->cm->isAssociationInverseSide($field)) { - return; - } - - $mappedByField = $this->cm->getAssociationMappedByTargetField($field); - $targetMetadata = self::$objectManager->getClassMetadata($targetClass); - - $setter = ($targetMetadata->isCollectionValuedAssociation($mappedByField) ? 'add' : 'set') . $mappedByField; - $targetObject->$setter($this); - } - - /** - * Adds an object to a collection. - * - * @param string $field - * @param mixed[] $args - * - * @return void - * - * @throws BadMethodCallException - * @throws InvalidArgumentException - */ - private function add($field, $args) - { - if (! $this->cm->hasAssociation($field) || ! $this->cm->isCollectionValuedAssociation($field)) { - throw new BadMethodCallException('There is no method add' . $field . '() on ' . $this->cm->getName()); - } - - $targetClass = $this->cm->getAssociationTargetClass($field); - if (! ($args[0] instanceof $targetClass)) { - throw new InvalidArgumentException("Expected persistent object of type '" . $targetClass . "'"); - } - - if (! ($this->$field instanceof Collection)) { - $this->$field = new ArrayCollection($this->$field ?: []); - } - - $this->$field->add($args[0]); - $this->completeOwningSide($field, $targetClass, $args[0]); - } - - /** - * Initializes Doctrine Metadata for this class. - * - * @return void - * - * @throws RuntimeException - */ - private function initializeDoctrine() - { - if ($this->cm !== null) { - return; - } - - if (! self::$objectManager) { - throw new RuntimeException('No runtime object manager set. Call PersistentObject#setObjectManager().'); - } - - $this->cm = self::$objectManager->getClassMetadata(static::class); - } - - /** - * Magic methods. - * - * @param string $method - * @param mixed[] $args - * - * @return mixed - * - * @throws BadMethodCallException - */ - public function __call($method, $args) - { - $this->initializeDoctrine(); - - $command = substr($method, 0, 3); - $field = lcfirst(substr($method, 3)); - if ($command === 'set') { - $this->set($field, $args); - } elseif ($command === 'get') { - return $this->get($field); - } elseif ($command === 'add') { - $this->add($field, $args); - } else { - throw new BadMethodCallException('There is no method ' . $method . ' on ' . $this->cm->getName()); - } - } -} |