ApacheSolrForTypo3\Solr\IndexQueue\Item

Complexity

Total Complexity

44

Size/Duplication

Total Lines	442
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	2

Test Coverage

Coverage

66.25%

Importance

Changes

0

28 Methods

Rating	Name	Duplication	Size	Complexity
A	getIndexQueueUid()	0	4	1
A	setType()	0	4	1
A	__construct()	0	18	3
A	getRootPageUid()	0	4	1
A	setRootPageUid()	0	4	1
A	getErrors()	0	4	1
A	getSite()	0	4	1
A	getType()	0	4	1
A	getIndexingConfigurationName()	0	4	1
A	setIndexingConfigurationName()	0	4	1
A	getChanged()	0	4	1
A	setChanged()	0	4	1
A	updateIndexedTime()	0	8	1
A	getRecordUid()	0	6	1
A	getRecord()	0	14	2
A	setRecord()	0	4	1
A	getRecordPageId()	0	6	1
A	storeIndexingProperties()	0	10	2
A	removeIndexingProperties()	0	15	2
A	hasIndexingProperties()	0	4	1
B	writeIndexingProperties()	0	25	3
A	updateHasIndexingPropertiesFlag()	0	20	3
A	hasIndexingProperty()	0	6	1
A	loadIndexingProperties()	0	18	4
A	setIndexingProperty()	0	20	4
A	getIndexingProperty()	0	13	2
A	getIndexingProperties()	0	6	1
A	getIndexingPropertyKeys()	0	6	1

<?php
namespace ApacheSolrForTypo3\Solr\IndexQueue;

/***************************************************************
 *  Copyright notice
 *
 *  (c) 2009-2015 Ingo Renner <ingo@typo3.org>
 *  All rights reserved
 *
 *  This script is part of the TYPO3 project. The TYPO3 project 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.
 *
 *  The GNU General Public License can be found at
 *  http://www.gnu.org/copyleft/gpl.html.
 *
 *  This script 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.
 *
 *  This copyright notice MUST APPEAR in all copies of the script!
 ***************************************************************/

use ApacheSolrForTypo3\Solr\Site;
use TYPO3\CMS\Backend\Utility\BackendUtility;
use TYPO3\CMS\Core\Utility\GeneralUtility;

/**
 * Representation of an index queue item, carrying meta data and the record to be
 * indexed.
 *
 * @author Ingo Renner <ingo@typo3.org>
 */
class Item
{

    /**
     * The item's uid in the index queue (tx_solr_indexqueue_item.uid)
     *
     * @var int
     */
    protected $indexQueueUid;

    /**
     * The root page uid of the tree the item is located in (tx_solr_indexqueue_item.root)
     *
     * @var int
     */
    protected $rootPageUid;

    /**
     * The record's type, usually a table name, but could also be a file type (tx_solr_indexqueue_item.item_type)
     *
     * @var string
     */
    protected $type;

    /**
     * The name of the indexing configuration that should be used when indexing (tx_solr_indexqueue_item.indexing_configuration)
     * the item.
     *
     * @var string
     */
    protected $indexingConfigurationName;

    /**
     * The unix timestamp when the record was last changed (tx_solr_indexqueue_item.changed)
     *
     * @var int
     */
    protected $changed;

    /**
     * Indexing properties to provide additional information for the item's
     * indexer / how to index the item.
     *
     * @var array
     */
    protected $indexingProperties = [];

    /**
     * Flag for lazy loading indexing properties.
     *
     * @var bool
     */
    protected $indexingPropertiesLoaded = false;

    /**
     * Flag, whether indexing properties exits for this item.
     *
     * @var bool
     */
    protected $hasIndexingProperties = false;

    /**
     * The record's uid.
     *
     * @var int
     */
    protected $recordUid = 0;

    /**
     * The record itself
     *
     * @var array
     */
    protected $record;

    /**
     * @var string
     */
    protected $errors = '';

    /**
     * Constructor, takes item meta data information and resolves that to the full record.
     *
     * @param array $itemMetaData Metadata describing the item to index using the index queue. Is expected to contain a record from table tx_solr_indexqueue_item
     * @param array $fullRecord Optional full record for the item. If provided, can save some SQL queries.
     */
    public function __construct(
        array $itemMetaData,
        array $fullRecord = []
    ) {
        $this->indexQueueUid = $itemMetaData['uid'];
        $this->rootPageUid = $itemMetaData['root'];
        $this->type = $itemMetaData['item_type'];
        $this->recordUid = $itemMetaData['item_uid'];
        $this->changed = $itemMetaData['changed'];
        $this->errors = (string) empty($itemMetaData['errors']) ? '' : $itemMetaData['errors'];

        $this->indexingConfigurationName = $itemMetaData['indexing_configuration'];
        $this->hasIndexingProperties = (boolean)$itemMetaData['has_indexing_properties'];

        if (!empty($fullRecord)) {
            $this->record = $fullRecord;
        }
    }

    /**
     * @return int|mixed
     */
    public function getIndexQueueUid()
    {
        return $this->indexQueueUid;
    }

    /**
     * Gets the item's root page ID (uid)
     *
     * @return int root page ID
     */
    public function getRootPageUid()
    {
        return $this->rootPageUid;
    }

    /**
     * @param integer $uid
     */
    public function setRootPageUid($uid)
    {
        $this->rootPageUid = intval($uid);
    }

    /**
     * @return string
     */
    public function getErrors()
    {
        return $this->errors;
    }

    /**
     * Gets the site the item belongs to.
     *
     * @return Site Site instance the item belongs to.
     */
    public function getSite()
    {
        return GeneralUtility::makeInstance(Site::class, $this->rootPageUid);
    }

    public function getType()
    {
        return $this->type;
    }

    public function setType($type)
    {
        $this->type = $type;
    }

    public function getIndexingConfigurationName()
    {
        return $this->indexingConfigurationName;
    }

    public function setIndexingConfigurationName($indexingConfigurationName)
    {
        $this->indexingConfigurationName = $indexingConfigurationName;
    }

    public function getChanged()
    {
        return $this->changed;
    }

    public function setChanged($changed)
    {
        $this->changed = intval($changed);
    }

    /**
     * Sets the timestamp of when an item has been indexed.
     *
     * @return void
     */
    public function updateIndexedTime()
    {
        $GLOBALS['TYPO3_DB']->exec_UPDATEquery(
            'tx_solr_indexqueue_item',
            'uid = ' . (int)$this->indexQueueUid,
            ['indexed' => time()]
        );
    }

    public function getRecordUid()
    {
        $this->getRecord();

        return $this->record['uid'];
    }

    /**
     * Gets the item's full record.
     *
     * Uses lazy loading.
     *
     * @return array The item's DB record.
     */
    public function getRecord()
    {
        if (empty($this->record)) {
            $this->record = (array)BackendUtility::getRecord(
                $this->type,
                $this->recordUid,
                '*',
                '',
                false
            );
        }

        return $this->record;
    }

    public function setRecord(array $record)
    {
        $this->record = $record;
    }

    /**
     * @return int
     */
    public function getRecordPageId()
    {
        $this->getRecord();

        return $this->record['pid'];
    }

    /**
     * Stores the indexing properties.
     *
     */
    public function storeIndexingProperties()
    {
        $this->removeIndexingProperties();

        if ($this->hasIndexingProperties()) {
            $this->writeIndexingProperties();
        }

        $this->updateHasIndexingPropertiesFlag();
    }

    /**
     * Removes existing indexing properties.
     *
     * @throws \RuntimeException when an SQL error occurs
     */
    protected function removeIndexingProperties()
    {
        $GLOBALS['TYPO3_DB']->exec_DELETEquery(
            'tx_solr_indexqueue_indexing_property',
            'root = ' . intval($this->rootPageUid)
            . ' AND item_id = ' . intval($this->indexQueueUid)
        );

        if ($GLOBALS['TYPO3_DB']->sql_error()) {
            throw new \RuntimeException(
                'Could not remove indexing properties for item ' . $this->indexQueueUid,
                1323802532
            );
        }
    }

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

