Firesphere\SolrSearch\Traits\GetterSetterTrait

Complexity

Total Complexity

15

Size/Duplication

Total Lines	211
Duplicated Lines	0 %

Test Coverage

Coverage

96.67%

Importance

Changes	2
Bugs	0	Features	0

12 Methods

Rating	Name	Duplication	Size	Complexity
A	setClasses()	0	5	1
A	addClass()	0	8	2
A	getOrFacetFields()	0	3	1
A	setOrFacetFields()	0	5	1
A	getAndFacetFields()	0	3	1
A	getClasses()	0	3	1
A	addBoostedField()	0	9	3
A	getBoostedFields()	0	3	1
A	getFacetFields()	0	3	1
A	setBoostedFields()	0	5	1
A	setAndFacetFields()	0	3	1
A	setFacetFields()	0	5	1

<?php
/**
 * Trait GetterSetterTrait|Firesphere\SolrSearch\Traits\GetterSetterTrait Getters and setters that are duplicate among
 * classes like {@link \Firesphere\SolrSearch\Indexes\BaseIndex} and {@link \Firesphere\SolrSearch\Queries\BaseQuery}
 *
 * @package Firesphere\SolrSearch\Traits
 * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
 * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
 */

namespace Firesphere\SolrSearch\Traits;

use SilverStripe\Dev\Deprecation;

/**
 * Trait GetterSetterTrait for getting and setting data
 *
 * Getters and setters shared between the Index and Query
 *
 * @package Firesphere\SolrSearch\Traits
 */
trait GetterSetterTrait
{
    /**
     * @var array Classes to use
     */
    protected $class = [];

    /**
     * Sets boosting at _index_ time or _query_ time. Depending on the usage of this trait
     * [
     *     'FieldName' => 2,
     * ]
     *
     * @var array
     */
    protected $boostedFields = [];

    /**
     * Format:
     * SiteTree::class   => [
     *      'BaseClass' => SiteTree::class,
     *      'Field' => 'ChannelID',
     *      'Title' => 'Channel'
     * ],
     * Object::class   => [
     *      'BaseClass' => Object::class,
     *      'Field' => 'Relation.ID',
     *      'Title' => 'Relation'
     * ],
     *
     * The facets will be applied as a single "AND" query.
     * e.g. SiteTree_ChannelID:1 with Object_Relation_ID:5 will not be found,
     * if the facet filter requires the SiteTree_ChannelID to be 1 AND Object_Relation_ID to be 3 or 6
     *
     * @var array
     */
    protected $andFacetFields = [];

    /**
     * Format:
     * SiteTree::class   => [
     *      'BaseClass' => SiteTree::class,
     *      'Field' => 'ChannelID',
     *      'Title' => 'Channel'
     * ],
     * Object::class   => [
     *      'BaseClass' => Object::class,
     *      'Field' => 'Relation.ID',
     *      'Title' => 'Relation'
     * ],
     *
     * The facets will be applied as "OR" separated groups of filters. Compared to default
     * facets, that will combine all facets in to a single "AND" query.
     * e.g. SiteTree_ChannelID:1 with Object_Relation_ID:5 will be found,
     * if the facet filter requires the SiteTree_ChannelID to be 1 OR Object_Relation_ID to be 3 or 6
     *
     * @var array
     */
    protected $orFacetFields = [];

    /**
     * Set the classes
     *
     * @param array $class
     * @return $this
     */
    public function setClasses($class): self
    {
        $this->class = $class;

        return $this;
    }

    /**
     * Get classes
     *
     * @return array
     */
    public function getClasses(): array
    {
        return $this->class;
    }

    /**
     * Add a class to index or query
     * $options is not used anymore, added for backward compatibility
     *
     * @param $class
     * @param array $options unused
     * @return $this
     */
    public function addClass($class, $options = []): self
    {
        if (count($options)) {
            Deprecation::notice('5.0', 'Options are not used anymore');
        }
        $this->class[] = $class;

        return $this;
    }

    /**
     * Add a boosted field to be boosted at query time
     *
     * This method is out of place in a way, but it's a shared method
     * between Index and Query, thus needs to be here.
     *
     * @param string $field
     * @param array|int $options
     * @param int|null $boost
     * @return $this
     */
    public function addBoostedField($field, $options = [], $boost = null)
    {
        if ($boost === null && is_int($options)) {
            $boost = $options;
        }

        $this->boostedFields[$field] = $boost;

        return $this;
    }

    /**
     * Get the boosted fields
     *
     * @return array
     */
    public function getBoostedFields(): array
    {
        return $this->boostedFields;
    }

    /**
     * Boosted fields are used at index time, not at query time
     *
     * @param array $boostedFields
     * @return $this
     */
    public function setBoostedFields($boostedFields): self
    {
        $this->boostedFields = $boostedFields;

        return $this;
    }

    /**
     * Stub for transitioning from standard Facets to AND/OR differentiated facets
     *
     * @return array
     */
    public function getAndFacetFields(): array
    {
        return $this->getFacetFields();
    }

    /**
     * Stub for transitioning from standard Facets to AND/OR differentiated facets
     *
     * @param array $facetFields
     * @return $this
     */
    public function setAndFacetFields($facetFields): self
    {
        return $this->setFacetFields($facetFields);
    }

    /**
     * Get the facet fields
     *
     * @return array
     */
    public function getFacetFields(): array
    {
        return $this->andFacetFields;
    }

    /**
     * Set the facet fields
     *
     * @param array $facetFields
     * @return $this
     */
    public function setFacetFields($facetFields): self
    {
        $this->andFacetFields = $facetFields;

        return $this;
    }

    /**
     * Get the OR separated facets
     *
     * @return array
     */
    public function getOrFacetFields(): array
    {
        return $this->orFacetFields;
    }

    /**
     * Add a set of OR facets
     *
     * @param array $orFacetFields
     * @return GetterSetterTrait
     */
    public function setOrFacetFields(array $orFacetFields): self
    {
        $this->orFacetFields = $orFacetFields;

        return $this;
    }
}