2025-08-02 21:20:32 +03:00

92 lines
4.6 KiB
PHP

<?php
namespace goodboyalex\php_db_components_pack\classes;
use Closure;
use goodboyalex\php_components_pack\extensions\StringExtension;
/**
* Класс свойства класса, реализующего интерфейс IDBItem.
*
* @author Александр Бабаев
* @package php_db_components_pack
* @version 1.0
* @since 1.0
*/
final class DBItemProperty
{
/**
* @var string $Name Имя свойства.
*/
public string $Name;
/**
* @var mixed $Value Значение свойства (ещё не конвертированное!).
*/
public mixed $Value;
/**
* @var string $FieldName Имя поля в таблице БД.
*/
public string $FieldName;
/**
* @var bool $IsPrimaryKey Признак того, что свойство является первичным ключом.
*/
public bool $IsPrimaryKey;
/**
* @var bool $IsIgnored Признак того, что свойство игнорируется при сохранении в / загрузке из БД.
*/
public bool $IsIgnored;
/**
* @var Closure $ConvertToDB Конвертер значения свойства в значение поля БД.
*/
public Closure $ConvertToDB;
/**
* @var Closure $ConvertFromDB Конвертер значения поля БД в значение свойства.
*/
public Closure $ConvertFromDB;
/**
* @var Closure $Compare Функция сравнения значений свойства.
*/
public Closure $Compare;
/**
* Конструктор.
*
* @param string $name Имя свойства.
* @param mixed|null $value Значение свойства (ещё не конвертированное!).
* @param string $fieldName Имя поля в таблице БД.
* @param bool $isPrimaryKey Признак того, что свойство является первичным ключом.
* @param bool $isIgnored Признак того, что свойство игнорируется при сохранении в / загрузке из БД.
* @param callable|null $ConvertToDB Конвертер значения свойства в значение поля БД.
* @param Closure|null $ConvertFromDB Конвертер значения поля БД в значение свойства.
* @param Closure|null $Compare Функция сравнения значений свойства.
*/
public function __construct (string $name = '', mixed $value = null, string $fieldName = '',
bool $isPrimaryKey = false, bool $isIgnored = false, ?callable $ConvertToDB = null,
?Closure $ConvertFromDB = null, ?Closure $Compare = null)
{
// Установка значений
// - установка имени свойства
$this->Name = $name;
// - установка значения свойства (ещё не конвертированного)
$this->Value = $value;
// - установка имени поля в таблице БД
$this->FieldName = StringExtension::IsNullOrWhitespace($fieldName) ? $name : $fieldName;
// - установка признака того, что свойство является первичным ключом
$this->IsPrimaryKey = $isPrimaryKey;
// - установка признака того, что свойство игнорируется при сохранении в / загрузке из БД
$this->IsIgnored = $isIgnored;
// - установка конвертеров значения свойства в значение поля БД
$this->ConvertToDB = $ConvertToDB ?? fn (mixed $value): mixed => $value;
// - установка конвертеров значения поля БД в значение свойства
$this->ConvertFromDB = $ConvertFromDB ?? fn (mixed $value): mixed => $value;
// - установка функции сравнения значений свойства
$this->Compare = $Compare ?? fn (mixed $value1, mixed $value2): bool => $value1 == $value2;
}
}