    /**
     * Writes all indexing properties.
     *
     * @throws \RuntimeException when an SQL error occurs
     */
    protected function writeIndexingProperties()
    {
        $properties = [];
        foreach ($this->indexingProperties as $propertyKey => $propertyValue) {
            $properties[] = [
                $this->rootPageUid,
                $this->indexQueueUid,
                $propertyKey,
                $propertyValue
            ];
        }

        $GLOBALS['TYPO3_DB']->exec_INSERTmultipleRows(
            'tx_solr_indexqueue_indexing_property',
            ['root', 'item_id', 'property_key', 'property_value'],
            $properties
        );

        if ($GLOBALS['TYPO3_DB']->sql_error()) {
            throw new \RuntimeException(
                'Could not insert indexing properties for item ' . $this->indexQueueUid,
                1323802570
            );
        }
    }

    /**
     * Updates the "has_indexing_properties" flag in the Index Queue.
     *
     * @throws \RuntimeException when an SQL error occurs
     */
    protected function updateHasIndexingPropertiesFlag()
    {
        $hasIndexingProperties = '0';
        if ($this->hasIndexingProperties()) {
            $hasIndexingProperties = '1';
        }

        $GLOBALS['TYPO3_DB']->exec_UPDATEquery(
            'tx_solr_indexqueue_item',
            'uid = ' . intval($this->indexQueueUid),
            ['has_indexing_properties' => $hasIndexingProperties]
        );

        if ($GLOBALS['TYPO3_DB']->sql_error()) {
            throw new \RuntimeException(
                'Could not update has_indexing_properties flag in Index Queue for item ' . $this->indexQueueUid,
                1323802610
            );
        }
    }

    /**
     * @param string $key
     * @return bool
     */
    public function hasIndexingProperty($key)
    {
        $this->loadIndexingProperties();

        return array_key_exists($key, $this->indexingProperties);
    }

    /**
     * Loads the indexing properties for the item - if not already loaded.
     *
     */
    public function loadIndexingProperties()
    {
        if (!$this->indexingPropertiesLoaded) {
            $indexingProperties = $GLOBALS['TYPO3_DB']->exec_SELECTgetRows(
                'property_key, property_value',
                'tx_solr_indexqueue_indexing_property',
                'item_id = ' . intval($this->indexQueueUid)
            );

            if (!empty($indexingProperties)) {
                foreach ($indexingProperties as $indexingProperty) {
                    $this->indexingProperties[$indexingProperty['property_key']] = $indexingProperty['property_value'];
                }
            }

            $this->indexingPropertiesLoaded = true;
        }
    }

    /**
     * Sets an indexing property for the item.
     *
     * @param string $key Indexing property name
     * @param string|int|float $value Indexing property value
     * @throws \InvalidArgumentException when $value is not string, integer or float
     */
    public function setIndexingProperty($key, $value)
    {

        // make sure to not interfere with existing indexing properties
        $this->loadIndexingProperties();

        $key = (string)$key; // Scalar typehints now!

        if (!is_string($value) && !is_int($value) && !is_float($value)) {
            throw new \InvalidArgumentException(
                'Cannot set indexing property "' . $key
                . '", its value must be string, integer or float, '
                . 'type given was "' . gettype($value) . '"',
                1323173209
            );
        }

        $this->indexingProperties[$key] = $value;
        $this->hasIndexingProperties = true;
    }

    /**
     * Gets a specific indexing property by its name/key.
     *
     * @param string $key Indexing property name/key.
     * @throws \InvalidArgumentException when the given $key does not exist.
     * @return string
     */
    public function getIndexingProperty($key)
    {
        $this->loadIndexingProperties();

        if (!array_key_exists($key, $this->indexingProperties)) {
            throw new \InvalidArgumentException(
                'No indexing property "' . $key . '".',
                1323174143
            );
        }

        return $this->indexingProperties[$key];
    }

    /**
     * Gets all indexing properties set for this item.
     *
     * @return array Array of indexing properties.
     */
    public function getIndexingProperties()
    {
        $this->loadIndexingProperties();

        return $this->indexingProperties;
    }

    /**
     * Gets the names/keys of the item's indexing properties.
     *
     * @return array Array of indexing property names/keys
     */
    public function getIndexingPropertyKeys()
    {
        $this->loadIndexingProperties();

        return array_keys($this->indexingProperties);
    }
}