Call::hasPageNumber() - Code Metrics - Inspection of "Improved the dialog plugin system." - jaxon-php/jaxon-core - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — v5.x ( 57c2ac...73bdb8 )

by Thierry
created 2024-05-10 11:04 UTC
Call::hasPageNumber() A

↳ Parent: Call
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Importance

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

/**
 * Call.php - The Jaxon Call
 *
 * This class is used to create js ajax requests to callable classes and functions.
 *
 * @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\Call;

use Jaxon\App\Dialog\Library\DialogLibraryManager;

use function array_shift;
use function func_get_args;

class Call extends JsCall

{
    /**
     * @var DialogLibraryManager
     */
    protected $xLibraryManager;


    /**
     * The arguments of the else() calls
     *
     * @var array
     */
    protected $aMessage = [];

    /**
     * A condition to check before making the call
     *
     * @var array
     */
    protected $aCondition = [];

    /**
     * The arguments of the confirm() call
     *
     * @var array
     */
    protected $aConfirm = [];

    /**
     * The constructor.
     *
     * @param string $sName    The javascript function or method name

     * @param DialogLibraryManager $xLibraryManager

     */
    public function __construct(string $sName, DialogLibraryManager $xLibraryManager)

    {
        parent::__construct($sName);
        $this->xLibraryManager = $xLibraryManager;
    }


    /**
     * @param array $aArgs

     *
     * @return array
     */
    private function getArgs(array $aArgs): array
    {
        array_shift($aArgs);
        return $aArgs;
    }


    /**
     * Show a message if the condition to the call is not met
     *
     * @param string $sMessage  The message to show

     *
     * @return Call
     */
    public function elseShow(string $sMessage): Call
    {
        $this->aMessage = $this->xLibraryManager->warning($sMessage, $this->getArgs(func_get_args()));
        return $this;
    }


    /**
     * Show an information message if the condition to the call is not met
     *
     * @param string $sMessage  The message to show

     *
     * @return Call
     */
    public function elseInfo(string $sMessage): Call
    {
        $this->aMessage = $this->xLibraryManager->info($sMessage, $this->getArgs(func_get_args()));
        return $this;
    }


    /**
     * Show a success message if the condition to the call is not met
     *
     * @param string $sMessage  The message to show

     *
     * @return Call
     */
    public function elseSuccess(string $sMessage): Call
    {
        $this->aMessage = $this->xLibraryManager->success($sMessage, $this->getArgs(func_get_args()));
        return $this;
    }


    /**
     * Show a warning message if the condition to the call is not met
     *
     * @param string $sMessage  The message to show

     *
     * @return Call
     */
    public function elseWarning(string $sMessage): Call
    {
        $this->aMessage = $this->xLibraryManager->warning($sMessage, $this->getArgs(func_get_args()));
        return $this;
    }


    /**
     * Show an error message if the condition to the call is not met
     *
     * @param string $sMessage  The message to show

     *
     * @return Call
     */
    public function elseError(string $sMessage): Call
    {
        $this->aMessage = $this->xLibraryManager->error($sMessage, $this->getArgs(func_get_args()));
        return $this;
    }


    /**
     * Add a confirmation question to the request
     *
     * @param string $sQuestion    The question to ask

     *
     * @return Call
     */
    public function confirm(string $sQuestion): Call
    {
        $this->aConfirm = $this->xLibraryManager->confirm($sQuestion, $this->getArgs(func_get_args()));
        return $this;
    }


    /**
     * Add a condition to the request
     *
     * The request is sent only if the condition is true.
     *
     * @param mixed $xCondition    The condition to check

     *
     * @return Call
     */
    public function when($xCondition): Call
    {
        $this->aCondition = [true, Parameter::make($xCondition)];
        return $this;
    }


    /**
     * Add a condition to the request
     *
     * The request is sent only if the condition is false.
     *
     * @param mixed $xCondition    The condition to check

     *
     * @return Call
     */
    public function unless($xCondition): Call
    {
        $this->aCondition = [false, Parameter::make($xCondition)];
        return $this;
    }


    /**
     * Check if a value is equal to another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifeq($xValue1, $xValue2): Call
    {
        $this->aCondition = ['==', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is equal to another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifteq($xValue1, $xValue2): Call
    {
        $this->aCondition = ['===', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is not equal to another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifne($xValue1, $xValue2): Call
    {
        $this->aCondition = ['!=', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is not equal to another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifnte($xValue1, $xValue2): Call
    {
        $this->aCondition = ['!==', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is greater than another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifgt($xValue1, $xValue2): Call
    {
        $this->aCondition = ['>', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is greater or equal to another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifge($xValue1, $xValue2): Call
    {
        $this->aCondition = ['>=', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is lower than another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function iflt($xValue1, $xValue2): Call
    {
        $this->aCondition = ['<', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Check if a value is lower or equal to another before sending the request
     *
     * @param mixed $xValue1    The first value to compare

     * @param mixed $xValue2    The second value to compare

     *
     * @return Call
     */
    public function ifle($xValue1, $xValue2): Call
    {
        $this->aCondition = ['<=', Parameter::make($xValue1), Parameter::make($xValue2)];
        return $this;
    }


    /**
     * Convert this call to array
     *
     * @return array
     */
    public function toArray(): array
    {
        $aCall = parent::toArray();
        if(($this->aConfirm))

        {
            $aCall['confirm'] = [
                ...$this->aConfirm,
                'lib' => $this->xLibraryManager->getQuestionLibrary()->getName(),
            ];
        }
        if(($this->aCondition))

        {
            $aCall['condition'] = $this->aCondition;
        }
        if(($this->aMessage))

        {
            $aCall['else'] = [
                ...$this->aMessage,
                'lib' => $this->xLibraryManager->getMessageLibrary()->getName(),
            ];
        }
        return $aCall;
    }


    /**
     * Check if the request has a parameter of type Parameter::PAGE_NUMBER
     *
     * @return ParameterInterface|null
     */
    private function findPageNumber(): ?ParameterInterface
    {
        foreach($this->aParameters as $xParameter)
        {
            if($xParameter->getType() === Parameter::PAGE_NUMBER)
            {
                return $xParameter;
            }
        }
        return null;
    }


    /**
     * Check if the request has a parameter of type Parameter::PAGE_NUMBER
     *
     * @return bool
     */
    public function hasPageNumber(): bool
    {
        return $this->findPageNumber() !== null;
    }


    /**
     * Set a value to the Parameter::PAGE_NUMBER parameter
     *
     * @param integer $nPageNumber    The current page number

     *
     * @return Call
     */
    public function setPageNumber(int $nPageNumber): Call
    {
        /** @var Parameter */

        $xParameter = $this->findPageNumber();
        if($xParameter !== null)
        {
            $xParameter->setValue($nPageNumber);
                         setValue($nPageNumber);
        }
        return $this;
    }

}

jaxon-php / jaxon-core

Push — v5.x ( 57c2ac...73bdb8 )

Call::hasPageNumber() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
