Prime::initialize() - Code Metrics - Inspection of "fix(testing): Fix mysqli constant MYSQLI_OPT_READ_..." - b2pweb/bdf-prime - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Branch — master (7599e2)

by Sébastien
created 2021-07-01 07:56 UTC
Prime::initialize() A

↳ Parent: Prime
Complexity

Conditions	5
Paths	6
Size

Total Lines	39
Code Lines	23
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	19
CRAP Score	5.2259
Importance

Changes
Metric	Value
eloc	23
dl	0
loc	39
ccs	19
cts	24
cp	0.7917
rs	9.2408
c	0
b	0
f	0
cc	5
nc	6
nop	0
crap	5.2259
<?php

namespace Bdf\Prime;

use Bdf\Prime\Connection\ConnectionInterface;
use Bdf\Prime\Connection\ConnectionRegistry;
use Bdf\Prime\Connection\Factory\ChainFactory;
use Bdf\Prime\Connection\Factory\ConnectionFactory;
use Bdf\Prime\Connection\Factory\MasterSlaveConnectionFactory;
use Bdf\Prime\Connection\Factory\ShardingConnectionFactory;
use Bdf\Prime\Exception\PrimeException;
use Bdf\Prime\Mapper\MapperFactory;
use Bdf\Prime\Repository\RepositoryInterface;
use Psr\Container\ContainerInterface;
use RuntimeException;

/**
 * Prime
 * 
 * Usefull facade to manipulate repositories
 * Allow user to create, drop, truncate repositories
 * Allow user to find, insert entities

 */
class Prime
{
    /**
     * @var mixed
     */
    protected static $config;

    /**
     * @var ServiceLocator
     */
    protected static $serviceLocator;


    /**
     * Configure the locator
     * 
     * @param array|ContainerInterface|ServiceLocator $config
     */
    public static function configure($config)

    {
        if ($config instanceof ServiceLocator) {
            static::$config = null;
            static::$serviceLocator = $config;
        } else {
            static::$config = $config;
            static::$serviceLocator = null;
        }
    }

    /**
     * Check whether prime is configured
     *
     * @return bool

     */
    public static function isConfigured()
    {
        return static::$config !== null;
    }

    //
    //--------- repository

    //
    
    /**
     * Get a repository
     * 
     * @param string|object|RepositoryInterface $repository
     *
     * @return RepositoryInterface
     */
    public static function repository($repository)
    {
        if ($repository instanceof RepositoryInterface) {
            return $repository;
        }

        return static::service()->repository($repository);
    }
    
    /**
     * Create repositories
     * 
     * @param string|array|RepositoryInterface $repositories
     * @param boolean                          $force @see EntityRepository::schema

     * @throws PrimeException

     */
    public static function create($repositories, $force = false)
    {
        static::callSchemaResolverMethod('migrate', $repositories, $force);
    }

    /**
     * Drop repositories
     * 
     * @param string|array|RepositoryInterface $repositories
     * @param boolean                          $force @see EntityRepository::schema

     * @throws PrimeException

     */
    public static function drop($repositories, $force = false)
    {
        static::callSchemaResolverMethod('drop', $repositories, $force);
    }

    /**
     * Truncate repositories
     * 
     * @param string|array|RepositoryInterface $repositories
     * @param boolean                          $force @see EntityRepository::schema

     * @throws PrimeException

     */
    public static function truncate($repositories, $force = false)
    {
        static::callSchemaResolverMethod('truncate', $repositories, $force);
    }

    /**
     * Call schema resolver method
     * 
     * @param string  $method
     * @param mixed   $repositories
     * @param boolean $force

     *
     * @throws PrimeException
     */
    protected static function callSchemaResolverMethod($method, $repositories, $force)
    {
        if (!is_array($repositories)) {
            $repositories = [$repositories];
        }
        
        foreach ($repositories as $repository) {
            static::repository($repository)->schema($force)->$method();
        }
    }
    
    //
    //--------- entities

    //

    /**
     * Push multiple entities in repository
     * launch replace method from repository
     * 
     * User can add
     *  * entity object
     *  * collection of entity object
     *  * an array of entity attributes

     * 
     * <code>
     *  Prime::push(new EntityClass());
     *  Prime::push([new EntityClass()]);
     *  Prime::push($repository, ['id' => '...']);
     *  Prime::push('EntityClass', ['id' => '...']);
     *  Prime::push('EntityClass', [['id' => '...']]);
     * </code>
     * 
     * @param mixed $repositoryName
     * @param mixed $entities
     *
     * @throws PrimeException
     */
    public static function push($repositoryName, $entities = null)
    {
        static::callRepositoryMethod('replace', $repositoryName, $entities);
    }

    /**
     * Save multiple entities in repository
     * launch save method from repository
     * 
     * User can add
     *  * entity object
     *  * collection of entity object
     *  * an array of entity attributes

     * 
     * <code>
     *  Prime::save(new EntityClass());
     *  Prime::save([new EntityClass()]);
     *  Prime::save($repository, ['id' => '...']);
     *  Prime::save('EntityClass', ['id' => '...']);
     *  Prime::save('EntityClass', [['id' => '...']]);
     * </code>
     * 
     * @param mixed $repositoryName
     * @param mixed $entities
     *
     * @throws PrimeException
     */
    public static function save($repositoryName, $entities = null)
    {
        static::callRepositoryMethod('save', $repositoryName, $entities);
    }

    /**
     * Remove multiple entities in repository
     * 
     * User can add
     *  * entity object
     *  * collection of entity object
     *  * an array of entity attributes

     * 
     * <code>
     *  Prime::remove(new EntityClass());
     *  Prime::remove([new EntityClass()]);
     *  Prime::remove($repository, ['id' => '...']);
     *  Prime::remove('EntityClass', ['id' => '...']);
     *  Prime::remove('EntityClass', [['id' => '...']]);
     * </code>
     * 
     * @param mixed $repositoryName
     * @param mixed $entities
     *
     * @throws PrimeException
     */
    public static function remove($repositoryName, $entities = null)
    {
        static::callRepositoryMethod('delete', $repositoryName, $entities);
    }
    
    /**
     * Call repository method for entities
     *  
     * @param string $method
     * @param mixed $repositoryName
     * @param mixed $entities
     *
     * @throws PrimeException
     */
    protected static function callRepositoryMethod($method, $repositoryName, $entities)
    {
        if (!is_string($repositoryName) && !$repositoryName instanceof RepositoryInterface) {
            $entities = $repositoryName;
            $repositoryName = null;
        }
        
        if (!is_array($entities) || !isset($entities[0])) {
            $entities = [$entities];
        }
        
        foreach ($entities as $entity) {
            $repository = static::repository($repositoryName ?: $entity);

            
            if (is_array($entity)) {
                $entity = $repository->entity($entity);
            }
            
            $repository->$method($entity);
        }
    }

    /**
     * Assert that entity exists
     * 
     * @param object $entity
     * @param bool   $compare  Will compare entity with the expected one

     * 
     * @return bool

     *
     * @throws PrimeException
     */
    public static function exists($entity, $compare = true)
    {
        $repository = static::repository($entity);
        
        $expected = $repository->findOne($repository->mapper()->primaryCriteria($entity));
        $expected = $repository->findOne($repository->mapper()->primaryCriteria($entity));
        
        if ($expected === null) {
            return false;
        }
        
        if (!$compare) {
            return true;
        }
        
        return $entity == $expected 
                ? true

                : serialize($entity) === serialize($expected);
    }

    /**
     * Find entity
     * 
     * <code>
     *  Prime::find(new EntityClass());
     *  Prime::find('EntityClass', ['id' => '...']);
     *  Prime::find($repository, ['id' => '...']);
     * </code>
     * 
     * @param string|RepositoryInterface  $repositoryName     Repo name or Entity instance
     * @param array|object                $criteria           Array of criteria. Optionnal if repository name is an object
     * 
     * @return object|array
     *
     * @throws PrimeException
     */
    public static function find($repositoryName, $criteria = null)
    {
        $repository = static::repository($repositoryName);
        
        // if $repositoryName is an entity

        if (is_object($repositoryName) && !$repositoryName instanceof RepositoryInterface) {

            $criteria = $repository->mapper()->prepareToRepository($repositoryName);
        }
        
        return $repository->find($criteria);
        return $repository->/** @scrutinizer ignore-call */ find($criteria);
    }

    /**
     * Find one entity
     * 
     * <code>
     *  Prime::one(new EntityClass());
     *  Prime::one('EntityClass', ['id' => '...']);
     *  Prime::one($repository, ['id' => '...']);
     * </code>
     * 
     * @param string|RepositoryInterface  $repositoryName     Repo name or Entity instance
     * @param array|object                $criteria           Array of criteria. Optionnal if repository name is an object
     * 
     * @return object|array
     *
     * @throws PrimeException
     */
    public static function one($repositoryName, $criteria = null)
    {
        $repository = static::repository($repositoryName);
        
        // if $repositoryName is an entity

        if (is_object($repositoryName) && !$repositoryName instanceof RepositoryInterface) {

            $criteria = $repository->mapper()->prepareToRepository($repositoryName);
        }
        
        return $repository->findOne($criteria);
    }

    /**
     * Refresh entity from repository
     * 
     * @param object $entity
     * @param array  $additionnalCriteria  Criteria to add to primary key
     * 
     * @return object New refresh entity
     *
     * @throws PrimeException
     */
    public static function refresh($entity, $additionnalCriteria = [])

    {
        $repository = static::repository($entity);
        
        return $repository->findOne($repository->mapper()->primaryCriteria($entity) + $additionnalCriteria);
    }
    
    //
    //--------- service

    //
    
    /**
     * Get active connection from profile name
     * 
     * @param string $name
     * 
     * @return ConnectionInterface
     */
    public static function connection($name = null)
    {
        return static::service()->connection($name);
    }

    /**
     * Get service locator
     * 
     * @return ServiceLocator
     */
    public static function service()
    {
        if (static::$serviceLocator === null) {
            static::initialize();
        }

        return static::$serviceLocator;
    }

    /**
     * Initializes the service locator
     */

    protected static function initialize()
    {
        if (static::$config instanceof ContainerInterface) {
            static::$serviceLocator = static::$config->get('prime');
            
            return;
        }
        
        if (!is_array(static::$config)) {
            throw new RuntimeException('Prime is not configured');
        }

        $factory = new ConnectionFactory();
        $registry = new ConnectionRegistry(
            static::$config['connection']['config'] ?? [],

            new ChainFactory([
                new MasterSlaveConnectionFactory($factory),
                new ShardingConnectionFactory($factory),
                $factory,
            ])
        );

        $mapperFactory = new MapperFactory(
            null,
            static::$config['metadataCache'] ?? null,

            static::$config['resultCache'] ?? null

        );

        static::$serviceLocator = new ServiceLocator(
            new ConnectionManager($registry),
            $mapperFactory
        );

        if ($logger = static::$config['logger'] ?? null) {

            $registry->getDefaultConfiguration()->setSQLLogger($logger);
        }

        if ($serializer = static::$config['serializer'] ?? null) {

            static::$serviceLocator->setSerializer($serializer);
        }
    }
}

b2pweb / bdf-prime

Branch — master (7599e2)

Prime::initialize() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
