Когда хайлоад блок используется чуть менее тривиально, чем простой справочник, появляется необходимость хранить где-то свои методы работы с ним. Самое лучшее место - сам класс HL-блока. Казалось бы - берём базовый класс в соответствии с , наследуем, работаем. Но всё оказывается неможко не так:-)
Следуя документации, пишем код для hl-блока с идентификатором 1 и кодом сущности Test:
У сущности Test есть поле PARENT_ID, попробуем выбрать записи с фильтром по нему:
Запускаем... И получаем ошибку:
Проверка кода и названия поля ничего не даёт, мало того, та же выборка через $entityClass::getList() успешно отрабатывает.
А теперь немного о том, как работает компиляция сущности в модуле HighloadBlock. Внутри метода объявляется класс с именем ИмяСущностиTable, в котором описывается только одно поле - ID. И тут создаётся объект этого класса, к которому добавляются все поля hl-блока так же, как если бы это было сделано статически в getMap() сущности. Данный экземпляр класса является синглтоном и хранится в датаменеджере ORM по ключу, равному имени класса ("ИмяСущностиTable"). И все будущие обращения к нашей скомпилированной сущности оперируют этим синглтоном.
Таким образом, после вызова HL\HighloadBlockTable::compileEntity() мы имеем:
Теперь взглянем на метод создания/получения синглтона сущности в ORM (\Bitrix\Main\Entity\DataManager):
В первой же строке видно, как определяется ключ для хранения нашего синглтона - по имени класса, полученного в результате . Таким образом, становится очевидна причина, по которой выборка в классе-наследнике не знает о пользовательском поле PARENT_ID - порождается новый синглтон без маппинга полей.
Чтобы избежать этой проблемы (либо недомолвки в документации), надо всего лишь в наследуемом классе переопределить getEntity(), чтобы тот возвращал исходный синглтон. Весь код наследования целиком будет выглядеть следующим образом:
Следуя документации, пишем код для hl-блока с идентификатором 1 и кодом сущности Test:
namespace nav;
use Bitrix\Highloadblock as HL;
$hlblock = HL\HighloadBlockTable::getById(1)->fetch();
$entity = HL\HighloadBlockTable::compileEntity($hlblock);
$entityClass = $entity->getDataClass();
class TestTable extends \TestTable {
...
}
|
У сущности Test есть поле PARENT_ID, попробуем выбрать записи с фильтром по нему:
$rs = \nav\TestTable::getList(array(
'select' => array('ID', 'PARENT_ID'),
));
|
Запускаем... И получаем ошибку:
| [Bitrix\Main\SystemException] Unknown field definition `PARENT_ID` (PARENT_ID) for Test Entity. (100) |
Проверка кода и названия поля ничего не даёт, мало того, та же выборка через $entityClass::getList() успешно отрабатывает.
А теперь немного о том, как работает компиляция сущности в модуле HighloadBlock. Внутри метода объявляется класс с именем ИмяСущностиTable, в котором описывается только одно поле - ID. И тут создаётся объект этого класса, к которому добавляются все поля hl-блока так же, как если бы это было сделано статически в getMap() сущности. Данный экземпляр класса является синглтоном и хранится в датаменеджере ORM по ключу, равному имени класса ("ИмяСущностиTable"). И все будущие обращения к нашей скомпилированной сущности оперируют этим синглтоном.
Таким образом, после вызова HL\HighloadBlockTable::compileEntity() мы имеем:
- Базовый класс сущности с только одним полем ID;
- Зарегистрированный по имени класса синглтон со всеми полями HL-блока.
Теперь взглянем на метод создания/получения синглтона сущности в ORM (\Bitrix\Main\Entity\DataManager):
public static function getEntity()
{
$class = get_called_class();
if (!isset(static::$entity[$class]))
{
static::$entity[$class] = Base::getInstance($class);
}
return static::$entity[$class];
}
|
В первой же строке видно, как определяется ключ для хранения нашего синглтона - по имени класса, полученного в результате . Таким образом, становится очевидна причина, по которой выборка в классе-наследнике не знает о пользовательском поле PARENT_ID - порождается новый синглтон без маппинга полей.
Чтобы избежать этой проблемы (либо недомолвки в документации), надо всего лишь в наследуемом классе переопределить getEntity(), чтобы тот возвращал исходный синглтон. Весь код наследования целиком будет выглядеть следующим образом:
namespace nav;
\Bitrix\Main\Loader::includeModule('highloadblock');
use Bitrix\Highloadblock as HL;
\Bitrix\Highloadblock\HighloadBlockTable::compileEntity(array(
'ID' => 1,
'NAME' => 'Test',
'TABLE_NAME' => 'b_custom_test'
));
class TestTable extends \TestTable
{
public static function getEntity()
{
return static::$entity['TestTable'];
}
}
|
Группы на сайте создаются не только сотрудниками «1С-Битрикс», но и партнерами компании. Поэтому мнения участников групп могут не совпадать с позицией компании «1С-Битрикс».
