Jaxon::paginator() - Code Metrics - Inspection of "More tests on dialogs." - jaxon-php/jaxon-core - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 6eb156...b34d93 )

by Thierry

created 2022-04-05 13:39 UTC

Jaxon::paginator() A

↳ Parent: Jaxon

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Importance

Changes

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

<?php

/**
 * Jaxon.php - Jaxon class
 *
 * The Jaxon class uses a modular plug-in system to facilitate the processing
 * of special Ajax requests made by a PHP page.
 * It generates Javascript that the page must include in order to make requests.
 * It handles the output of response commands (see <Jaxon\Response\Response>).
 * Many flags and settings can be adjusted to effect the behavior of the Jaxon class
 * as well as the client-side javascript.
 *
 * @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;

use Jaxon\App\App;
use Jaxon\App\Bootstrap;
use Jaxon\Config\ConfigManager;
use Jaxon\Di\Container;
use Jaxon\Exception\RequestException;
use Jaxon\Exception\SetupException;
use Jaxon\Plugin\Code\CodeGenerator;
use Jaxon\Plugin\Manager\PackageManager;
use Jaxon\Plugin\Manager\PluginManager;
use Jaxon\Plugin\Package;
use Jaxon\Plugin\ResponsePlugin;
use Jaxon\Request\Factory;
use Jaxon\Request\Factory\RequestFactory;
use Jaxon\Request\Handler\CallbackManager;
use Jaxon\Request\Handler\UploadHandler;
use Jaxon\Request\Plugin\CallableClass\CallableRegistry;
use Jaxon\Response\Manager\ResponseManager;
use Jaxon\Response\Response;
use Jaxon\Response\ResponseInterface;
use Jaxon\Session\SessionInterface;
use Jaxon\Ui\Pagination\Paginator;
use Jaxon\Ui\View\ViewRenderer;
use Jaxon\Utils\Http\UriException;
use Jaxon\Utils\Template\TemplateEngine;
use Jaxon\Utils\Translation\Translator;

use Psr\Log\LoggerInterface;

use function gmdate;
use function header;
use function headers_sent;
use function trim;
use function error_reporting;
use function ob_end_clean;
use function ob_get_level;

class Jaxon

{
    /**
     * Package version number
     *
     * @const string
     */
    const VERSION = 'Jaxon 4.0.0-dev';

    /*
     * Request plugins
     */

    const CALLABLE_CLASS = 'CallableClass';
$a = "a";
$ab = "ab";
$abc = "abc";
    const CALLABLE_DIR = 'CallableDir';
