summaryrefslogtreecommitdiff
path: root/vendor/doctrine/persistence/lib/Doctrine/Common
diff options
context:
space:
mode:
authorDevian <devianleong@gmail.com>2021-04-22 17:11:12 +0800
committerDevian <devianleong@gmail.com>2021-04-22 17:11:12 +0800
commitbf68fa166afb95d682007e7671c2b0692227bec5 (patch)
tree26091a1e5a821905b8bdba73fd1ddb95e12f887e /vendor/doctrine/persistence/lib/Doctrine/Common
parent745cf2431a71d0e6c5f08f8605839279b2f7496e (diff)
Initial
Diffstat (limited to 'vendor/doctrine/persistence/lib/Doctrine/Common')
-rw-r--r--vendor/doctrine/persistence/lib/Doctrine/Common/Persistence/PersistentObject.php238
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());
- }
- }
-}