Дополнить сущность после создания DataManager::postInitialize

Модуль: main — подключать отдельно не нужно

Метод DataManager::postInitialize дополняет сущность после создания. ORM вызывает его один раз, когда создает сущность и поля из getMap. Наследник переопределяет метод, чтобы добавить поля, которые зависят от уже созданных полей или от настроек сайта.

Сигнатура метода в классе Bitrix\Main\ORM\Data\DataManager:

public static function postInitialize(Entity $entity)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
entity* Bitrix\Main\ORM\Entity Задает созданную сущность. Метод может добавить в нее поля методом addField

Возвращаемое значение

Базовый класс возвращает null. ORM не использует возвращаемое значение.

Примеры

Пример. Код добавляет в сущность поле-выражение после создания:

<?php
use Bitrix\Main\ORM\Data\DataManager;
use Bitrix\Main\ORM\Entity;
use Bitrix\Main\ORM\Fields\ExpressionField;
use Bitrix\Main\ORM\Fields\IntegerField;
use Bitrix\Main\ORM\Fields\StringField;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

class DemoUnitTable extends DataManager
{
    public static function getTableName()
    {
        return 'demo_api_units';
    }

    public static function getMap()
    {
        return [
            (new IntegerField('ID'))->configurePrimary(),
            new StringField('CODE'),
        ];
    }

    public static function postInitialize(Entity $entity)
    {
        $entity->addField(new ExpressionField('CODE_LENGTH', 'LENGTH(%s)', 'CODE'));
    }
}

var_dump(DemoUnitTable::getEntity()->hasField('CODE_LENGTH'));

Код выведет bool(true).

Смотрите также