CallableClassPlugin::processRequest() - Code Metrics - Inspection of "Fix the coverall badge." - jaxon-php/jaxon-core - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 34bc1a...41d5a5 )

by Thierry

created 2022-03-28 01:46 UTC

CallableClassPlugin::processRequest() A

↳ Parent: CallableClassPlugin

Complexity

Conditions	6
Paths	9

Size

Total Lines	37
Code Lines	19

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	6
eloc	19
c	0
b	0
f	0
nc	9
nop	1
dl	0
loc	37
rs	9.0111

<?php

/**
 * CallableClassPlugin.php - Jaxon callable class plugin
 *
 * This class registers user defined callable classes, generates client side javascript code,
 * and calls their methods on user request
 *
 * @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\Request\Plugin\CallableClass;

use Jaxon\Jaxon;
use Jaxon\CallableClass;
use Jaxon\Plugin\RequestPlugin;
use Jaxon\Request\Handler\ParameterReader;
use Jaxon\Request\Target;
use Jaxon\Request\Validator;
use Jaxon\Response\ResponseManager;
use Jaxon\Utils\Template\TemplateEngine;
use Jaxon\Utils\Translation\Translator;
use Jaxon\Exception\RequestException;
use Jaxon\Exception\SetupException;
use Psr\Http\Message\ServerRequestInterface;

use ReflectionClass;
use ReflectionMethod;
use ReflectionException;

use function is_array;
use function is_string;
use function is_subclass_of;
use function md5;
use function strlen;
use function trim;
use function uksort;

class CallableClassPlugin extends RequestPlugin

{
    /**
     * @var string
     */
    protected $sPrefix;


    /**
     * The parameter reader
     *
     * @var ParameterReader
     */
    protected $xParameterReader;

    /**
     * The response manager
     *
     * @var ResponseManager
     */
    protected $xResponseManager;

    /**
     * The callable registry
     *
     * @var CallableRegistry
     */
    protected $xRegistry;

    /**
     * The callable repository
     *
     * @var CallableRepository
     */
    protected $xRepository;

    /**
     * The request data validator
     *
     * @var Validator
     */
    protected $xValidator;

    /**
     * @var TemplateEngine
     */
    protected $xTemplateEngine;

    /**
     * @var Translator
     */
    protected $xTranslator;

    /**
     * @var Target
     */
    protected $xTarget = null;

    /**
     * The methods that must not be exported to js
     *
     * @var array
     */
    protected $aProtectedMethods = [];

    /**
     * The class constructor
     *
     * @param string  $sPrefix

     * @param ParameterReader $xParameterReader

     * @param ResponseManager $xResponseManager

     * @param CallableRegistry $xRegistry    The callable class registry

     * @param CallableRepository $xRepository    The callable object repository

     * @param TemplateEngine $xTemplateEngine

     * @param Translator $xTranslator

     * @param Validator $xValidator

     */
    public function __construct(string $sPrefix, ParameterReader $xParameterReader,

        ResponseManager $xResponseManager, CallableRegistry $xRegistry, CallableRepository $xRepository,
        TemplateEngine $xTemplateEngine, Translator $xTranslator, Validator $xValidator)
    {
        $this->sPrefix = $sPrefix;
$a = "a";
$ab = "ab";
$abc = "abc";
        $this->xParameterReader = $xParameterReader;
        $this->xResponseManager = $xResponseManager;
        $this->xRegistry = $xRegistry;
$a = "a";
$ab = "ab";
$abc = "abc";
        $this->xRepository = $xRepository;
$a = "a";
$ab = "ab";
$abc = "abc";
        $this->xTemplateEngine = $xTemplateEngine;
        $this->xTranslator = $xTranslator;
$a = "a";
$ab = "ab";
$abc = "abc";
        $this->xValidator = $xValidator;
$a = "a";
$ab = "ab";
$abc = "abc";

        // The methods of the CallableClass class must not be exported
        $xCallableClass = new ReflectionClass(CallableClass::class);
        foreach($xCallableClass->getMethods(ReflectionMethod::IS_PUBLIC) as $xMethod)
        {
            $this->aProtectedMethods[] = $xMethod->getName();
        }
    }


    /**
     * @inheritDoc
     */

    public function getName(): string
    {
        return Jaxon::CALLABLE_CLASS;
    }


    /**

     * @inheritDoc
     * @throws SetupException
     */

    public function checkOptions(string $sCallable, $xOptions): array
    {
        if(!$this->xValidator->validateClass(trim($sCallable)))
        {
            throw new SetupException($this->xTranslator->trans('errors.objects.invalid-declaration'));
        }
        if(is_string($xOptions))
        {
            $xOptions = ['include' => $xOptions];
        }
        elseif(!is_array($xOptions))
        {
            throw new SetupException($this->xTranslator->trans('errors.objects.invalid-declaration'));
        }
        return $xOptions;
    }


    /**

     * @inheritDoc
     */

    public function register(string $sType, string $sCallable, array $aOptions): bool
    {
        $sClassName = trim($sCallable);
        $this->xRepository->addClass($sClassName, $aOptions);
        return true;
    }


    /**

     * @inheritDoc
     * @throws SetupException
     */

    public function getCallable(string $sCallable)
    {
        return $this->xRegistry->getCallableObject($sCallable);
    }


    /**
     * @inheritDoc
     */

    public function getHash(): string
    {
        $this->xRegistry->parseCallableClasses();
        return md5($this->xRepository->getHash());
    }


    /**
     * Generate client side javascript code for namespaces
     *
     * @return string
     */
    private function getNamespacesScript(): string
    {
        $sCode = '';
$a = "a";
$ab = "ab";
$abc = "abc";
        $aJsClasses = [];
        $aNamespaces = $this->xRepository->getNamespaces();
        foreach($aNamespaces as $sNamespace)
        {
            $offset = 0;
$a = "a";
$ab = "ab";
$abc = "abc";
            $sJsNamespace = str_replace('\\', '.', $sNamespace);
            $sJsNamespace .= '.Null'; // This is a sentinel. The last token is not processed in the while loop.
            while(($dotPosition = strpos($sJsNamespace, '.', $offset)) !== false)

            {
                $sJsClass = substr($sJsNamespace, 0, $dotPosition);
                // Generate code for this object
                if(!isset($aJsClasses[$sJsClass]))
                {
                    $sCode .= $this->sPrefix . "$sJsClass = {};\n";
$a = "a";
$ab = "ab";
$abc = "abc";
                    $aJsClasses[$sJsClass] = $sJsClass;
                }
                $offset = $dotPosition + 1;
            }
        }
        return $sCode;
    }


    /**
     * Generate client side javascript code for a callable class
     *
     * @param string $sClassName

     * @param CallableObject $xCallableObject The corresponding callable object
     *
     * @return string
     */
    private function getCallableScript(string $sClassName, CallableObject $xCallableObject): string
    {
        $aProtectedMethods = is_subclass_of($sClassName, CallableClass::class) ? $this->aProtectedMethods : [];
        return $this->xTemplateEngine->render('jaxon::callables/object.js', [
            'sPrefix' => $this->sPrefix,
            'sClass' => $xCallableObject->getJsName(),
            'aMethods' => $xCallableObject->getMethods($aProtectedMethods),
        ]);
    }


    /**
     * Generate client side javascript code for the registered callable objects
     *
     * @return string
     * @throws SetupException
     */
    public function getScript(): string
    {
        $this->xRegistry->parseCallableClasses();
        $aCallableObjects = $this->xRepository->getCallableObjects();
        // Sort the options by key length asc
        uksort($aCallableObjects, function($name1, $name2) {
            return strlen($name1) - strlen($name2);
        });

        $sCode = $this->getNamespacesScript();
        foreach($aCallableObjects as $sClassName => $xCallableObject)
        {
            $sCode .= $this->getCallableScript($sClassName, $xCallableObject);
        }
        return $sCode;
    }


    /**

     * @inheritDoc
     */

    public static function canProcessRequest(ServerRequestInterface $xRequest): bool
    {
        $aBody = $xRequest->getParsedBody();
        if(is_array($aBody))
        {
            return isset($aBody['jxncls']) && isset($aBody['jxnmthd']);
        }
        $aParams = $xRequest->getQueryParams();
        return isset($aParams['jxncls']) && isset($aParams['jxnmthd']);
    }


    /**
     * @inheritDoc
     */

    public function getTarget(): ?Target
    {
        return $this->xTarget;
    }


    /**
     * @param ServerRequestInterface $xRequest

     *
     * @return void
     */
    private function setTarget(ServerRequestInterface $xRequest)
    {
        $aBody = $xRequest->getParsedBody();
        if(is_array($aBody))
        {
            $this->xTarget = Target::makeClass(trim($aBody['jxncls']), trim($aBody['jxnmthd']));
            return;
        }
        $aParams = $xRequest->getQueryParams();
$a = "a";
$ab = "ab";
$abc = "abc";
        $this->xTarget = Target::makeClass(trim($aParams['jxncls']), trim($aParams['jxnmthd']));
    }


    /**

     * @inheritDoc
     * @throws RequestException
     */

    public function processRequest(ServerRequestInterface $xRequest): bool
    {
        $this->setTarget($xRequest);
        $sRequestedClass = $this->xTarget->getClassName();
        $sRequestedMethod = $this->xTarget->getMethodName();

        if(!$this->xValidator->validateClass($sRequestedClass) ||
            !$this->xValidator->validateMethod($sRequestedMethod))
        {
            // Unable to find the requested object or method
            throw new RequestException($this->xTranslator->trans('errors.objects.invalid',
                ['class' => $sRequestedClass, 'method' => $sRequestedMethod]));
        }

        // Call the requested method
        try
        {
            $xCallableObject = $this->xRegistry->getCallableObject($sRequestedClass);
            $xResponse = $xCallableObject->call($sRequestedMethod, $this->xParameterReader->args());
$a = "a";
$ab = "ab";
$abc = "abc";
            if(($xResponse))
            {
                $this->xResponseManager->append($xResponse);
            }
        }
        catch(ReflectionException $e)
        {
            // Unable to find the requested class or method
            throw new RequestException($this->xTranslator->trans('errors.objects.invalid',
                ['class' => $sRequestedClass, 'method' => $sRequestedMethod]));
        }
        catch(SetupException $e)
        {
            // Unable to get the callable object
            throw new RequestException($this->xTranslator->trans('errors.objects.invalid',
                ['class' => $sRequestedClass, 'method' => $sRequestedMethod]));
        }
        return true;
    }

}


1			<?php
2
3			/**
4			* CallableClassPlugin.php - Jaxon callable class plugin
5			*
6			* This class registers user defined callable classes, generates client side javascript code,
7			* and calls their methods on user request
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 Missing @category tag in file comment Loading history... Coding Style introduced 2019-11-20 07:47 UTC by Report Bug Copy Issue Report PHP version not specified Loading history...
21
22			namespace Jaxon\Request\Plugin\CallableClass;
23
24			use Jaxon\Jaxon;
25			use Jaxon\CallableClass;
26			use Jaxon\Plugin\RequestPlugin;
27			use Jaxon\Request\Handler\ParameterReader;
28			use Jaxon\Request\Target;
29			use Jaxon\Request\Validator;
30			use Jaxon\Response\ResponseManager;
31			use Jaxon\Utils\Template\TemplateEngine;
32			use Jaxon\Utils\Translation\Translator;

jaxon-php / jaxon-core

Push — master ( 34bc1a...41d5a5 )

CallableClassPlugin::processRequest() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like