Firesphere\SolrSearch\Factories\DocumentFactory

Complexity

Total Complexity

28

Size/Duplication

Total Lines	254
Duplicated Lines	0 %

Test Coverage

Coverage

98.67%

Importance

Changes	26
Bugs	3	Features	0

13 Methods

Rating	Name	Duplication	Size	Complexity
A	isDebug()	0	3	1
A	__construct()	0	3	1
A	setDebug()	0	5	1
A	addToDoc()	0	10	3
A	buildItems()	0	14	4
A	buildFieldData()	0	14	3
A	buildFields()	0	5	2
A	classIs()	0	11	4
A	addToBuffer()	0	12	1
A	addDefaultFields()	0	7	1
A	addField()	0	15	3
A	getValuesForField()	0	9	2
A	classEquals()	0	3	2

<?php


namespace Firesphere\SolrSearch\Factories;

use Exception;
use Firesphere\SolrSearch\Extensions\DataObjectExtension;
use Firesphere\SolrSearch\Helpers\DataResolver;
use Firesphere\SolrSearch\Helpers\FieldResolver;
use Firesphere\SolrSearch\Helpers\Statics;
use Firesphere\SolrSearch\Indexes\BaseIndex;
use Firesphere\SolrSearch\Services\SolrCoreService;
use Firesphere\SolrSearch\Traits\DocumentFactoryTrait;
use Firesphere\SolrSearch\Traits\LoggerTrait;
use SilverStripe\Core\ClassInfo;
use SilverStripe\Core\Config\Configurable;
use SilverStripe\Core\Extensible;
use SilverStripe\Core\Injector\Injector;
use SilverStripe\ORM\DataObject;
use SilverStripe\ORM\FieldType\DBDate;
use SilverStripe\ORM\FieldType\DBField;
use Solarium\Plugin\BufferedAdd\BufferedAdd;
use Solarium\QueryType\Update\Query\Document;
use Solarium\QueryType\Update\Query\Query;

/**
 * Class DocumentFactory
 * Factory to create documents to be pushed to Solr
 *
 * @package Firesphere\SolrSearch\Factories
 */
class DocumentFactory
{
    use Configurable;
    use Extensible;
    use DocumentFactoryTrait;
    use LoggerTrait;

    /**
     * Numeral types in Solr
     *
     * @var array
     */
    protected static $numerals = [
        'tint',
        'tfloat',
        'tdouble',
    ];
    /**
     * Debug this build
     *
     * @var bool
     */
    protected $debug = false;

    /**
     * DocumentFactory constructor, sets up the field resolver
     */
    public function __construct()
    {
        $this->fieldResolver = Injector::inst()->get(FieldResolver::class);
    }

    /**
     * Note, it can only take one type of class at a time!
     * So make sure you properly loop and set $class
     *
     * @param array $fields
     * @param BaseIndex $index
     * @param Query $update
     * @param BufferedAdd $bufferAdd
     * @throws Exception
     */
    public function buildItems($fields, $index, $update, $bufferAdd): void
    {
        $this->getFieldResolver()->setIndex($index);
        $boostFields = $index->getBoostedFields();
        $passes = [
            'update' => $update,
            'buffer' => $bufferAdd,
        ];
        foreach ($this->getItems() as $item) {
            // Hard check against it being 0, if it's null, we should add the item
            if ($item->ShowInSearch === 0 || $item->ShowInSearch === false) {
                continue;
            }
            $this->addToBuffer($fields, $passes, $item, $boostFields);
        }
    }

    /**
     * Add fields that should always be included
     *
     * @param Document $doc
     * @param DataObject|DataObjectExtension $item
     */
    protected function addDefaultFields(Document $doc, DataObject $item)
    {
        $doc->setKey(SolrCoreService::ID_FIELD, $item->ClassName . '-' . $item->ID);
        $doc->addField(SolrCoreService::CLASS_ID_FIELD, $item->ID);
        $doc->addField('ClassName', $item->ClassName);
        $doc->addField('ClassHierarchy', ClassInfo::ancestry($item));
        $doc->addField('ViewStatus', $item->getViewStatus());
    }

