Soluble\FlexStore\Column\Column

Complexity

Total Complexity

45

Size/Duplication

Total Lines	410
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

97.12%

Importance

Changes

0

32 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	14	4
A	initDefaults()	0	9	3
A	getName()	0	4	1
A	setType()	0	11	3
A	getType()	0	4	1
A	setFormatter()	0	6	1
A	getFormatter()	0	4	1
A	setVirtual()	0	6	1
A	isVirtual()	0	4	1
A	setExcluded()	0	6	1
A	isExcluded()	0	4	1
A	setEditable()	0	6	1
A	isEditable()	0	4	1
A	setHidden()	0	6	1
A	isHidden()	0	4	1
A	setSortable()	0	6	1
A	isSortable()	0	4	1
A	setGroupable()	0	6	1
A	isGroupable()	0	4	1
A	setFilterable()	0	6	1
A	isFilterable()	0	4	1
A	setWidth()	0	9	2
A	getWidth()	0	4	1
A	setHeader()	0	6	1
A	getHeader()	0	4	1
A	setAlign()	0	9	3
A	getAlign()	0	4	1
A	setClass()	0	9	2
A	getClass()	0	4	1
A	getProperties()	0	4	1
A	setProperties()	0	13	3
A	__toString()	0	4	1

<?php

/*
 * soluble-flexstore library
 *
 * @author    Vanvelthem Sébastien
 * @link      https://github.com/belgattitude/soluble-flexstore
 * @copyright Copyright (c) 2016-2017 Vanvelthem Sébastien
 * @license   MIT License https://github.com/belgattitude/soluble-flexstore/blob/master/LICENSE.md
 *
 */

namespace Soluble\FlexStore\Column;

use Soluble\FlexStore\Column\Type\AbstractType;
use Soluble\FlexStore\Formatter\FormatterInterface;

class Column implements ColumnSettableInterface
{
    /**
     * @var string
     */
    protected $name;

    /**
     * @var array
     */
    protected $properties = [
        'type' => null, // will be defaulted to string
        'formatter' => null,
        'excluded' => false,
        'hidden' => false,
        'width' => null,
        'header' => null, // will be defaulted to name
        'filterable' => true,
        'groupable' => true,
        'sortable' => true,
        'editable' => false,
        'virtual' => true,
        'align' => null,
        'class' => null
    ];

    /**
     * Constructor.
     *
     * @param string $name       unique identifier name for the column
     * @param array  $properties associative array with (header,width,filterable,groupable,sortable,hidden,excluded,editable...)
     *
     * @throws Exception\InvalidArgumentException
     */
    public function __construct($name, array $properties = null)
    {
        if (!is_string($name)) {
            throw new Exception\InvalidArgumentException(__METHOD__ . ' Column name must be a string');
        }
        if (trim($name) === '') {
            throw new Exception\InvalidArgumentException(__METHOD__ . ' Column name cannot be empty');
        }
        $this->name = $name;
        if ($properties !== null) {
            $this->setProperties($properties);
        }
        $this->initDefaults();
    }

    /**
     * This method ensure some properties are defaulted.
     * For example header with name and type is string.
     */
    protected function initDefaults()
    {
        if ($this->properties['header'] === null) {
            $this->setHeader($this->name);
        }
        if ($this->properties['type'] === null) {
            $this->setType(ColumnType::createType(ColumnType::TYPE_STRING));
        }
    }

    /**
     * Get the name of the column.
     *
     * @return string
     */
    public function getName()
    {
        return $this->name;
    }

    /**
     * Set column datatype.
     *
     * @param string|AbstractType $type
     *
     * @throws Exception\InvalidArgumentException when the type is not supported
     *
     * @return Column
     */
    public function setType($type)
    {
        if (is_string($type)) {
            $type = ColumnType::createType($type);
        } elseif (!$type instanceof AbstractType) {
            throw new Exception\InvalidArgumentException(__METHOD__ . ' setType() accepts only AbstractType or string.');
        }
        $this->properties['type'] = $type;

        return $this;
    }

    /**
     * @return AbstractType
     */
    public function getType()
    {
        return $this->properties['type'];
    }

    /**
     * @param FormatterInterface $formatter
     *
     * @return Column
     */
    public function setFormatter(FormatterInterface $formatter)
    {
        $this->properties['formatter'] = $formatter;

        return $this;
    }

    /**
     * @return FormatterInterface|null
     */
    public function getFormatter()
    {
        return $this->properties['formatter'];
    }

    /**
     * @param bool $virtual
     *
     * @return Column
     */
    public function setVirtual($virtual = true)
    {
        $this->properties['virtual'] = $virtual;

        return $this;
    }

