944d91c1df
When an object has a "main" many relation with related "things" (objects, parameters, ...), the method names are normalized: * get() * set() * all() * replace() * remove() * clear() * isEmpty() * add() * register() * count() * keys() The classes below follow this method naming convention: * BrowserKit\CookieJar -> Cookie * BrowserKit\History -> Request * Console\Application -> Command * Console\Application\Helper\HelperSet -> HelperInterface * DependencyInjection\Container -> services * DependencyInjection\ContainerBuilder -> services * DependencyInjection\ParameterBag\ParameterBag -> parameters * DependencyInjection\ParameterBag\FrozenParameterBag -> parameters * DomCrawler\Form -> FormField * EventDispatcher\Event -> parameters * Form\FieldGroup -> Field * HttpFoundation\HeaderBag -> headers * HttpFoundation\ParameterBag -> parameters * HttpFoundation\Session -> attributes * HttpKernel\Profiler\Profiler -> DataCollectorInterface * Routing\RouteCollection -> Route * Security\Authentication\AuthenticationProviderManager -> AuthenticationProviderInterface * Templating\Engine -> HelperInterface * Translation\MessageCatalogue -> messages The usage of these methods are only allowed when it is clear that there is a main relation: * a CookieJar has many Cookies; * a Container has many services and many parameters (as services is the main relation, we use the naming convention for this relation); * a Console Input has many arguments and many options. There is no "main" relation, and so the naming convention does not apply. For many relations where the convention does not apply, the following methods must be used instead (where XXX is the name of the related thing): * get() -> getXXX() * set() -> setXXX() * all() -> getXXXs() * replace() -> setXXXs() * remove() -> removeXXX() * clear() -> clearXXX() * isEmpty() -> isEmptyXXX() * add() -> addXXX() * register() -> registerXXX() * count() -> countXXX() * keys()
76 lines
2.9 KiB
PHP
76 lines
2.9 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Symfony package.
|
|
* (c) Fabien Potencier <fabien.potencier@symfony-project.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Symfony\Tests\Component\EventDispatcher;
|
|
|
|
use Symfony\Component\EventDispatcher\Event;
|
|
|
|
class EventTest extends \PHPUnit_Framework_TestCase
|
|
{
|
|
protected $subject;
|
|
protected $parameters;
|
|
|
|
public function testGetSubject()
|
|
{
|
|
$event = $this->createEvent();
|
|
$this->assertEquals($this->subject, $event->getSubject(), '->getSubject() returns the event subject');
|
|
}
|
|
|
|
public function testGetName()
|
|
{
|
|
$this->assertEquals('name', $this->createEvent()->getName(), '->getName() returns the event name');
|
|
}
|
|
|
|
public function testParameters()
|
|
{
|
|
$event = $this->createEvent();
|
|
|
|
$this->assertEquals($this->parameters, $event->all(), '->all() returns the event parameters');
|
|
$this->assertEquals('bar', $event->get('foo'), '->get() returns the value of a parameter');
|
|
$event->set('foo', 'foo');
|
|
$this->assertEquals('foo', $event->get('foo'), '->set() changes the value of a parameter');
|
|
$this->assertTrue($event->has('foo'), '->has() returns true if the parameter is defined');
|
|
$this->assertFalse($event->has('oof'), '->has() returns false if the parameter is not defined');
|
|
|
|
try {
|
|
$event->get('foobar');
|
|
$this->fail('->get() throws an \InvalidArgumentException exception when the parameter does not exist');
|
|
} catch (\Exception $e) {
|
|
$this->assertInstanceOf('\InvalidArgumentException', $e, '->get() throws an \InvalidArgumentException exception when the parameter does not exist');
|
|
$this->assertEquals('The event "name" has no "foobar" parameter.', $e->getMessage(), '->get() throws an \InvalidArgumentException exception when the parameter does not exist');
|
|
}
|
|
$event = new Event($this->subject, 'name', $this->parameters);
|
|
}
|
|
|
|
public function testSetGetReturnValue()
|
|
{
|
|
$event = $this->createEvent();
|
|
$event->setReturnValue('foo');
|
|
$this->assertEquals('foo', $event->getReturnValue(), '->getReturnValue() returns the return value of the event');
|
|
}
|
|
|
|
public function testSetIsProcessed()
|
|
{
|
|
$event = $this->createEvent();
|
|
$event->setProcessed(true);
|
|
$this->assertTrue($event->isProcessed(), '->isProcessed() returns true if the event has been processed');
|
|
$event->setProcessed(false);
|
|
$this->assertFalse($event->isProcessed(), '->setProcessed() changes the processed status');
|
|
}
|
|
|
|
protected function createEvent()
|
|
{
|
|
$this->subject = new \stdClass();
|
|
$this->parameters = array('foo' => 'bar');
|
|
|
|
return new Event($this->subject, 'name', $this->parameters);
|
|
}
|
|
}
|