$a = "a";
$ab = "ab";
$abc = "abc";
    const CALLABLE_FUNCTION = 'CallableFunction';

    /**
     * A static instance on this class
     *
     * @var Jaxon
     */
    private static $xInstance = null;

    /**
     * The DI container
     *
     * @var Container
     */
    private static $xContainer = null;

    /**
     * @var Bootstrap
     */
    protected $xBootstrap;

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

    /**
     * @var ConfigManager
     */
    protected $xConfigManager;

    /**
     * @var PluginManager
     */
    protected $xPluginManager;

    /**
     * @var PackageManager
     */
    protected $xPackageManager;

    /**
     * @var CodeGenerator
     */
    protected $xCodeGenerator;

    /**
     * @var CallableRegistry
     */
    protected $xClassRegistry;

    /**
     * @var CallbackManager
     */
    protected $xCallbackManager;

    /**
     * @var ResponseManager
     */
    protected $xResponseManager;

    /**
     * @return void
     */
    private static function initInstance()

    {
        // Set the attributes from the container
        self::$xInstance->xBootstrap = self::$xContainer->g(Bootstrap::class);
$a = "a";
$ab = "ab";
$abc = "abc";
        self::$xInstance->xTranslator = self::$xContainer->g(Translator::class);
$a = "a";
$ab = "ab";
$abc = "abc";
        self::$xInstance->xConfigManager = self::$xContainer->g(ConfigManager::class);
$a = "a";
$ab = "ab";
$abc = "abc";
        self::$xInstance->xPluginManager = self::$xContainer->g(PluginManager::class);
$a = "a";
$ab = "ab";
$abc = "abc";
        self::$xInstance->xPackageManager = self::$xContainer->g(PackageManager::class);
        self::$xInstance->xCodeGenerator = self::$xContainer->g(CodeGenerator::class);
$a = "a";
$ab = "ab";
$abc = "abc";
        self::$xInstance->xClassRegistry = self::$xContainer->g(CallableRegistry::class);
$a = "a";
$ab = "ab";
$abc = "abc";
        self::$xInstance->xCallbackManager = self::$xContainer->g(CallbackManager::class);
        self::$xInstance->xResponseManager = self::$xContainer->g(ResponseManager::class);
    }


    /**
     * Get the static instance
     *
     * @return Jaxon
     */
    public static function getInstance(): ?Jaxon
    {
        if(self::$xInstance === null)
        {
            self::$xInstance = new Jaxon();
            self::$xContainer = new Container(self::$xInstance);
            self::initInstance();
        }
        // Call the on boot callbacks on each call to the jaxon() function.
        self::$xInstance->xBootstrap->onBoot();
        return self::$xInstance;
    }


    /**
     * The constructor
     */
    private function __construct()
    {}


    /**
     * The current Jaxon version
     *
     * @return string
     */
    public function getVersion(): string
    {
        return self::VERSION;
    }


    /**
     * Get the DI container
     *
     * @return Container
     */
    public function di(): ?Container
    {
        return self::$xContainer;
    }


    /**
     * Get the logger
     *
     * @return LoggerInterface
     */
    public function logger(): LoggerInterface
    {
        return $this->di()->logger();
    }


    /**
     * Set the value of a config option
     *
     * @param string $sName    The option name

     * @param mixed $sValue    The option value

     *
     * @return void
     */
    public function setOption(string $sName, $sValue)
    {
        $this->xConfigManager->setOption($sName, $sValue);
    }


    /**
     * Get the value of a config option
     *
     * @param string $sName    The option name

     * @param mixed|null $xDefault    The default value, to be returned if the option is not defined

     *
     * @return mixed        The option value, or null if the option is unknown
     */
    public function getOption(string $sName, $xDefault = null)
    {
        return $this->xConfigManager->getOption($sName, $xDefault);
    }


    /**
     * Check the presence of a config option
     *
     * @param string $sName    The option name

     *
     * @return bool        True if the option exists, and false if not
     */
    public function hasOption(string $sName): bool
    {
        return $this->xConfigManager->hasOption($sName);
    }


    /**
     * Read the options from the file, if provided, and return the config
     *
     * @param string $sConfigFile The full path to the config file

     * @param string $sConfigSection The section of the config file to be loaded
     *
     * @return ConfigManager
     * @throws SetupException
     */
    public function config(string $sConfigFile = '', string $sConfigSection = ''): ConfigManager
    {
        if(!empty(($sConfigFile = trim($sConfigFile))))

        {
            $this->xConfigManager->load($sConfigFile, trim($sConfigSection));
        }
        return $this->xConfigManager;
    }


    /**
     * Get a translated string
     *
     * @param string $sText    The key of the translated string

     * @param array $aPlaceHolders    The placeholders of the translated string

     * @param string $sLanguage    The language of the translated string

     *
     * @return string
     */
    public function trans(string $sText, array $aPlaceHolders = [], string $sLanguage = ''): string
    {
        return $this->xTranslator->trans($sText, $aPlaceHolders, $sLanguage);
    }


    /**
     * Get the Response object
     *
     * @return ResponseInterface
     */
    public function getResponse(): ResponseInterface
    {
        if(($xResponse = $this->xResponseManager->getResponse()))

        {
            return $xResponse;
        }
        return $this->di()->getResponse();
    }


    /**
     * Create a new Jaxon response object
     *
     * @return Response
     */
    public function newResponse(): Response
    {
        return $this->di()->newResponse();
    }


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

     * @param string $sPluginName    The plugin name

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

     *
     * @return void
     * @throws SetupException
     */
    public function registerPlugin(string $sClassName, string $sPluginName, int $nPriority = 1000)
    {
        $this->xPluginManager->registerPlugin($sClassName, $sPluginName, $nPriority);
    }


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

     * @param array $xPkgOptions    The user provided package options

     *
     * @return void
     * @throws SetupException
     */
    public function registerPackage(string $sClassName, array $xPkgOptions = [])
    {
        $this->xPackageManager->registerPackage($sClassName, $xPkgOptions);
    }


    /**
     * Register request handlers, including functions, callable classes and directories.
     *
     * @param string $sType    The type of request handler being registered

     *        Options include:

     *        - Jaxon::CALLABLE_FUNCTION: a function declared at global scope

     *        - Jaxon::CALLABLE_CLASS: a class who's methods are to be registered

     *        - Jaxon::CALLABLE_DIR: a directory containing classes to be registered

     * @param string $sName

     *        When registering a function, this is the name of the function
     *        When registering a callable class, this is the class name
     *        When registering a callable directory, this is the full path to the directory
     * @param array|string $xOptions    The related options

     *
     * @return void
     * @throws SetupException
     */
    public function register(string $sType, string $sName, $xOptions = [])
    {
        $this->xPluginManager->registerCallable($sType, $sName, $xOptions);
    }


    /**
     * Get an instance of a registered class
     *
     * @param string $sClassName The class name
     *
     * @return null|object
     * @throws SetupException
     */
    public function instance(string $sClassName)
    {
        $xCallable = $this->xClassRegistry->getCallableObject($sClassName);
        return ($xCallable) ? $xCallable->getRegisteredObject() : null;

    }


    /**
     * Get the factory
     *
     * @return Factory
     */
    public function factory(): Factory
    {
        return $this->di()->g(Factory::class);
    }


    /**
     * Get a request to a registered class
     *
     * @param string $sClassName The class name
     *
     * @return RequestFactory|null
     * @throws SetupException
     */
    public function request(string $sClassName = ''): ?RequestFactory
    {
        return $this->factory()->request($sClassName);
    }


    /**
     * Returns the Jaxon Javascript header and wrapper code to be printed into the page
     *
     * The javascript code returned by this function is dependent on the plugins
     * that are included and the functions and classes that are registered.
     *
     * @param bool $bIncludeJs    Also get the JS files

     * @param bool $bIncludeCss    Also get the CSS files

     *
     * @return string
     * @throws UriException
     */
    public function getScript(bool $bIncludeJs = false, bool $bIncludeCss = false): string
    {
        return $this->xCodeGenerator->getScript($bIncludeJs, $bIncludeCss);
    }


    /**
     * Return the javascript header code and file includes
     *
     * @return string
     */
    public function getJs(): string
    {
        return $this->xCodeGenerator->getJs();
    }


    /**
     * Return the CSS header code and file includes
     *
     * @return string
     */
    public function getCss(): string
    {
        return $this->xCodeGenerator->getCss();
    }


    /**
     * Determine if a call is a jaxon request or a page load request
     *
     * @return bool
     */
    public function canProcessRequest(): bool
    {
        return $this->di()->getRequestHandler()->canProcessRequest();
    }


    /**
     * If this is a jaxon request, call the requested PHP function, build the response and send it back to the browser
     *
     * This is the main server side engine for Jaxon.
     * It handles all the incoming requests, including the firing of events and handling of the response.
     * If your RequestURI is the same as your web page, then this function should be called before ANY
     * headers or HTML is output from your script.
     *
     * This function may exit after the request is processed, if the 'core.process.exit' option is set to true.
     *
     * @return void
     *
     * @throws RequestException
     * @see <Jaxon\Jaxon->canProcessRequest>
     */
    public function processRequest()
    {
        // Check to see if headers have already been sent out, in which case we can't do our job
        if(headers_sent($sFilename, $nLineNumber))
        {
            $sMessage = $this->xTranslator->trans('errors.output.already-sent', [
                'location' => $sFilename . ':' . $nLineNumber
            ]) . "\n" . $this->xTranslator->trans('errors.output.advice');
            throw new RequestException($sMessage);
        }

        $this->di()->getRequestHandler()->processRequest();

        // Clean the processing buffer
        if(($this->xConfigManager->getOption('core.process.clean')))
        {
            $er = error_reporting(0);
            while(ob_get_level() > 0)
            {
                ob_end_clean();
            }
            error_reporting($er);
        }
        if($this->xConfigManager->getOption('core.response.send'))
        {
            $this->sendResponse();
        }
    }


    /**
     * Prints the response to the output stream, thus sending the response to the browser
     *
     * @return void
     */
    public function sendResponse()
    {
        if(empty($sContent = $this->xResponseManager->getOutput()))

        {
            return;
        }
        if($this->di()->getRequest()->getMethod() === 'GET')
        {
            header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
            header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
            header("Cache-Control: no-cache, must-revalidate");
            header("Pragma: no-cache");
        }
        header('content-type: ' . $this->xResponseManager->getContentType());
        print $sContent;
        if($this->xConfigManager->getOption('core.process.exit'))
        {
            exit();

        }
    }


    /**
     * Get a registered response plugin
     *
     * @param string $sName    The name of the plugin

     *
     * @return ResponsePlugin|null
     */
    public function plugin(string $sName): ?ResponsePlugin
    {
        return $this->xPluginManager->getResponsePlugin($sName);
    }


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

     *
     * @return Package|null
     */
    public function package(string $sClassName): ?Package
    {
        return $this->xPackageManager->getPackage($sClassName);
    }


    /**
     * Get the upload plugin
     *
     * @return UploadHandler|null
     */
    public function upload(): ?UploadHandler
    {
        return $this->di()->getUploadHandler();
    }


    /**
     * Get the request callback manager
     *
     * @return CallbackManager
     */
    public function callback(): CallbackManager
    {
        return $this->di()->getCallbackManager();
    }


    /**
     * Get the template engine
     *
     * @return TemplateEngine
     */
    public function template(): TemplateEngine
    {
        return $this->di()->getTemplateEngine();
    }


    /**
     * Get the App instance
     *
     * @return App
     */
    public function app(): App
    {
        return $this->di()->getApp();
    }


    /**
     * Get the view renderer
     *
     * @return ViewRenderer
     */
    public function view(): ViewRenderer
    {
        return $this->di()->getViewRenderer();
    }


    /**
     * Get the paginator
     *
     * @return Paginator
     */
    public function paginator(): Paginator
    {
        return $this->di()->getPaginator();
    }


    /**
     * Get the session manager
     *
     * @return SessionInterface
     */
    public function session(): SessionInterface
    {
        return $this->di()->getSessionManager();
    }


    /**
     * Reset the library and container instances
     *
     * @return void
     * @throws SetupException
     */
    public function reset()
    {
        self::$xInstance = null;
        self::$xContainer = null;
        // Need to register the default plugins.
        self::getInstance()->di()->getPluginManager()->registerPlugins();
    }

}


1			<?php
2
3			/**
4			* Jaxon.php - Jaxon class
5			*
6			* The Jaxon class uses a modular plug-in system to facilitate the processing
7			* of special Ajax requests made by a PHP page.
8			* It generates Javascript that the page must include in order to make requests.
9			* It handles the output of response commands (see <Jaxon\Response\Response>).
10			* Many flags and settings can be adjusted to effect the behavior of the Jaxon class
11			* as well as the client-side javascript.
12			*
13			* @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...
14			* @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...
15			* @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...
16			* @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...
17			* @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...
18			* @author Thierry Feuzeu <[email protected]>
19			* @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...
20			* @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...
21			* @copyright 2016 Thierry Feuzeu <[email protected]>
22			* @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
23			* @link https://github.com/jaxon-php/jaxon-core
24			*/
			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...
25
26			namespace Jaxon;
27
28			use Jaxon\App\App;
29			use Jaxon\App\Bootstrap;
30			use Jaxon\Config\ConfigManager;
31			use Jaxon\Di\Container;
32			use Jaxon\Exception\RequestException;

jaxon-php / jaxon-core

Push — master ( 6eb156...b34d93 )

Jaxon::paginator() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like