Jaxon\Plugin\AbstractResponsePlugin

Complexity

Total Complexity

4

Size/Duplication

Total Lines	50
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	_init()	0	5	1
A	response()	0	3	1
A	init()	0	2	1
A	addCommand()	0	5	1

<?php

/**
 * AbstractResponsePlugin.php
 *
 * Interface for Jaxon Response plugins.
 *
 * A response plugin provides additional services not already provided by the
 * <Jaxon\Response\Response> class with regard to sending response commands to the client.
 * In addition, a response command may send javascript to the browser at page load
 * to aid in the processing of its response commands.
 *
 * @package jaxon-core
 * @author Jared White
 * @author J. Max Wilson
 * @author Joseph Woolley
 * @author Steffen Konerow
 * @author Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @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 <thierry.feuzeu@gmail.com>
 * @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\Script\JqCall;
use Jaxon\Plugin\Response\DataBag\DataBagContext;
use Jaxon\Response\AbstractResponse;
use Jaxon\Response\Command;
use JsonSerializable;

/**
 * @method JqCall jq(string $sPath = '', $xContext = null)
 * @method DataBagContext bag(string $sName)
 */
abstract class AbstractResponsePlugin extends AbstractPlugin implements ResponsePluginInterface
{
    /**
     * The object used to build the response that will be sent to the client browser
     *
     * @var AbstractResponse
     */
    private $xResponse = null;

    /**
     * Initialize the plugin
     *
     * @return void
     */
    protected function init()
    {}

    /**
     * @param AbstractResponse $xResponse   The response
     *
     * @return self
     */
    public function _init(AbstractResponse $xResponse): self
    {
        $this->xResponse = $xResponse;
        $this->init();
        return $this;
    }

    /**
     * @inheritDoc
     */
    public function response(): ?AbstractResponse
    {
        return $this->xResponse;
    }

    /**
     * Add a plugin command to the response
     *
     * @param string $sName    The command name
     * @param array|JsonSerializable $aOptions    The command options
     *
     * @return Command
     */
    public function addCommand(string $sName, array|JsonSerializable $aOptions): Command
    {
        return $this->xResponse
            ->addCommand($sName, $aOptions)
            ->setOption('plugin', $this->getName());
    }
}