*/ class LazyObjectStorage extends ObjectStorage implements LoadingStrategyInterface { /** * This field is only needed to make debugging easier: * * If you call current() on a class that implements Iterator, PHP will return the first field of the object * instead of calling the current() method of the interface. * * We use this unusual behavior of PHP to return the warning below in this case. */ private string $warning = 'You should never see this warning. If you do, you probably used PHP array functions like current() on the TYPO3\\CMS\\Extbase\\Persistence\\Generic\\LazyObjectStorage. To retrieve the first result, you can use the rewind() and current() methods.'; protected DataMapper $dataMapper; /** * The object this property is contained in. */ protected DomainObjectInterface $parentObject; /** * The name of the property represented by this proxy. */ protected string $propertyName; /** * The raw field value. */ protected mixed $fieldValue; protected bool $isInitialized = false; public function isInitialized(): bool { return $this->isInitialized; } /** * @param TEntity $parentObject The object instance this proxy is part of * @param string $propertyName The name of the proxied property in its parent * @param mixed $fieldValue The raw field value. */ public function __construct(object $parentObject, string $propertyName, mixed $fieldValue, ?DataMapper $dataMapper = null) { $this->parentObject = $parentObject; $this->propertyName = $propertyName; $this->fieldValue = $fieldValue; reset($this->storage); if ($dataMapper === null) { $dataMapper = GeneralUtility::makeInstance(DataMapper::class); } $this->dataMapper = $dataMapper; } /** * Lazily initializes the object storage. */ protected function initialize(): void { if ($this->isInitialized) { return; } $this->isInitialized = true; $objects = $this->dataMapper->fetchRelated($this->parentObject, $this->propertyName, $this->fieldValue, false); foreach ($objects as $object) { parent::attach($object); } $this->_memorizeCleanState(); if (!$this->isStorageAlreadyMemorizedInParentCleanState()) { $this->parentObject->_memorizeCleanState($this->propertyName); } } protected function isStorageAlreadyMemorizedInParentCleanState(): bool { return $this->parentObject->_getCleanProperty($this->propertyName) === $this; } // Delegation to the ObjectStorage methods below /** * @see `ObjectStorage::addAll` */ public function addAll(ObjectStorage $storage): void { $this->initialize(); parent::addAll($storage); } /** * @param TEntity $object The object to add. * @param mixed $information The information to associate with the object. * * @see `ObjectStorage::attach` */ public function attach(object $object, mixed $information = null): void { $this->initialize(); parent::attach($object, $information); } /** * @param TEntity $object The object to look for. * * @see `ObjectStorage::contains` */ public function contains(object $object): bool { $this->initialize(); return parent::contains($object); } /** * Counts the elements in the storage array * * @throws Exception * @return 0|positive-int The number of objects in the storage. */ public function count(): int { $columnMap = $this->dataMapper->getDataMap(get_class($this->parentObject))->getColumnMap($this->propertyName); if (!$this->isInitialized && $columnMap->getTypeOfRelation() === Relation::HAS_MANY) { $numberOfElements = $this->dataMapper->countRelated($this->parentObject, $this->propertyName, $this->fieldValue); } else { $this->initialize(); $numberOfElements = count($this->storage); } return $numberOfElements; } /** * @return TEntity|null The object at the current iterator position. * @see `ObjectStorage::current` */ public function current(): ?object { $this->initialize(); return parent::current(); } /** * @param TEntity $object The object to remove. * * @see `ObjectStorage::detach` */ public function detach(object $object): void { $this->initialize(); parent::detach($object); } /** * @return string The index corresponding to the position of the iterator. * * @see `ObjectStorage::key` */ public function key(): string { $this->initialize(); return parent::key(); } /** * @see `ObjectStorage::next` */ public function next(): void { $this->initialize(); parent::next(); } /** * @param TEntity|int|string $value The object to look for, or the key in the storage. * * @see `ObjectStorage::offsetExists` */ public function offsetExists(mixed $value): bool { $this->initialize(); return parent::offsetExists($value); } /** * @param TEntity|int|string $value The object to look for, or its key in the storage. * * @see `ObjectStorage::offsetGet` */ public function offsetGet(mixed $value): mixed { $this->initialize(); return parent::offsetGet($value); } /** * @param TEntity|string|null $object The object to add. * @param mixed $information The information to associate with the object. * * @see `ObjectStorage::offsetSet` */ public function offsetSet(mixed $object, mixed $information): void { $this->initialize(); parent::offsetSet($object, $information); } /** * @param TEntity|int|string $value The object to remove, or its key in the storage. * * @see `ObjectStorage::offsetUnset` */ public function offsetUnset(mixed $value): void { $this->initialize(); parent::offsetUnset($value); } /** * @param ObjectStorage $storage The storage containing the elements to remove. * * @see `ObjectStorage::removeAll` */ public function removeAll(ObjectStorage $storage): void { $this->initialize(); parent::removeAll($storage); } /** * @see `ObjectStorage::rewind` */ public function rewind(): void { $this->initialize(); parent::rewind(); } /** * @see `ObjectStorage::valid` */ public function valid(): bool { $this->initialize(); return parent::valid(); } /** * @see `ObjectStorage::toArray` */ public function toArray(): array { $this->initialize(); return parent::toArray(); } /** * @param mixed $object */ public function getPosition($object): ?int { $this->initialize(); return parent::getPosition($object); } public function __serialize(): array { $properties = get_object_vars($this); unset( $properties['warning'], $properties['dataMapper'] ); return $properties; } public function __unserialize(array $data): void { foreach ($data as $propertyName => $propertyValue) { if (property_exists($this, $propertyName)) { $this->{$propertyName} = $propertyValue; } } $this->dataMapper = GeneralUtility::getContainer()->get(DataMapper::class); } }