. * * The interactive user interfaces in modified source and object code versions * of this program must display Appropriate Legal Notices, as required under * Section 5 of the GNU Affero General Public License version 3. * * In accordance with Section 7(b) of the GNU Affero General Public License version 3, * these Appropriate Legal Notices must retain the display of the "EspoCRM" word. ************************************************************************/ namespace Espo\Core\ORM; use Espo\Core\ORM\Entity as BaseEntity; use Espo\Core\Repositories\Database as DatabaseRepository; use Espo\Core\Utils\ClassFinder; use Espo\Core\Utils\Metadata; use Espo\ORM\Entity as Entity; use Espo\ORM\EventDispatcher; use Espo\ORM\Repository\Repository as Repository; class ClassNameProvider { /** @var class-string */ private const DEFAULT_ENTITY_CLASS_NAME = BaseEntity::class; /** @var class-string> */ private const DEFAULT_REPOSITORY_CLASS_NAME = DatabaseRepository::class; /** @var array> */ private array $entityCache = []; /** @var array>> */ private array $repositoryCache = []; public function __construct( private Metadata $metadata, private ClassFinder $classFinder, EventDispatcher $eventDispatcher, ) { $eventDispatcher->subscribeToMetadataUpdate(function () { $this->entityCache = []; $this->repositoryCache = []; $this->classFinder->resetRuntimeCache(); }); } /** * @param string $entityType * @return class-string */ public function getEntityClassName(string $entityType): string { if (!array_key_exists($entityType, $this->entityCache)) { $this->entityCache[$entityType] = $this->findEntityClassName($entityType); } return $this->entityCache[$entityType]; } /** * @param string $entityType * @return class-string> */ public function getRepositoryClassName(string $entityType): string { if (!array_key_exists($entityType, $this->entityCache)) { $this->repositoryCache[$entityType] = $this->findRepositoryClassName($entityType); } return $this->repositoryCache[$entityType]; } /** * @param string $entityType * @return class-string */ private function findEntityClassName(string $entityType): string { /** @var ?class-string $className */ $className = $this->metadata->get("entityDefs.$entityType.entityClassName"); if ($className) { return $className; } /** @var ?class-string $className */ $className = $this->classFinder->find('Entities', $entityType); if ($className) { return $className; } /** @var ?string $template */ $template = $this->metadata->get(['scopes', $entityType, 'type']); if ($template) { /** @var ?class-string $className */ $className = $this->metadata->get(['app', 'entityTemplates', $template, 'entityClassName']); } if ($className) { return $className; } return self::DEFAULT_ENTITY_CLASS_NAME; } /** * @param string $entityType * @return class-string> */ private function findRepositoryClassName(string $entityType): string { /** @var ?class-string> $className */ $className = $this->metadata->get("entityDefs.$entityType.repositoryClassName"); if ($className) { return $className; } /** @var ?class-string> $className */ $className = $this->classFinder->find('Repositories', $entityType); if ($className) { return $className; } /** @var ?string $template */ $template = $this->metadata->get(['scopes', $entityType, 'type']); if ($template) { /** @var ?class-string> $className */ $className = $this->metadata->get(['app', 'entityTemplates', $template, 'repositoryClassName']); } if ($className) { return $className; } return self::DEFAULT_REPOSITORY_CLASS_NAME; } }