CoreFiles by mySites.guru
BeforeBindEvent.php87 lines, 2,127 bytes, from Joomla_4.0.2-Stable-Full_Package.zip
Raw History Compare with 4.0.1
md5
330450681541ea344ddf4ba853ecf1a0
sha1
beaf5f164e39b6b75842cf201785e129a1aba35e
sha256
235746ebcd1780e4204ec4fdfb39483c00090e0bef71212aca43c299383e88e6
<?php
/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2016 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE
 */

namespace Joomla\CMS\Event\Table;

\defined('JPATH_PLATFORM') or die;

use BadMethodCallException;

/**
 * Event class for JTable's onBeforeBind event
 *
 * @since  4.0.0
 */
class BeforeBindEvent extends AbstractEvent
{
	/**
	 * Constructor.
	 *
	 * Mandatory arguments:
	 * subject		JTableInterface	The table we are operating on
	 * src			mixed			An associative array or object to bind to the JTable instance.
	 * ignore		mixed			An optional array or space separated list of properties to ignore while binding.
	 *
	 * @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('src', $arguments))
		{
			throw new BadMethodCallException("Argument 'src' is required for event $name");
		}

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

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

	/**
	 * Setter for the src argument
	 *
	 * @param   mixed  $value  The value to set
	 *
	 * @return  mixed
	 *
	 * @throws  BadMethodCallException  if the argument is not of the expected type
	 */
	protected function setSrc($value)
	{
		if (!empty($value) && !\is_object($value) && !\is_array($value))
		{
			throw new BadMethodCallException("Argument 'src' of event {$this->name} must be empty, object or array");
		}

		return $value;
	}

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

		return $value;
	}
}

The same content is in 51 releases, Joomla 4.0.0-beta6 to 4.2.0-beta2. See them all, or every version of this file.