    /**
     * @return bool
     */
    public function isVirtual()
    {
        return $this->properties['virtual'];
    }

    /**
     * @param bool $excluded
     *
     * @return Column
     */
    public function setExcluded($excluded = true)
    {
        $this->properties['excluded'] = $excluded;

        return $this;
    }

    /**
     * @return bool
     */
    public function isExcluded()
    {
        return $this->properties['excluded'];
    }

    /**
     * @param bool $editable
     *
     * @return Column
     */
    public function setEditable($editable = true)
    {
        $this->properties['editable'] = $editable;

        return $this;
    }

    /**
     * @return bool
     */
    public function isEditable()
    {
        return $this->properties['editable'];
    }

    /**
     * @param bool $hidden
     *
     * @return Column
     */
    public function setHidden($hidden = true)
    {
        $this->properties['hidden'] = $hidden;

        return $this;
    }

    /**
     * @return bool
     */
    public function isHidden()
    {
        return (bool) $this->properties['hidden'];
    }

    /**
     * @param bool $sortable
     *
     * @return Column
     */
    public function setSortable($sortable = true)
    {
        $this->properties['sortable'] = $sortable;

        return $this;
    }

    /**
     * @return bool
     */
    public function isSortable()
    {
        return (bool) $this->properties['sortable'];
    }

    /**
     * @param bool $groupable
     *
     * @return Column
     */
    public function setGroupable($groupable = true)
    {
        $this->properties['groupable'] = $groupable;

        return $this;
    }

    /**
     * @return bool
     */
    public function isGroupable()
    {
        return (bool) $this->properties['groupable'];
    }

    /**
     * @param bool $filterable
     *
     * @return Column
     */
    public function setFilterable($filterable = true)
    {
        $this->properties['filterable'] = $filterable;

        return $this;
    }

    /**
     * @return bool
     */
    public function isFilterable()
    {
        return (bool) $this->properties['filterable'];
    }

    /**
     * Set recommended width for the column.
     *
     * @throws Exception\InvalidArgumentException
     *
     * @param float|int|string $width
     *
     * @return Column
     */
    public function setWidth($width)
    {
        if (!is_scalar($width)) {
            throw new Exception\InvalidArgumentException(__METHOD__ . ' Width parameter must be scalar.');
        }
        $this->properties['width'] = $width;

        return $this;
    }

    /**
     * @return float|int|string
     */
    public function getWidth()
    {
        return $this->properties['width'];
    }

    /**
     * Set table header for this column.
     *
     * @throws Exception\InvalidArgumentException
     *
     * @param string|null $header
     *
     * @return Column
     */
    public function setHeader($header)
    {
        $this->properties['header'] = $header;

        return $this;
    }

    /**
     * @return string|null
     */
    public function getHeader()
    {
        return $this->properties['header'];
    }

    /**
     * Set recommended horizontal align.
     *
     * @throws Exception\InvalidArgumentException
     *
     * @param string $align can be left|center|right
     *
     * @return Column
     */
    public function setAlign($align)
    {
        if (!is_string($align) || !in_array(strtolower($align), ['left', 'right', 'center'], true)) {
            throw new Exception\InvalidArgumentException(__METHOD__ . ' Align param must be a string : right, left, center.');
        }
        $this->properties['align'] = $align;

        return $this;
    }

    /**
     * Return recommended horizontal alignment.
     *
     * @return string|null
     */
    public function getAlign()
    {
        return $this->properties['align'];
    }

    /**
     * Set recommended css class.
     *
     * @throws Exception\InvalidArgumentException
     *
     * @param string $class css class
     *
     * @return Column
     */
    public function setClass($class)
    {
        if (!is_string($class)) {
            throw new Exception\InvalidArgumentException(__METHOD__ . ' Class param must be a string');
        }
        $this->properties['class'] = $class;

        return $this;
    }

    /**
     * Return recommended css class.
     *
     * @return string|null
     */
    public function getClass()
    {
        return $this->properties['class'];
    }

    /**
     * @return array
     */
    public function getProperties()
    {
        return $this->properties;
    }

    /**
     * Set properties for the column.
     *
     * @throws Exception\InvalidArgumentException
     *
     * @param array $properties associative array with (header,width,filterable,groupable,sortable,hidden,excluded,editable...)
     *
     * @return Column
     */
    public function setProperties(array $properties)
    {
        foreach ($properties as $key => $value) {
            if (array_key_exists($key, $this->properties)) {
                $method = 'set' . ucfirst($key);
                $this->$method($value);
            } else {
                throw new Exception\InvalidArgumentException(__METHOD__ . " property '$key' is not supported in column.");
            }
        }

        return $this;
    }

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