CoreFiles by mySites.guru
OnGetApiAttributes.php96 lines, 2,532 bytes, from Joomla_4.2.0-Stable-Full_Package.zip
Raw History Compare with 4.1.5
md5
2cc85fd36e7b9bdab293d488b0f1bd86
sha1
022498d6fef404be856cf7004b8d90251ebde9de
sha256
b06f17285af65e08db09820662ceb63eff763781ecb9795c6bb2b79d6beafd1b
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2020 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Serializer\Events;

use Joomla\CMS\Event\AbstractImmutableEvent;

/**
 * Event for getting extra data attributes for an API Entity
 *
 * @since  4.0.0
 */
final class OnGetApiAttributes extends AbstractImmutableEvent
{
    /**
     * The attributes
     *
     * @var     array
     * @since   4.0.0
     */
    private $attributes = [];

    /**
     * Constructor.
     *
     * Mandatory arguments:
     * attributes   array           The main data for the object.
     * context      string          The content type of the api resource.
     *
     * @param   string  $name       The event name.
     * @param   array   $arguments  The event arguments.
     *
     * @since   4.0.0
     * @throws  \BadMethodCallException
     */
    public function __construct($name, array $arguments = array())
    {
        if (
            !\array_key_exists('attributes', $arguments)
            || \array_key_exists('attributes', $arguments) && !is_array($arguments['attributes'])
        ) {
            throw new \BadMethodCallException("Argument 'attributes' as an array is required for event $name");
        }

        if (!\array_key_exists('context', $arguments)) {
            throw new \BadMethodCallException("Argument 'context' is required for event $name");
        }

        parent::__construct($name, $arguments);
    }

    /**
     * The properties to be rendered.
     *
     * @return  array
     *
     * @since   4.0.0
     */
    public function getAttributes(): array
    {
        return $this->attributes;
    }

    /**
     * Set a named attribute to be rendered in the API.
     *
     * @param   string  $name   The name of the property to be rendered in the api
     * @param   mixed   $value  The value of the named property to be rendered in the api.
     *
     * @return  void
     * @since   4.0.0
     */
    public function addAttribute($name, $value): void
    {
        $this->attributes[$name] = $value;
    }

    /**
     * Set attributes to be rendered in the API.
     *
     * @param   array  $value  An array of key/value pairs for properties to be added to the api.
     *
     * @return  void
     * @since   4.0.0
     */
    public function addAttributes(array $value): void
    {
        $this->attributes = array_merge($this->attributes, $value);
    }
}

The same content is in 5 releases, Joomla 4.2.0-beta3 to 4.2.1-rc2. See them all, or every version of this file.