/var/www/vhosts/ihelp.ro/_OLD/vendor/cakephp/cakephp/src/ORM
Edit: /var/www/vhosts/ihelp.ro/_OLD/vendor/cakephp/cakephp/src/ORM/BehaviorRegistry.php (9299B)
*/
class BehaviorRegistry extends ObjectRegistry implements EventDispatcherInterface
{
use EventDispatcherTrait;
/**
* The table using this registry.
*
* @var \Cake\ORM\Table
*/
protected $_table;
/**
* Method mappings.
*
* @var array
*/
protected $_methodMap = [];
/**
* Finder method mappings.
*
* @var array
*/
protected $_finderMap = [];
/**
* Constructor
*
* @param \Cake\ORM\Table|null $table The table this registry is attached to.
*/
public function __construct(?Table $table = null)
{
if ($table !== null) {
$this->setTable($table);
}
}
/**
* Attaches a table instance to this registry.
*
* @param \Cake\ORM\Table $table The table this registry is attached to.
* @return void
*/
public function setTable(Table $table): void
{
$this->_table = $table;
$this->setEventManager($table->getEventManager());
}
/**
* Resolve a behavior classname.
*
* @param string $class Partial classname to resolve.
* @return string|null Either the correct classname or null.
* @psalm-return class-string|null
*/
public static function className(string $class): ?string
{
return App::className($class, 'Model/Behavior', 'Behavior')
?: App::className($class, 'ORM/Behavior', 'Behavior');
}
/**
* Resolve a behavior classname.
*
* Part of the template method for Cake\Core\ObjectRegistry::load()
*
* @param string $class Partial classname to resolve.
* @return string|null Either the correct class name or null.
* @psalm-return class-string|null
*/
protected function _resolveClassName(string $class): ?string
{
return static::className($class);
}
/**
* Throws an exception when a behavior is missing.
*
* Part of the template method for Cake\Core\ObjectRegistry::load()
* and Cake\Core\ObjectRegistry::unload()
*
* @param string $class The classname that is missing.
* @param string|null $plugin The plugin the behavior is missing in.
* @return void
* @throws \Cake\ORM\Exception\MissingBehaviorException
*/
protected function _throwMissingClassError(string $class, ?string $plugin): void
{
throw new MissingBehaviorException([
'class' => $class . 'Behavior',
'plugin' => $plugin,
]);
}
/**
* Create the behavior instance.
*
* Part of the template method for Cake\Core\ObjectRegistry::load()
* Enabled behaviors will be registered with the event manager.
*
* @param string $class The classname that is missing.
* @param string $alias The alias of the object.
* @param array $config An array of config to use for the behavior.
* @return \Cake\ORM\Behavior The constructed behavior class.
* @psalm-suppress MoreSpecificImplementedParamType
*/
protected function _create($class, string $alias, array $config): Behavior
{
/** @var \Cake\ORM\Behavior $instance */
$instance = new $class($this->_table, $config);
$enable = $config['enabled'] ?? true;
if ($enable) {
$this->getEventManager()->on($instance);
}
$methods = $this->_getMethods($instance, $class, $alias);
$this->_methodMap += $methods['methods'];
$this->_finderMap += $methods['finders'];
return $instance;
}
/**
* Get the behavior methods and ensure there are no duplicates.
*
* Use the implementedEvents() method to exclude callback methods.
* Methods starting with `_` will be ignored, as will methods
* declared on Cake\ORM\Behavior
*
* @param \Cake\ORM\Behavior $instance The behavior to get methods from.
* @param string $class The classname that is missing.
* @param string $alias The alias of the object.
* @return array A list of implemented finders and methods.
* @throws \LogicException when duplicate methods are connected.
*/
protected function _getMethods(Behavior $instance, string $class, string $alias): array
{
$finders = array_change_key_case($instance->implementedFinders());
$methods = array_change_key_case($instance->implementedMethods());
foreach ($finders as $finder => $methodName) {
if (isset($this->_finderMap[$finder]) && $this->has($this->_finderMap[$finder][0])) {
$duplicate = $this->_finderMap[$finder];
$error = sprintf(
'%s contains duplicate finder "%s" which is already provided by "%s"',
$class,
$finder,
$duplicate[0]
);
throw new LogicException($error);
}
$finders[$finder] = [$alias, $methodName];
}
foreach ($methods as $method => $methodName) {
if (isset($this->_methodMap[$method]) && $this->has($this->_methodMap[$method][0])) {
$duplicate = $this->_methodMap[$method];
$error = sprintf(
'%s contains duplicate method "%s" which is already provided by "%s"',
$class,
$method,
$duplicate[0]
);
throw new LogicException($error);
}
$methods[$method] = [$alias, $methodName];
}
return compact('methods', 'finders');
}
/**
* Check if any loaded behavior implements a method.
*
* Will return true if any behavior provides a public non-finder method
* with the chosen name.
*
* @param string $method The method to check for.
* @return bool
*/
public function hasMethod(string $method): bool
{
$method = strtolower($method);
return isset($this->_methodMap[$method]);
}
/**
* Check if any loaded behavior implements the named finder.
*
* Will return true if any behavior provides a public method with
* the chosen name.
*
* @param string $method The method to check for.
* @return bool
*/
public function hasFinder(string $method): bool
{
$method = strtolower($method);
return isset($this->_finderMap[$method]);
}
/**
* Invoke a method on a behavior.
*
* @param string $method The method to invoke.
* @param array $args The arguments you want to invoke the method with.
* @return mixed The return value depends on the underlying behavior method.
* @throws \BadMethodCallException When the method is unknown.
*/
public function call(string $method, array $args = [])
{
$method = strtolower($method);
if ($this->hasMethod($method) && $this->has($this->_methodMap[$method][0])) {
[$behavior, $callMethod] = $this->_methodMap[$method];
return $this->_loaded[$behavior]->{$callMethod}(...$args);
}
throw new BadMethodCallException(
sprintf('Cannot call "%s" it does not belong to any attached behavior.', $method)
);
}
/**
* Invoke a finder on a behavior.
*
* @param string $type The finder type to invoke.
* @param array $args The arguments you want to invoke the method with.
* @return \Cake\ORM\Query The return value depends on the underlying behavior method.
* @throws \BadMethodCallException When the method is unknown.
*/
public function callFinder(string $type, array $args = []): Query
{
$type = strtolower($type);
if ($this->hasFinder($type) && $this->has($this->_finderMap[$type][0])) {
[$behavior, $callMethod] = $this->_finderMap[$type];
$callable = [$this->_loaded[$behavior], $callMethod];
return $callable(...$args);
}
throw new BadMethodCallException(
sprintf('Cannot call finder "%s" it does not belong to any attached behavior.', $type)
);
}
}