Bdf\Prime\Behaviors\Versionable

Complexity

Total Complexity

15

Size/Duplication

Total Lines	168
Duplicated Lines	0 %

Test Coverage

Coverage

97.87%

Importance

Changes

0

10 Methods

Rating	Name	Duplication	Size	Complexity
A	afterUpdate()	0	4	2
A	afterInsert()	0	4	2
A	insertVersion()	0	3	1
A	incrementVersion()	0	8	1
A	__construct()	0	4	1
A	subscribe()	0	10	2
A	beforeUpdate()	0	7	2
A	changeSchema()	0	3	1
A	deleteAllVersions()	0	9	2
A	beforeInsert()	0	3	1

<?php

namespace Bdf\Prime\Behaviors;

use Bdf\Prime\Mapper\Builder\FieldBuilder;
use Bdf\Prime\Repository\RepositoryEventsSubscriberInterface;
use Bdf\Prime\Repository\RepositoryInterface;

/**
 * Versionable
 *
 * The versionable behavior allows you to keep an history of your model objects.
 *
 * @template E as object
 * @extends Behavior<E>
 */
class Versionable extends Behavior
{
    const COLUMN_NAME = 'version';

    /**
     * The version repository className
     *
     * @var string
     */
    protected $versionClass;

    /**
     * Allow version deletion
     *
     * @var boolean

Expected "bool" but found "boolean" for @var tag in member variable comment

     */
    protected $allowDeletion;

    /**
     * Version table name
     *
     * @var string
     */
    protected $tableName;

    /**
     * Versionable constructor.
     *
     * @param string $versionClass
     * @param bool   $allowDeletion

Expected "boolean" but found "bool" for parameter type

     */
    public function __construct($versionClass, $allowDeletion = false)
    {
        $this->versionClass = $versionClass;
        $this->allowDeletion = $allowDeletion;
    }

    /**

Parameter $builder should have a doc-comment as per coding-style.

     * {@inheritdoc}
     */
    public function changeSchema(FieldBuilder $builder): void
    {
        $builder->integer(self::COLUMN_NAME, 0);
    }

    /**
     * Before insert
     *
     * we increment version number on entity

Doc comment long description must end with a full stop

Doc comment long description must start with a capital letter

     *
     * @param E $entity

The type Bdf\Prime\Behaviors\E was not found. Maybe you did not declare it correctly or list all dependencies?

     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     */
    public function beforeInsert($entity, $repository)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        $this->incrementVersion($entity, $repository);
    }

    /**
     * After insert
     *
     * we historicize entity

Doc comment long description must start with a capital letter

Doc comment long description must end with a full stop

     *
     * @param E $entity
     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     * @param integer $count

Expected "int" but found "integer" for parameter type

     */
    public function afterInsert($entity, $repository, $count)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        if ($count != 0) {
            $this->insertVersion($entity, $repository);
        }
    }

    /**
     * Before update
     *
     * we increment version number on entity

Doc comment long description must end with a full stop

Doc comment long description must start with a capital letter

     *
     * @param E $entity
     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     * @param null|\ArrayObject $attributes
     */
    public function beforeUpdate($entity, $repository, $attributes)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        if ($attributes !== null) {
            $attributes[] = self::COLUMN_NAME;
        }

        $this->incrementVersion($entity, $repository);
    }

    /**
     * After update
     *
     * we historicize entity

Doc comment long description must end with a full stop

Doc comment long description must start with a capital letter

     *
     * @param E $entity
     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     * @param integer $count

Expected "int" but found "integer" for parameter type

     */
    public function afterUpdate($entity, $repository, $count)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        if ($count != 0) {
            $this->insertVersion($entity, $repository);
        }
    }

    /**
     * Remove entity versions
     *
     * @param E $entity
     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     */
    public function deleteAllVersions($entity, $repository)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        $queries = $repository->repository($this->versionClass)->queries();
        $criteria = $repository->mapper()->primaryCriteria($entity);

        if ($query = $queries->keyValue($criteria)) {

Variable assignment found within a condition. Did you mean to do a comparison ?

Assignments must be the first block of code on a line

            $query->delete();
        } else {
            $queries->builder()->where($criteria)->delete();
        }
    }

    /**

Parameter $notifier should have a doc-comment as per coding-style.

     * {@inheritdoc}
     */
    public function subscribe(RepositoryEventsSubscriberInterface $notifier): void
    {
        $notifier->inserting([$this, 'beforeInsert']);
        $notifier->inserted([$this, 'afterInsert']);

        $notifier->updating([$this, 'beforeUpdate']);
        $notifier->updated([$this, 'afterUpdate']);

        if ($this->allowDeletion) {
            $notifier->deleted([$this, 'deleteAllVersions']);
        }
    }

    /**
     * Increment version number on entity
     *
     * @param E $entity
     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     */
    protected function incrementVersion($entity, $repository)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        $mapper = $repository->mapper();

        $mapper->hydrateOne(
            $entity,
            self::COLUMN_NAME,
            $mapper->extractOne($entity, self::COLUMN_NAME) + 1

Operation must be bracketed

        );
    }

    /**
     * Historicize entity
     *
     * @param E $entity
     * @param RepositoryInterface<E> $repository

Expected "RepositoryInterfaceE" but found "RepositoryInterface<E>" for parameter type

     */
    protected function insertVersion($entity, $repository)

Type hint "E" missing for $entity

Type hint "RepositoryInterface<E>" missing for $repository

    {
        $repository->repository($this->versionClass)->insert($entity);
    }
}