Cycle\ORM\Entity\Behavior\UpdatedAt

Complexity

Total Complexity

6

Size/Duplication

Total Lines	46
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	6	1
A	compute()	0	7	2
A	render()	0	10	1
A	getListenerArgs()	0	5	1
A	getListenerClass()	0	3	1

<?php

declare(strict_types=1);

namespace Cycle\ORM\Entity\Behavior;

use Cycle\ORM\Entity\Behavior\Schema\BaseModifier;
use Cycle\ORM\Entity\Behavior\Schema\RegistryModifier;
use Cycle\ORM\Entity\Behavior\Listener\UpdatedAt as Listener;
use Cycle\ORM\Schema\GeneratedField;
use Cycle\Schema\Registry;
use Doctrine\Common\Annotations\Annotation\Attribute;
use Doctrine\Common\Annotations\Annotation\Attributes;
use Doctrine\Common\Annotations\Annotation\NamedArgumentConstructor;
use Doctrine\Common\Annotations\Annotation\Target;

/**
 * UpdatedAt behavior will automate adding an updating date to your entity. The behavior has three parameters:
 *    - field - is a property in the entity
 *    - column - is a column in the database
 *    - nullable - if this parameter is set to false, will be set initial value when an entity is creating
 * Behavior requires a field with the DateTime type.
 * A property in an entity and a field in the database can be added in several ways:
 *   - Can be added by a behavior automatically.
 *   - Can be configured with an existing field of the required type in the entity.
 *     If the existing field is not of the correct type, or if the property is set for a field in the database that is
 *     different from the one specified in the behavior parameters, an exception will be thrown.
 *
 * @Annotation
 * @NamedArgumentConstructor()
 * @Target({"CLASS"})
 * @Attributes({
 *     @Attribute("field", type="string"),
 *     @Attribute("column", type="string"),
 *     @Attribute("nullable", type="boolean")
 * })
 */
#[\Attribute(\Attribute::TARGET_CLASS), NamedArgumentConstructor]
final class UpdatedAt extends BaseModifier
{
    private ?string $column = null;

    public function __construct(
        private string $field = 'updatedAt',
        ?string $column = null,
        private bool $nullable = false,
    ) {
        $this->column = $column;
    }

    public function compute(Registry $registry): void
    {
        $modifier = new RegistryModifier($registry, $this->role);
        $this->column = $modifier->findColumnName($this->field, $this->column);

        if ($this->column !== null) {
            $modifier->addDatetimeColumn($this->column, $this->field);
        }
    }

    public function render(Registry $registry): void
    {
        $modifier = new RegistryModifier($registry, $this->role);

        $this->column = $modifier->findColumnName($this->field, $this->column) ?? $this->field;

        $modifier->addDatetimeColumn(
            $this->column,
            $this->field,
            GeneratedField::BEFORE_INSERT | GeneratedField::BEFORE_UPDATE,
        );
    }

    protected function getListenerClass(): string
    {
        return Listener::class;
    }

    protected function getListenerArgs(): array
    {
        return [
            'field' => $this->field,
            'nullable' => $this->nullable,
        ];
    }
}