ElementEntity.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Version\Dependency;

class ElementEntity {

    const REFERENCES_ChildOf = 'childOf';
    const REFERENCES_ParentOf = 'parentOf';
    const EVENT_Construct = 'TYPO3\\CMS\\Version\\Dependency\\ElementEntity::construct';
    const EVENT_CreateChildReference = 'TYPO3\\CMS\\Version\\Dependency\\ElementEntity::createChildReference';
    const EVENT_CreateParentReference = 'TYPO3\\CMS\\Version\\Dependency\\ElementEntity::createParentReference';
    const RESPONSE_Skip = 'TYPO3\\CMS\\Version\\Dependency\\ElementEntity->skip';

    protected $invalid = FALSE;

    protected $table;

    protected $id;

    protected $data;

    protected $record;

    protected $dependency;

    protected $children;

    protected $parents;

    protected $traversingParents = FALSE;

    protected $outerMostParent;

    protected $nestedChildren;

    public function __construct($table, $id, array $data = array(), \TYPO3\CMS\Version\Dependency\DependencyResolver $dependency) {
        $this->table = $table;
        $this->id = (int)$id;
        $this->data = $data;
        $this->dependency = $dependency;
        $this->dependency->executeEventCallback(self::EVENT_Construct, $this);
    }

    public function setInvalid($invalid) {
        $this->invalid = (bool)$invalid;
    }

    public function isInvalid() {
        return $this->invalid;
    }

    public function getTable() {
        return $this->table;
    }

    public function getId() {
        return $this->id;
    }

    public function setId($id) {
        $this->id = (int)$id;
    }

    public function getData() {
        return $this->data;
    }

    public function getDataValue($key) {
        $result = NULL;
        if ($this->hasDataValue($key)) {
            $result = $this->data[$key];
        }
        return $result;
    }

    public function setDataValue($key, $value) {
        $this->data[$key] = $value;
    }

    public function hasDataValue($key) {
        return isset($this->data[$key]);
    }

    public function __toString() {
        return self::getIdentifier($this->table, $this->id);
    }

    public function getDependency() {
        return $this->dependency;
    }

    public function getChildren() {
        if (!isset($this->children)) {
            $this->children = array();
            $where = 'tablename=' . $GLOBALS['TYPO3_DB']->fullQuoteStr($this->table, 'sys_refindex') . ' AND recuid='
                . $this->id . ' AND workspace=' . $this->dependency->getWorkspace();
            $rows = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows('*', 'sys_refindex', $where, '', 'sorting');
            if (is_array($rows)) {
                foreach ($rows as $row) {
                    if ($row['ref_table'] !== '_FILE' && $row['ref_table'] !== '_STRING') {
                        $arguments = array(
                            'table' => $row['ref_table'],
                            'id' => $row['ref_uid'],
                            'field' => $row['field'],
                            'scope' => self::REFERENCES_ChildOf
                        );

                        $callbackResponse = $this->dependency->executeEventCallback(self::EVENT_CreateChildReference, $this, $arguments);
                        if ($callbackResponse !== self::RESPONSE_Skip) {
                            $this->children[] = $this->getDependency()->getFactory()->getReferencedElement(
                                $row['ref_table'],
                                $row['ref_uid'],
                                $row['field'],
                                array(),
                                $this->getDependency()
                            );
                        }
                    }
                }
            }
        }
        return $this->children;
    }

    public function getParents() {
        if (!isset($this->parents)) {
            $this->parents = array();
            $where = 'ref_table=' . $GLOBALS['TYPO3_DB']->fullQuoteStr($this->table, 'sys_refindex')
                . ' AND deleted=0 AND ref_uid=' . $this->id . ' AND workspace=' . $this->dependency->getWorkspace();
            $rows = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows('*', 'sys_refindex', $where, '', 'sorting');
            if (is_array($rows)) {
                foreach ($rows as $row) {
                    $arguments = array('table' => $row['tablename'], 'id' => $row['recuid'], 'field' => $row['field'], 'scope' => self::REFERENCES_ParentOf);
                    $callbackResponse = $this->dependency->executeEventCallback(self::EVENT_CreateParentReference, $this, $arguments);
                    if ($callbackResponse !== self::RESPONSE_Skip) {
                        $this->parents[] = $this->getDependency()->getFactory()->getReferencedElement(
                            $row['tablename'],
                            $row['recuid'],
                            $row['field'],
                            array(),
                            $this->getDependency()
                        );
                    }
                }
            }
        }
        return $this->parents;
    }

    public function hasReferences() {
        return count($this->getChildren()) > 0 || count($this->getParents()) > 0;
    }

    public function getOuterMostParent() {
        if (!isset($this->outerMostParent)) {
            $parents = $this->getParents();
            if (count($parents) === 0) {
                $this->outerMostParent = $this;
            } else {
                $this->outerMostParent = FALSE;
                foreach ($parents as $parent) {
                    $outerMostParent = $parent->getElement()->getOuterMostParent();
                    if ($outerMostParent instanceof \TYPO3\CMS\Version\Dependency\ElementEntity) {
                        $this->outerMostParent = $outerMostParent;
                        break;
                    } elseif ($outerMostParent === FALSE) {
                        break;
                    }
                }
            }
        }
        return $this->outerMostParent;
    }

    public function getNestedChildren() {
        if (!isset($this->nestedChildren)) {
            $this->nestedChildren = array();
            $children = $this->getChildren();
            foreach ($children as $child) {
                $this->nestedChildren = array_merge($this->nestedChildren, array($child->getElement()->__toString() => $child->getElement()), $child->getElement()->getNestedChildren());
            }
        }
        return $this->nestedChildren;
    }

    static public function getIdentifier($table, $id) {
        return $table . ':' . $id;
    }

    public function getRecord() {
        if (empty($this->record['uid']) || (int)$this->record['uid'] !== $this->getId()) {
            $this->record = array();
            $row = $GLOBALS['TYPO3_DB']->exec_SELECTgetSingleRow('uid,pid,t3ver_wsid,t3ver_state,t3ver_oid', $this->getTable(), 'uid=' . $this->getId());
            if (is_array($row)) {
                $this->record = $row;
            }
        }
        return $this->record;
    }

}