Incoming\Hydrator\AbstractDelegateContextualBuilder

Complexity

Total Complexity

4

Size/Duplication

Total Lines	52
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	build()	0	10	3
A	__construct()	0	3	1

<?php
/**
 * Incoming
 *
 * @author    Trevor Suarez (Rican7)
 * @copyright (c) Trevor Suarez
 * @link      https://github.com/Rican7/incoming
 * @license   MIT
 */

declare(strict_types=1);

namespace Incoming\Hydrator;

use Incoming\Structure\Map;

/**
 * An abstract, context enabled extension of the `AbstractDelegateBuilder`.
 *
 * @see AbstractDelegateBuilder
 */
abstract class AbstractDelegateContextualBuilder extends AbstractDelegateBuilder implements ContextualBuilder
{

    /**
     * Properties
     */

    /**
     * Whether or not to provide a fallback empty context, when a `null` context
     * is otherwise provided, to make processes simpler by not having to rely on
     * null checks of the actual parameter before usage.
     *
     * @var bool
     */
    private $provide_fallback_context = false;


    /**
     * Methods
     */

    /**
     * Constructor
     *
     * @param bool $provide_fallback_context Whether or not to provide a
     *  fallback empty context, when a `null` context is otherwise provided, to
     *  make processes simpler by not having to rely on null checks of the
     *  actual parameter before usage.
     */
    protected function __construct(bool $provide_fallback_context = false)
    {
        $this->provide_fallback_context = $provide_fallback_context;
    }

    /**
     * {@inheritdoc}
     *
     * @param mixed $incoming The input data.
     * @param Map|null $context An optional generic key-value map, for providing
     *  contextual values during the build process.
     * @return mixed The built model.
     */
    public function build($incoming, Map $context = null)
    {
        $callable = $this->getDelegate();

        if (null === $context && $this->provide_fallback_context) {
            // Provide a non-null context so null checks aren't later required
            $context = new Map();
        }

        return $callable($incoming, $context);
    }
}