Создать объект существующей записи DataManager::wakeUpObject

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

Метод DataManager::wakeUpObject создает объект ORM для записи, которая уже есть в базе данных. Метод не выполняет запрос. Метод нужен, когда ключ записи известен, например из формы, и запись нужно изменить или удалить без предварительной выборки.

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

final public static function wakeUpObject($row)

Параметры

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

Параметр Тип Описание
row* mixed Задает первичный ключ, например 1, или массив значений полей с первичным ключом, например ['ID' => 1, 'CODE' => 'kg']

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

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

Метод возвращает объект класса из getObjectClass в состоянии «актуальный». Объект содержит только переданные значения. Метод fill объекта загружает недостающие поля.

Особенности

Метод не проверяет, что запись существует. Метод save такого объекта выполнит UPDATE и не добавит запись.

Примеры

Пример. Код изменяет запись через объект без выборки. Блок finally удаляет рабочую таблицу:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\ORM\Data\DataManager;
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()->configureAutocomplete(),
            (new StringField('CODE'))->configureRequired(),
            new StringField('NAME'),
        ];
    }
}

DemoUnitTable::getEntity()->createDbTable();

try
{
    $id = DemoUnitTable::add(['CODE' => 'kg'])->getId();

    $unit = DemoUnitTable::wakeUpObject($id);
    $before = var_export($unit->isCodeFilled(), true);
    $unit->setName('Kilogram');
    $unit->save();

    echo $before . ' ' . DemoUnitTable::getRowById($id)['NAME'];
}
finally
{
    Application::getConnection()->dropTable(DemoUnitTable::getTableName());
}

Код выведет false Kilogram.

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