relation.php

<?php
namespace Bitrix\Main\ORM\Fields\Relations;
 
use Bitrix\Main\ArgumentException;
use Bitrix\Main\ORM\Fields\ITypeHintable;
use Bitrix\Main\SystemException;
use Bitrix\Main\ORM\Entity;
use Bitrix\Main\ORM\Fields\Field;
use Bitrix\Main\ORM\Objectify\EntityObject;
use Bitrix\Main\ORM\Query\Join;
 
abstract class Relation extends Field implements ITypeHintable
{
    protected $refEntityName;
 
    protected $refEntity;
 
    protected $joinType = null;
 
    protected $cascadeSavePolicy;
 
    protected $cascadeDeletePolicy;
 
    public function configureCascadeSavePolicy($cascadeSavePolicy)
    {
        $this->cascadeSavePolicy = $cascadeSavePolicy;
 
        return $this;
    }
 
    public function configureCascadeDeletePolicy($cascadeDeletePolicy)
    {
        $this->cascadeDeletePolicy = $cascadeDeletePolicy;
 
        return $this;
    }
 
    public function getRefEntity()
    {
        if ($this->refEntity === null)
        {
            // refEntityName could be an object or a data class
            if (class_exists($this->refEntityName) && is_subclass_of($this->refEntityName, EntityObject::class))
            {
                $refObjectClass = $this->refEntityName;
                $this->refEntityName = $refObjectClass::$dataClass;
            }
 
            $this->refEntity = Entity::getInstance($this->refEntityName);
        }
 
        return $this->refEntity;
    }
 
    public function getRefEntityName()
    {
        return $this->refEntityName;
    }
 
    public function configureJoinType($type)
    {
        $type = strtoupper($type);
 
        if (!in_array($type, Join::getTypes(), true))
        {
            throw new ArgumentException(sprintf(
                'Unknown join type `%s` in reference `%s` of `%s` entity',
                $type, $this->name, $this->entity->getDataClass()
            ));
        }
 
        $this->joinType = $type;
 
        return $this;
    }
 
    public function getJoinType()
    {
        return $this->joinType;
    }
 
    public function getCascadeSavePolicy()
    {
        return $this->cascadeSavePolicy;
    }
 
    public function getCascadeDeletePolicy()
    {
        return $this->cascadeDeletePolicy;
    }
 
    public function getGetterTypeHint()
    {
        return $this->getRefEntity()->getObjectClass();
    }
 
    public function getSetterTypeHint()
    {
        return $this->getRefEntity()->getObjectClass();
    }
}