phpOMS/Pattern/Mediator.php
2016-08-06 14:54:45 +02:00

102 lines
2.2 KiB
PHP

<?php
/**
* Orange Management
*
* PHP Version 7.0
*
* @category TBD
* @package TBD
* @author OMS Development Team <dev@oms.com>
* @author Dennis Eichhorn <d.eichhorn@oms.com>
* @copyright 2013 Dennis Eichhorn
* @license OMS License 1.0
* @version 1.0.0
* @link http://orange-management.com
*/
namespace phpOMS\Pattern;
/**
* Mediator.
*
* @category Pattern
* @package Framework
* @author OMS Development Team <dev@oms.com>
* @author Dennis Eichhorn <d.eichhorn@oms.com>
* @license OMS License 1.0
* @link http://orange-management.com
* @since 1.0.0
*/
interface Mediator extends \Countable
{
/**
* Attach a listener.
*
* Listeners will get called if a certain event gets triggered
*
* @param string $group Group
* @param \Closure $callback Function to call if the event gets triggered
* @param bool $remove Remove event after execution
*
* @return void
*
* @since 1.0.0
* @author Dennis Eichhorn <d.eichhorn@oms.com>
*/
public function attach(string $group, \Closure $callback, bool $remove = false);
/**
* Removing a event.
*
* @param string $group Group
*
* @return bool
*
* @since 1.0.0
* @author Dennis Eichhorn <d.eichhorn@oms.com>
*/
public function detach(string $group) : bool;
/**
* Has outstanding.
*
* @param string $group Group
*
* @return bool
*
* @since 1.0.0
* @author Dennis Eichhorn <d.eichhorn@oms.com>
*/
private function hasOutstanding(string $group) : bool;
/**
* Add group.
*
* Add new element to group
*
* @param string $id Event ID
* @param string $group Group
*
* @return void
*
* @since 1.0.0
* @author Dennis Eichhorn <d.eichhorn@oms.com>
*/
public function addGroup(string $id, string $group);
/**
* Trigger event.
*
* An object fires an event
*
* @param string $id Event ID
* @param string $group Group
*
* @return void
*
* @since 1.0.0
* @author Dennis Eichhorn <d.eichhorn@oms.com>
*/
public function trigger(string $id, string $group);
}