DataManager
Описание
DataManager - абстрактный базовый класс для работы с объектами данных.
Обращается к пространству имён:
Класс загружает языковые фразы для текущего скрипта: Loc::loadMessages(__FILE__)
.
Если новый класс отвечает за доступ к таблице БД, он должен быть наследником класса Bitrix\Main\Entity\DataManager Класс является алиасом класса Bitrix\Main\ORM\Data\DataManager и должен переопределять только два метода:
- getTableName для получения имени таблицы,
- getMap для получения массива колонок таблицы - объектов
Bitrix\Main\Entity\Field
.
Методы
Метод | Описание | С версии |
---|---|---|
add | Метод добавляет строку в таблицу сущностей. | |
checkFields | Метод проверяет поля данных перед записью в БД. | |
delete | Метод удаляет строку в таблице сущности по первичному ключу. | |
getById | Метод возвращает выборку по первичному ключу сущности. | |
getByPrimary | Метод возвращает выборку по первичному ключу сущности и по опциональным параметрам \Bitrix\Main\Entity\DataManager::getList . | |
getConnectionName | Метод возвращает имя соединения для сущности. | 12.0.9 |
getCount | Метод выполняет COUNT запрос к сущности и возвращает результат. | 12.0.10 |
getEntity | Метод возвращает объект сущности. | |
getList | Метод выполняет запрос и возвращает отобранные по параметрам запроса данные. | |
getMap | Метод возвращает описание карты сущностей. | 12.0.7 |
getRow | Метод возвращает одну строку (или null) по параметрам для \Bitrix\Main\Entity\DataManager::getList . | |
getRowById | Метод возвращает строку (или null) по первичному ключу сущности. | 14.0.0 |
getTableName | Метод возвращает имя таблицы БД для сущности. | 12.0.7 |
query | Метод создаёт и возвращает объект запроса для сущности. | |
update | Метод обновляет строку в таблице объекта по первичному ключу. | |
enableCrypto | Метод устанавливает флаг поддержки шифрования для поля. | 17.5.14 |
cryptoEnabled | Метод возвращает true если шифрование разрешено для поля. | 17.5.14 |
События
Событие | Описание |
---|---|
События добавления | |
OnBeforeAdd | параметры: fields |
OnAdd | параметры: fields |
OnAfterAdd | параметры: fields, primary |
События изменения | |
OnBeforeUpdate | параметры: primary, fields |
OnUpdate | параметры: primary, fields |
OnAfterUpdate | параметры: primary, fields |
События удаления | |
OnBeforeDelete | параметры: primary |
OnDelete | параметры: primary |
OnAfterDelete | параметры: primary |
Подробнее о событиях в курсе Разработчик Bitrix Framework.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024