    /**
     * Create the required record for a field
     *
     * @param $fields
     * @param Document $doc
     * @param DataObject $item
     * @param array $boostFields
     * @throws Exception
     */
    protected function buildFields($fields, Document $doc, DataObject $item, array $boostFields): void
    {
        foreach ($fields as $field) {
            $fieldData = $this->getFieldResolver()->resolveField($field);
            $this->buildFieldData($doc, $item, $boostFields, $fieldData, $field);
        }
    }

    /**
     * Determine if the given object is one of the given type
     *
     * @param string|DataObject $class
     * @param array|string $base Class or list of base classes
     * @return bool
     * @todo remove in favour of the inheritance check from PHP
     */
    protected function classIs($class, $base): bool
    {
        $base = is_array($base) ? $base : [$base];

        foreach ($base as $nextBase) {
            if ($this->classEquals($class, $nextBase)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Check if a base class is an instance of the expected base group
     *
     * @param string|DataObject $class
     * @param string $base
     * @return bool
     */
    protected function classEquals($class, $base): bool
    {
        return $class === $base || ($class instanceof $base);
    }

    /**
     * Add a single field to the Solr index
     *
     * @param Document $doc
     * @param DataObject $object
     * @param array $options
     */
    protected function addField($doc, $object, $options): void
    {
        $this->extend('onBeforeAddField', $options);

        $valuesForField = $this->getValuesForField($object, $options);

        $typeMap = Statics::getTypeMap();
        $type = $typeMap[$options['type']] ?? $typeMap['*'];

        foreach ($valuesForField as $value) {
            if ($value === null) {
                continue;
            }
            $this->extend('onBeforeAddDoc', $options, $value);
            $this->addToDoc($doc, $options, $type, $value);
        }
    }

    /**
     * Use the DataResolver to find the value(s) for a field.
     * Returns an array of values, and if it's multiple, it becomes a long array
     *
     * @param $object
     * @param $options
     * @return array
     */
    protected function getValuesForField($object, $options): array
    {
        try {
            $valuesForField = [DataResolver::identify($object, $options['fullfield'])];
        } catch (Exception $e) {
            $valuesForField = [];
        }

        return $valuesForField;
    }

    /**
     * Push field to a document
     *
     * @param Document $doc
     * @param array $options
     * @param string $type
     * @param DBField|string $value
     */
    protected function addToDoc($doc, $options, $type, $value): void
    {
        /* Solr requires dates in the form 1995-12-31T23:59:59Z, so we need to normalize to GMT */
        if ($type === 'tdate' || $value instanceof DBDate) {
            $value = gmdate('Y-m-d\TH:i:s\Z', strtotime($value));
        }

        $name = getShortFieldName($options['name']);

        $doc->addField($name, $value, $options['boost'], Document::MODIFIER_SET);
    }

    /**
     * Are we debugging?
     *
     * @return bool
     */
    public function isDebug(): bool
    {
        return $this->debug;
    }

    /**
     * Set to true if debugging should be enabled
     *
     * @param bool $debug
     * @return DocumentFactory
     */
    public function setDebug(bool $debug): DocumentFactory
    {
        $this->debug = $debug;

        return $this;
    }

    /**
     * @param Document $doc
     * @param DataObject $item
     * @param array $boostFields
     * @param array $fieldData
     * @param $field
     */
    protected function buildFieldData(
        Document $doc,
        DataObject $item,
        array $boostFields,
        array $fieldData,
        $field
    ): void {
        foreach ($fieldData as $dataField => $options) {
            if (!$this->classIs($item, $options['origin'])) {
                continue;
            }

            $options['boost'] = $boostFields[$field] ?? null;
            $this->addField($doc, $item, $options);
        }
    }

    /**
     * @param array $fields
     * @param array|[Query|BufferedAdd] $passes

The doc comment array|[Query|BufferedAdd] at position 2 could not be parsed: Unknown type name '[' at position 2 in array|[Query|BufferedAdd].

     * @param DataObject $item
     * @param array $boostFields
     * @throws Exception
     */
    protected function addToBuffer(array $fields, array $passes, DataObject $item, array $boostFields): void
    {
        $update = $passes['update'];
        $bufferAdd = $passes['buffer'];
        /** @var Document $doc */
        $doc = $update->createDocument();
        $this->addDefaultFields($doc, $item);

        $this->buildFields($fields, $doc, $item, $boostFields);
        $item->destroy();

        $bufferAdd->addDocument($doc);
    }
}