. */ declare(strict_types=1); /** * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony). * * Copyright (C) 2019 Jan Böhmer (https://github.com/jbtronics) * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ namespace App\Services\Trees; use App\Entity\Base\AbstractDBElement; use App\Entity\Base\AbstractNamedDBElement; use App\Entity\Base\AbstractStructuralDBElement; use App\Helpers\Trees\TreeViewNode; use App\Helpers\Trees\TreeViewNodeIterator; use App\Repository\StructuralDBElementRepository; use App\Services\EntityURLGenerator; use App\Services\UserCacheKeyGenerator; use Doctrine\ORM\EntityManagerInterface; use Symfony\Contracts\Cache\ItemInterface; use Symfony\Contracts\Cache\TagAwareCacheInterface; use Symfony\Contracts\Translation\TranslatorInterface; class TreeViewGenerator { protected $urlGenerator; protected $em; protected $cache; protected $keyGenerator; protected $translator; public function __construct(EntityURLGenerator $URLGenerator, EntityManagerInterface $em, TagAwareCacheInterface $treeCache, UserCacheKeyGenerator $keyGenerator, TranslatorInterface $translator) { $this->urlGenerator = $URLGenerator; $this->em = $em; $this->cache = $treeCache; $this->keyGenerator = $keyGenerator; $this->translator = $translator; } /** * Gets a TreeView list for the entities of the given class. * * @param string $class The class for which the treeView should be generated * @param AbstractStructuralDBElement|null $parent The root nodes in the tree should have this element as parent (use null, if you want to get all entities) * @param string $href_type The link type that will be generated for the hyperlink section of each node (see EntityURLGenerator for possible values). * Set to empty string, to disable href field. * @param AbstractDBElement|null $selectedElement The element that should be selected. If set to null, no element will be selected. * * @return TreeViewNode[] An array of TreeViewNode[] elements of the root elements. */ public function getTreeView(string $class, ?AbstractStructuralDBElement $parent = null, string $href_type = 'list_parts', ?AbstractDBElement $selectedElement = null): array { $head = []; //When we use the newEdit type, add the New Element node. if ('newEdit' === $href_type) { //Generate the url for the new node $href = $this->urlGenerator->createURL(new $class()); $new_node = new TreeViewNode($this->translator->trans('entity.tree.new'), $href); //When the id of the selected element is null, then we have a new element, and we need to select "new" node if (null === $selectedElement || null === $selectedElement->getID()) { $new_node->setSelected(true); } $head[] = $new_node; //Add spacing $head[] = (new TreeViewNode(''))->setDisabled(true); //Every other treeNode will be used for edit $href_type = 'edit'; } $generic = $this->getGenericTree($class, $parent); $treeIterator = new TreeViewNodeIterator($generic); $recursiveIterator = new \RecursiveIteratorIterator($treeIterator, \RecursiveIteratorIterator::SELF_FIRST); foreach ($recursiveIterator as $item) { /** @var TreeViewNode $item */ if (null !== $selectedElement && $item->getId() === $selectedElement->getID()) { $item->setSelected(true); } if (! empty($item->getNodes())) { $item->addTag((string) \count($item->getNodes())); } if (! empty($href_type) && null !== $item->getId()) { $entity = $this->em->getPartialReference($class, $item->getId()); $item->setHref($this->urlGenerator->getURL($entity, $href_type)); } //Translate text if text starts with $$ if ('$$' === substr($item->getText(), 0, 2)) { $item->setText($this->translator->trans(substr($item->getText(), 2))); } } return array_merge($head, $generic); } /** * /** * Gets a tree of TreeViewNode elements. The root elements has $parent as parent. * The treeview is generic, that means the href are null and ID values are set. * * @param string $class The class for which the tree should be generated * @param AbstractStructuralDBElement|null $parent The parent the root elements should have. * * @return TreeViewNode[] */ public function getGenericTree(string $class, ?AbstractStructuralDBElement $parent = null): array { if (! is_a($class, AbstractNamedDBElement::class, true)) { throw new \InvalidArgumentException('$class must be a class string that implements StructuralDBElement or NamedDBElement!'); } if (null !== $parent && ! is_a($parent, $class)) { throw new \InvalidArgumentException('$parent must be of the type $class!'); } /** @var StructuralDBElementRepository $repo */ $repo = $this->em->getRepository($class); //If we just want a part of a tree, dont cache it if (null !== $parent) { return $repo->getGenericNodeTree($parent); } $secure_class_name = str_replace('\\', '_', $class); $key = 'treeview_'.$this->keyGenerator->generateKey().'_'.$secure_class_name; return $this->cache->get($key, function (ItemInterface $item) use ($repo, $parent, $secure_class_name) { // Invalidate when groups, a element with the class or the user changes $item->tag(['groups', 'tree_treeview', $this->keyGenerator->generateKey(), $secure_class_name]); return $repo->getGenericNodeTree($parent); }); } }