CoreFiles by mySites.guru
ExecuteTaskEvent.php96 lines, 2,323 bytes, from Joomla_4.3.0-alpha1-Alpha-Full_Package.zip
Raw History Compare with 4.2.0-alpha3
md5
60b0fc7ceac000abfb02d685dc4b50c9
sha1
97f98a6ba19efce00fc25e18dfbb93b3dc73b875
sha256
20e4a2f2672baa49e46ab327e003ce3a52b0692692ce1fb7c76d2751a870381f
<?php

/**
 * @package     Joomla.Administrator
 * @subpackage  com_scheduler
 *
 * @copyright   (C) 2021 Open Source Matters, Inc. <https://www.joomla.org>
 * @license     GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\Component\Scheduler\Administrator\Event;

use Joomla\CMS\Event\AbstractEvent;
use Joomla\Component\Scheduler\Administrator\Task\Task;

// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Event class for onExecuteTask event.
 *
 * @since  4.1.0
 */
class ExecuteTaskEvent extends AbstractEvent
{
    /**
     * Constructor.
     *
     * @param   string  $name       The event name.
     * @param   array   $arguments  The event arguments.
     *
     * @since  4.1.0
     * @throws  \BadMethodCallException
     */
    public function __construct($name, array $arguments = array())
    {
        parent::__construct($name, $arguments);

        $arguments['resultSnapshot'] = null;

        if (!($arguments['subject'] ?? null) instanceof Task) {
            throw new \BadMethodCallException("The subject given for $name event must be an instance of " . Task::class);
        }
    }

    /**
     * Sets the task result snapshot and stops event propagation.
     *
     * @param   array  $snapshot  The task snapshot.
     *
     * @return  void
     *
     * @since  4.1.0
     */
    public function setResult(array $snapshot = []): void
    {
        $this->arguments['resultSnapshot'] = $snapshot;

        if (!empty($snapshot)) {
            $this->stopPropagation();
        }
    }

    /**
     * @return integer  The task's taskId.
     *
     * @since  4.1.0
     */
    public function getTaskId(): int
    {
        return $this->arguments['subject']->get('id');
    }

    /**
     * @return  string  The task's 'type'.
     *
     * @since  4.1.0
     */
    public function getRoutineId(): string
    {
        return $this->arguments['subject']->get('type');
    }

    /**
     * Returns the snapshot of the triggered task if available, else an empty array
     *
     * @return  array  The task snapshot if available, else null
     *
     * @since  4.1.0
     */
    public function getResultSnapshot(): array
    {
        return $this->arguments['resultSnapshot'] ?? [];
    }
}

The same content is in 11 releases, Joomla 4.2.1 to 4.3.0-alpha2. See them all, or every version of this file.