CoreFiles by mySites.guru
BeforeMoveEvent.php113 lines, 2,805 bytes, from Joomla_4.0.0-alpha3-Alpha-Full_Package.zip
Raw History Compare with 4.0.0-alpha2
md5
64ae4ab0a9c86c8aee28c50b8edca13c
sha1
0fed5fcb267bc8db96e4ca6528e32cf2fd876eb0
sha256
7156b3e88142eac77d628495f607bc8b3f39613c46788ad2a30d7f4d6b650364
<?php
/**
 * Joomla! Content Management System
 *
 * @copyright  Copyright (C) 2005 - 2018 Open Source Matters, Inc. All rights reserved.
 * @license    GNU General Public License version 2 or later; see LICENSE
 */

namespace Joomla\CMS\Event\Table;

defined('JPATH_PLATFORM') or die;

use BadMethodCallException;
use JDatabaseQuery;

/**
 * Event class for JTable's onBeforeMove event
 *
 * @since  4.0.0
 */
class BeforeMoveEvent extends AbstractEvent
{
	/**
	 * Constructor.
	 *
	 * Mandatory arguments:
	 * subject		JTableInterface	The table we are operating on
	 * query		JDatabaseQuery	The query to get the primary keys and ordering values for the selection.
	 * delta		int				The direction and magnitude to move the row in the ordering sequence.
	 * where		string			WHERE clause to use for limiting the selection of rows to compact the ordering values.
	 *
	 * @param   string  $name       The event name.
	 * @param   array   $arguments  The event arguments.
	 *
	 * @throws  BadMethodCallException
	 */
	public function __construct($name, array $arguments = array())
	{
		if (!array_key_exists('query', $arguments))
		{
			throw new BadMethodCallException("Argument 'query' is required for event $name");
		}

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

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

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

	/**
	 * Setter for the query argument
	 *
	 * @param   JDatabaseQuery  $value  The value to set
	 *
	 * @return  mixed
	 *
	 * @throws  BadMethodCallException  if the argument is not of the expected type
	 */
	protected function setQuery($value)
	{
		if (!($value instanceof JDatabaseQuery))
		{
			throw new BadMethodCallException("Argument 'query' of event {$this->name} must be of JDatabaseQuery type");
		}

		return $value;
	}

	/**
	 * Setter for the delta argument
	 *
	 * @param   int  $value  The value to set
	 *
	 * @return  int
	 *
	 * @throws  BadMethodCallException  if the argument is not of the expected type
	 */
	protected function setDelta($value)
	{
		if (!is_numeric($value))
		{
			throw new BadMethodCallException("Argument 'delta' of event {$this->name} must be an integer");
		}

		return (int) $value;
	}

	/**
	 * Setter for the where argument
	 *
	 * @param   string|null  $value  The value to set
	 *
	 * @return  mixed
	 *
	 * @throws  BadMethodCallException  if the argument is not of the expected type
	 */
	protected function setWhere($value)
	{
		if (!empty($value) && !is_string($value))
		{
			throw new BadMethodCallException("Argument 'where' of event {$this->name} must be empty or string");
		}

		return $value;
	}
}

No other release has this exact content. See every version of this file.