Dictionary.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\MetaData\Structure\Dictionaries;
 
use ILIAS\MetaData\Elements\Base\BaseElementInterface;
use ILIAS\MetaData\Structure\Dictionaries\Tags\TagInterface;
use ILIAS\MetaData\Paths\FactoryInterface as PathFactoryInterface;
use ILIAS\MetaData\Elements\Structure\StructureElementInterface;
use ILIAS\MetaData\Structure\Dictionaries\Tags\TagAssignmentInterface;
use ILIAS\MetaData\Paths\PathInterface;
use ILIAS\MetaData\Paths\Navigator\NavigatorFactoryInterface;
use ILIAS\MetaData\Elements\ElementInterface;
 
abstract class Dictionary
{
    protected PathFactoryInterface $path_factory;
    protected NavigatorFactoryInterface $navigator_factory;
 
    private array $tag_assignments = [];
 
    public function __construct(
        PathFactoryInterface $path_factory,
        NavigatorFactoryInterface $navigator_factory,
        TagAssignmentInterface ...$tag_assignments
    ) {
        $this->path_factory = $path_factory;
        $this->navigator_factory = $navigator_factory;
        foreach ($tag_assignments as $tag_assignment) {
            $this->tag_assignments[$tag_assignment->path()->toString()][] = $tag_assignment->tag();
        }
    }
 
    public function tagsForElement(
        BaseElementInterface $element
    ): \Generator {
        $path = $this->path_factory->toElement($element);
        foreach ($this->getAllTagsForElement($path) as $tag) {
            if (!$this->doesIndexMatch($path, $element, $tag)) {
                continue;
            }
            yield $tag;
        }
    }
 
    protected function getAllTagsForElement(
        PathInterface $path
    ): \Generator {
        yield from $this->tag_assignments[$path->toString()] ?? [];
    }
 
    protected function doesIndexMatch(
        PathInterface $path,
        BaseElementInterface $element,
        TagInterface $tag
    ): bool {
        if (!($element instanceof ElementInterface)) {
            return true;
        }
        if (!$tag->isRestrictedToIndices()) {
            return true;
        }
        $index = $this->findIndexOfElement($path, $element);
        if (in_array($index, iterator_to_array($tag->indices()), true)) {
            return true;
        }
        return false;
    }
 
    protected function findIndexOfElement(
        PathInterface $path,
        ElementInterface $element
    ): int {
        $name = $element->getDefinition()->name();
        $navigator = $this->navigator_factory->navigator($path, $element);
        $index = 0;
        foreach ($navigator->elementsAtFinalStep() as $sibling_element) {
            if ($sibling_element === $element) {
                return $index;
            }
            $index++;
        }
        throw new \ilMDStructureException('Invalid metadata set');
    }
}