Создать поля сущности Entity::postInitialize
Модуль: main — подключать отдельно не нужно
Метод Entity::postInitialize завершает построение сущности после initialize. Метод getInstance вызывает его сам. Прикладному коду вызывать метод не нужно.
Метод выполняет шаги по порядку.
- Задает имя сущности — имя класса таблицы без суффикса
Table. - Если класс таблицы не задал имя таблицы, строит его. Пример —
b_vendor_units_unit_priceдля классаVendor\Units\UnitPriceTable. - Создает поля из описания методом addField и находит первичный ключ.
- Подключает пользовательские поля, если у таблицы есть объект пользовательских полей.
Сигнатура метода в классе Bitrix\Main\ORM\Entity:
public function postInitialize()
Возвращаемое значение
Метод ничего не возвращает.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\SystemException |
У таблицы есть поля, но нет первичного ключа |
Bitrix\Main\ArgumentException |
Описание поля содержит неизвестный тип |
Особенности
- Имя таблицы по умолчанию начинается с
b_. Метод пропускает пространство именBitrixи модульMain, остальные части пишет строчными буквами через_, имя сущности — вsnake_case. - Если имя сущности совпадает с последней частью пространства имен, метод его не добавляет. Класс
Vendor\Units\UnitsTableполучит таблицуb_vendor_units. - Класс таблицы может переопределить свой статический метод
postInitialize, чтобы изменить сущность после построения.
Примеры
Пример. Код создает сущность без имени таблицы и читает построенное имя:
<?php
use Bitrix\Main\ORM\Entity;
use Bitrix\Main\ORM\Fields\IntegerField;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$entity = Entity::compileEntity('UnitPrice', [new IntegerField('ID', ['primary' => true])], ['namespace' => 'Vendor\Units']);
echo $entity->getDBTableName();
Код выведет b_vendor_units_unit_price.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая