Manager::getPackage() - Code Metrics - Inspection of "Fixes." - jaxon-php/jaxon-core - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — feature/packages ( d10195...cc596d )

by Thierry

created 2019-12-07 05:38 UTC

Manager::getPackage() A

↳ Parent: Manager

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	1
nc	1
nop	1
dl	0
loc	5
rs	10
c	0
b	0
f	0

<?php

/**
 * Manager.php - Jaxon plugin manager
 *
 * Register Jaxon plugins, generate corresponding code, handle request
 * and redirect them to the right plugin.
 *
 * @package jaxon-core

 * @author Jared White

 * @author J. Max Wilson

 * @author Joseph Woolley

 * @author Steffen Konerow

 * @author Thierry Feuzeu <[email protected]>
 * @copyright Copyright (c) 2005-2007 by Jared White & J. Max Wilson

 * @copyright Copyright (c) 2008-2010 by Joseph Woolley, Steffen Konerow, Jared White  & J. Max Wilson

 * @copyright 2016 Thierry Feuzeu <[email protected]>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-core
 */


namespace Jaxon\Plugin;

use Jaxon\Jaxon;
use Jaxon\Plugin\Package;
use Jaxon\Plugin\Code\Generator as CodeGenerator;
use Jaxon\Request\Support\CallableRepository;
use Jaxon\Request\Plugin\CallableClass;
use Jaxon\Request\Plugin\CallableDir;
use Jaxon\Request\Plugin\CallableFunction;
use Jaxon\Request\Plugin\FileUpload;
use Jaxon\Response\Plugin\JQuery as JQueryPlugin;
use Jaxon\Utils\Config\Config;

use Closure;

class Manager

{
    use \Jaxon\Features\Manager;
    use \Jaxon\Features\Config;
    use \Jaxon\Features\Event;
    use \Jaxon\Features\Translator;

    /**
     * Request plugins, indexed by name
     *
     * @var array
     */
    private $aRequestPlugins = [];

    /**
     * Response plugins, indexed by name
     *
     * @var array
     */
    private $aResponsePlugins = [];

    /**
     * The code generator
     *
     * @var CodeGenerator
     */
    private $xCodeGenerator;

    /**
     * The constructor
     *
     * @param CodeGenerator     $xCodeGenerator

     */
    public function __construct(CodeGenerator $xCodeGenerator)

    {
        $this->xCodeGenerator = $xCodeGenerator;
    }


    /**
     * Get the request plugins
     *
     * @return array
     */
    public function getRequestPlugins()
    {
        return $this->aRequestPlugins;
    }


    /**
     * Get the response plugins
     *
     * @return array
     */
    public function getResponsePlugins()
    {
        return $this->aResponsePlugins;
    }


    /**
     * Get a package instance
     *
     * @param string        $sClassName           The package class name

     *
     * @return Package
     */
    public function getPackage($sClassName)
    {
        $sClassName = trim($sClassName, '\\ ');

        return jaxon()->di()->get($sClassName);
    }


    /**
     * Register a plugin
     *
     * Below is a table for priorities and their description:
     * - 0 thru 999: Plugins that are part of or extensions to the jaxon core
     * - 1000 thru 8999: User created plugins, typically, these plugins don't care about order
     * - 9000 thru 9999: Plugins that generally need to be last or near the end of the plugin list
     *
     * @param Plugin         $xPlugin               An instance of a plugin

     * @param integer        $nPriority             The plugin priority, used to order the plugins

     *
     * @return void
     */
    public function registerPlugin(Plugin $xPlugin, $nPriority = 1000)
    {
        $bIsUsed = false;
        if($xPlugin instanceof Request)
        {
            // The name of a request plugin is used as key in the plugin table
            $this->aRequestPlugins[$xPlugin->getName()] = $xPlugin;
            $this->xCodeGenerator->addGenerator($xPlugin, $nPriority);
            $bIsUsed = true;
        }
        elseif($xPlugin instanceof Response)
        {
            // The name of a response plugin is used as key in the plugin table
            $this->aResponsePlugins[$xPlugin->getName()] = $xPlugin;
            $this->xCodeGenerator->addGenerator($xPlugin, $nPriority);
            $bIsUsed = true;
        }

        // This plugin implements the Message interface
        if($xPlugin instanceof \Jaxon\Contracts\Dialogs\Message)
        {
            jaxon()->dialog()->setMessage($xPlugin);
            $bIsUsed = true;
        }
        // This plugin implements the Question interface
        if($xPlugin instanceof \Jaxon\Contracts\Dialogs\Question)
        {
            jaxon()->dialog()->setQuestion($xPlugin);
            $bIsUsed = true;
        }
        // Register the plugin as an event listener
        if($xPlugin instanceof \Jaxon\Contracts\Event\Listener)
        {
            $this->addEventListener($xPlugin);
            $bIsUsed = true;
        }

        if(!$bIsUsed)
        {
            $sErrorMessage = $this->trans('errors.register.invalid', ['name' => get_class($xPlugin)]);
            throw new \Jaxon\Exception\Error($sErrorMessage);
        }
    }


    /**
     * Register a package
     *
     * @param string        $sClassName           The package class name

     * @param array         $aOptions           The package options

     *
     * @return void
     */
    public function registerPackage($sClassName, array $aOptions)
    {
        $jaxon = jaxon();
        $di = $jaxon->di();
$a = "a";
$ab = "ab";
$abc = "abc";

        $sClassName = trim($sClassName, '\\ ');

        $di->set($sClassName, function() use($di, $sClassName, $aOptions) {
            return $di->make($sClassName);
        });

        // Read and apply the package config.
        $aPackageConfig = $jaxon->config()->read($sClassName::getConfigFile());
        $xPackageConfig = $di->newConfig($aPackageConfig);
        $this->_registerFromConfig($xPackageConfig);
        // Register the view namespaces
        $di->getViewManager()->addNamespaces($xPackageConfig);

        // Set the package options
        $cSetter = function($_aOptions) {
$a = "a";
$ab = "ab";
$abc = "abc";
            $this->aOptions = $_aOptions;
class MyClass { }

$x = new MyClass();
$x->foo = true;
        };
        $xPackage = $this->getPackage($sClassName);
        // Can now access protected attributes
        \call_user_func($cSetter->bindTo($xPackage, $xPackage), $aOptions);

        $this->xCodeGenerator->addGenerator($xPackage, 500);
    }


    /**
     * Register a function, event or callable class
     *
     * Call the request plugin with the $sType defined as name.
     *
     * @param string        $sType          The type of request handler being registered

     * @param string        $sCallable      The callable entity being registered

     * @param array|string  $aOptions       The associated options

     *
     * @return mixed
     */
    public function registerCallable($sType, $sCallable, $aOptions = [])
    {
        if(!key_exists($sType, $this->aRequestPlugins))
        {
            throw new \Jaxon\Exception\Error($this->trans('errors.register.plugin', ['name' => $sType]));
        }

        $xPlugin = $this->aRequestPlugins[$sType];
        return $xPlugin->register($sType, $sCallable, $aOptions);
    }


    /**
     * Register callable from a section of the config
     *
     * @param Config        $xAppConfig        The config options

     * @param string        $sSection          The config section name

     * @param string        $sCallableType     The type of callable to register

     *
     * @return void
     */
    private function registerCallablesFromConfig(Config $xAppConfig, $sSection, $sCallableType)
    {
        $aConfig = $xAppConfig->getOption($sSection, []);
        foreach($aConfig as $xKey => $xValue)
        {
            if(is_integer($xKey) && is_string($xValue))
            {
                // Register a function without options
                $this->registerCallable($sCallableType, $xValue);
            }
            elseif(is_string($xKey) && (is_array($xValue) || is_string($xValue)))
            {
                // Register a function with options
                $this->registerCallable($sCallableType, $xKey, $xValue);
            }
            else
            {
                continue;
                // Todo: throw an exception
            }
        }
    }


    /**
     * Read and set Jaxon options from a JSON config file
     *
     * @param Config        $xAppConfig        The config options

     *
     * @return void
     */
    private function _registerFromConfig(Config $xAppConfig)
    {
        // Register functions
        $this->registerCallablesFromConfig($xAppConfig, 'functions', Jaxon::CALLABLE_FUNCTION);

        // Register classes
        $this->registerCallablesFromConfig($xAppConfig, 'classes', Jaxon::CALLABLE_CLASS);

        // Register directories
        $this->registerCallablesFromConfig($xAppConfig, 'directories', Jaxon::CALLABLE_DIR);

        // Register classes in DI container
        $di = jaxon()->di();
$a = "a";
$ab = "ab";
$abc = "abc";
        $aContainerConfig = $xAppConfig->getOption('container', []);
        foreach($aContainerConfig as $sClassName => $xClosure)
        {
            $di->set($sClassName, $xClosure);
        }
    }


    /**
     * Read and set Jaxon options from a JSON config file
     *
     * @param Config        $xAppConfig        The config options

     *
     * @return void
     */
    public function registerFromConfig(Config $xAppConfig)
    {
        $this->_registerFromConfig($xAppConfig);

        // Register packages
        $aPackageConfig = $xAppConfig->getOption('packages', []);
        foreach($aPackageConfig as $sClassName => $aOptions)
        {
            $this->registerPackage($sClassName, $aOptions);
        }
    }


    /**
     * Find the specified response plugin by name and return a reference to it if one exists
     *
     * @param string        $sName                The name of the plugin

     *
     * @return \Jaxon\Plugin\Response
     */
    public function getResponsePlugin($sName)
    {
        if(array_key_exists($sName, $this->aResponsePlugins))
        {
            return $this->aResponsePlugins[$sName];
        }
        return null;
    }


    /**
     * Find the specified request plugin by name and return a reference to it if one exists
     *
     * @param string        $sName                The name of the plugin

     *
     * @return \Jaxon\Plugin\Request
     */
    public function getRequestPlugin($sName)
    {
        if(array_key_exists($sName, $this->aRequestPlugins))
        {
            return $this->aRequestPlugins[$sName];
        }
        return null;
    }


    /**
     * Register the Jaxon request plugins
     *
     * @return void
     */
    public function registerRequestPlugins()
    {
        $di = jaxon()->di();
        $this->registerPlugin($di->get(CallableClass::class), 101);
        $this->registerPlugin($di->get(CallableDir::class), 102);
        $this->registerPlugin($di->get(CallableFunction::class), 103);
        $this->registerPlugin($di->get(FileUpload::class), 104);
    }


    /**
     * Register the Jaxon response plugins
     *
     * @return void
     */
    public function registerResponsePlugins()
    {
        $di = jaxon()->di();
        // Register an instance of the JQuery plugin
        $this->registerPlugin($di->get(JQueryPlugin::class), 700);
    }

}


1			<?php
2
3			/**
4			* Manager.php - Jaxon plugin manager
5			*
6			* Register Jaxon plugins, generate corresponding code, handle request
7			* and redirect them to the right plugin.
8			*
9			* @package jaxon-core
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Package name "jaxon-core" is not valid; consider "Jaxoncore" instead Loading history...
10			* @author Jared White
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Content of the @author tag must be in the form "Display Name <[email protected]>" Loading history...
11			* @author J. Max Wilson
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Content of the @author tag must be in the form "Display Name <[email protected]>" Loading history...
12			* @author Joseph Woolley
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Content of the @author tag must be in the form "Display Name <[email protected]>" Loading history...
13			* @author Steffen Konerow
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Content of the @author tag must be in the form "Display Name <[email protected]>" Loading history...
14			* @author Thierry Feuzeu <[email protected]>
15			* @copyright Copyright (c) 2005-2007 by Jared White & J. Max Wilson
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report @copyright tag must contain a year and the name of the copyright holder Loading history...
16			* @copyright Copyright (c) 2008-2010 by Joseph Woolley, Steffen Konerow, Jared White & J. Max Wilson
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report @copyright tag must contain a year and the name of the copyright holder Loading history...
17			* @copyright 2016 Thierry Feuzeu <[email protected]>
18			* @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
19			* @link https://github.com/jaxon-php/jaxon-core
20			*/
			0 ignored issues – show Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report PHP version not specified Loading history... Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report Missing @category tag in file comment Loading history...
21
22			namespace Jaxon\Plugin;
23
24			use Jaxon\Jaxon;
25			use Jaxon\Plugin\Package;
26			use Jaxon\Plugin\Code\Generator as CodeGenerator;
27			use Jaxon\Request\Support\CallableRepository;
28			use Jaxon\Request\Plugin\CallableClass;
29			use Jaxon\Request\Plugin\CallableDir;
30			use Jaxon\Request\Plugin\CallableFunction;
31			use Jaxon\Request\Plugin\FileUpload;
32			use Jaxon\Response\Plugin\JQuery as JQueryPlugin;

jaxon-php / jaxon-core

Push — feature/packages ( d10195...cc596d )

Manager::getPackage() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like