EventManagerTest.php 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996
  1. <?php
  2. /**
  3. * CakePHP : Rapid Development Framework (https://cakephp.org)
  4. * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
  5. *
  6. * Licensed under The MIT License
  7. * For full copyright and license information, please see the LICENSE.txt
  8. * Redistributions of files must retain the above copyright notice.
  9. *
  10. * @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
  11. * @link https://cakephp.org CakePHP Project
  12. * @since 2.1.0
  13. * @license https://opensource.org/licenses/mit-license.php MIT License
  14. */
  15. namespace Cake\Test\TestCase\Event;
  16. use Cake\Event\Event;
  17. use Cake\Event\EventList;
  18. use Cake\Event\EventListenerInterface;
  19. use Cake\Event\EventManager;
  20. use Cake\TestSuite\TestCase;
  21. /**
  22. * Mock class used to test event dispatching
  23. */
  24. class EventTestListener
  25. {
  26. public $callList = [];
  27. /**
  28. * Test function to be used in event dispatching
  29. *
  30. * @return void
  31. */
  32. public function listenerFunction()
  33. {
  34. $this->callList[] = __FUNCTION__;
  35. }
  36. /**
  37. * Test function to be used in event dispatching
  38. *
  39. * @return void
  40. */
  41. public function secondListenerFunction()
  42. {
  43. $this->callList[] = __FUNCTION__;
  44. }
  45. /**
  46. * Auxiliary function to help in stopPropagation testing
  47. *
  48. * @param \Cake\Event\Event $event
  49. * @return void
  50. */
  51. public function stopListener($event)
  52. {
  53. $event->stopPropagation();
  54. }
  55. }
  56. /**
  57. * Mock used for testing the subscriber objects
  58. */
  59. class CustomTestEventListenerInterface extends EventTestListener implements EventListenerInterface
  60. {
  61. public function implementedEvents()
  62. {
  63. return [
  64. 'fake.event' => 'listenerFunction',
  65. 'another.event' => ['callable' => 'secondListenerFunction'],
  66. 'multiple.handlers' => [
  67. ['callable' => 'listenerFunction'],
  68. ['callable' => 'thirdListenerFunction']
  69. ]
  70. ];
  71. }
  72. /**
  73. * Test function to be used in event dispatching
  74. *
  75. * @return void
  76. */
  77. public function thirdListenerFunction()
  78. {
  79. $this->callList[] = __FUNCTION__;
  80. }
  81. }
  82. /**
  83. * Tests the Cake\Event\EventManager class functionality
  84. */
  85. class EventManagerTest extends TestCase
  86. {
  87. /**
  88. * Tests the attach() method for a single event key in multiple queues
  89. *
  90. * @group deprecated
  91. * @return void
  92. */
  93. public function testAttachListeners()
  94. {
  95. $this->deprecated(function () {
  96. $manager = new EventManager();
  97. $manager->attach('fakeFunction', 'fake.event');
  98. $expected = [
  99. ['callable' => 'fakeFunction']
  100. ];
  101. $this->assertEquals($expected, $manager->listeners('fake.event'));
  102. $manager->attach('fakeFunction2', 'fake.event');
  103. $expected[] = ['callable' => 'fakeFunction2'];
  104. $this->assertEquals($expected, $manager->listeners('fake.event'));
  105. $manager->attach('inQ5', 'fake.event', ['priority' => 5]);
  106. $manager->attach('inQ1', 'fake.event', ['priority' => 1]);
  107. $manager->attach('otherInQ5', 'fake.event', ['priority' => 5]);
  108. $expected = array_merge(
  109. [
  110. ['callable' => 'inQ1'],
  111. ['callable' => 'inQ5'],
  112. ['callable' => 'otherInQ5']
  113. ],
  114. $expected
  115. );
  116. $this->assertEquals($expected, $manager->listeners('fake.event'));
  117. });
  118. }
  119. /**
  120. * Test attach() with a listener interface.
  121. *
  122. * @group deprecated
  123. * @return void
  124. */
  125. public function testAttachListener()
  126. {
  127. $this->deprecated(function () {
  128. $manager = new EventManager();
  129. $listener = new CustomTestEventListenerInterface();
  130. $manager->on($listener);
  131. $expected = [
  132. ['callable' => [$listener, 'listenerFunction']],
  133. ];
  134. $this->assertEquals($expected, $manager->listeners('fake.event'));
  135. });
  136. }
  137. /**
  138. * Tests the attach() method for multiple event key in multiple queues
  139. *
  140. * @group deprecated
  141. * @return void
  142. */
  143. public function testAttachMultipleEventKeys()
  144. {
  145. $this->deprecated(function () {
  146. $manager = new EventManager();
  147. $manager->attach('fakeFunction', 'fake.event');
  148. $manager->attach('fakeFunction2', 'another.event');
  149. $manager->attach('fakeFunction3', 'another.event', ['priority' => 1]);
  150. $expected = [
  151. ['callable' => 'fakeFunction']
  152. ];
  153. $this->assertEquals($expected, $manager->listeners('fake.event'));
  154. $expected = [
  155. ['callable' => 'fakeFunction3'],
  156. ['callable' => 'fakeFunction2']
  157. ];
  158. $this->assertEquals($expected, $manager->listeners('another.event'));
  159. });
  160. }
  161. /**
  162. * Tests attached event listeners for matching key pattern
  163. *
  164. * @return void
  165. */
  166. public function testMatchingListeners()
  167. {
  168. $manager = new EventManager();
  169. $manager->on('fake.event', 'fakeFunction1');
  170. $manager->on('real.event', 'fakeFunction2');
  171. $manager->on('test.event', 'fakeFunction3');
  172. $manager->on('event.test', 'fakeFunction4');
  173. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('fake.event'));
  174. $this->assertArrayHasKey('real.event', $manager->matchingListeners('real.event'));
  175. $this->assertArrayHasKey('test.event', $manager->matchingListeners('test.event'));
  176. $this->assertArrayHasKey('event.test', $manager->matchingListeners('event.test'));
  177. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('fake'));
  178. $this->assertArrayHasKey('real.event', $manager->matchingListeners('real'));
  179. $this->assertArrayHasKey('test.event', $manager->matchingListeners('test'));
  180. $this->assertArrayHasKey('event.test', $manager->matchingListeners('test'));
  181. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('event'));
  182. $this->assertArrayHasKey('real.event', $manager->matchingListeners('event'));
  183. $this->assertArrayHasKey('test.event', $manager->matchingListeners('event'));
  184. $this->assertArrayHasKey('event.test', $manager->matchingListeners('event'));
  185. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('.event'));
  186. $this->assertArrayHasKey('real.event', $manager->matchingListeners('.event'));
  187. $this->assertArrayHasKey('test.event', $manager->matchingListeners('.event'));
  188. $this->assertArrayHasKey('test.event', $manager->matchingListeners('test.'));
  189. $this->assertArrayHasKey('event.test', $manager->matchingListeners('.test'));
  190. $this->assertEmpty($manager->matchingListeners('/test'));
  191. $this->assertEmpty($manager->matchingListeners('test/'));
  192. $this->assertEmpty($manager->matchingListeners('/test/'));
  193. $this->assertEmpty($manager->matchingListeners('test$'));
  194. $this->assertEmpty($manager->matchingListeners('ev.nt'));
  195. $this->assertEmpty($manager->matchingListeners('^test'));
  196. $this->assertEmpty($manager->matchingListeners('^event'));
  197. $this->assertEmpty($manager->matchingListeners('*event'));
  198. $this->assertEmpty($manager->matchingListeners('event*'));
  199. $this->assertEmpty($manager->matchingListeners('foo'));
  200. $expected = ['fake.event', 'real.event', 'test.event', 'event.test'];
  201. $result = $manager->matchingListeners('event');
  202. $this->assertNotEmpty($result);
  203. $this->assertSame($expected, array_keys($result));
  204. $expected = ['fake.event', 'real.event', 'test.event'];
  205. $result = $manager->matchingListeners('.event');
  206. $this->assertNotEmpty($result);
  207. $this->assertSame($expected, array_keys($result));
  208. $expected = ['test.event', 'event.test'];
  209. $result = $manager->matchingListeners('test');
  210. $this->assertNotEmpty($result);
  211. $this->assertSame($expected, array_keys($result));
  212. $expected = ['test.event'];
  213. $result = $manager->matchingListeners('test.');
  214. $this->assertNotEmpty($result);
  215. $this->assertSame($expected, array_keys($result));
  216. $expected = ['event.test'];
  217. $result = $manager->matchingListeners('.test');
  218. $this->assertNotEmpty($result);
  219. $this->assertSame($expected, array_keys($result));
  220. }
  221. /**
  222. * Test the on() method for basic callable types.
  223. *
  224. * @return void
  225. */
  226. public function testOn()
  227. {
  228. $count = 1;
  229. $manager = new EventManager();
  230. $manager->on('my.event', 'myfunc');
  231. $expected = [
  232. ['callable' => 'myfunc']
  233. ];
  234. $this->assertSame($expected, $manager->listeners('my.event'));
  235. $manager->on('my.event', ['priority' => 1], 'func2');
  236. $expected = [
  237. ['callable' => 'func2'],
  238. ['callable' => 'myfunc'],
  239. ];
  240. $this->assertSame($expected, $manager->listeners('my.event'));
  241. $listener = new CustomTestEventListenerInterface();
  242. $manager->on($listener);
  243. $expected = [
  244. ['callable' => [$listener, 'listenerFunction']],
  245. ];
  246. $this->assertEquals($expected, $manager->listeners('fake.event'));
  247. }
  248. /**
  249. * Test the on() with invalid arguments
  250. *
  251. * @expectedException InvalidArgumentException
  252. * @expectedExceptionMessage Invalid arguments for EventManager::on(). Expected 1, 2 or 3 arguments.
  253. * @return void
  254. */
  255. public function testOnInvalidArgument()
  256. {
  257. $manager = new EventManager();
  258. $manager->on();
  259. }
  260. /**
  261. * Tests off'ing an event from a event key queue
  262. *
  263. * @return void
  264. */
  265. public function testOff()
  266. {
  267. $manager = new EventManager();
  268. $manager->on('fake.event', ['AClass', 'aMethod']);
  269. $manager->on('another.event', ['AClass', 'anotherMethod']);
  270. $manager->on('another.event', ['priority' => 1], 'fakeFunction');
  271. $manager->off('fake.event', ['AClass', 'aMethod']);
  272. $this->assertEquals([], $manager->listeners('fake.event'));
  273. $manager->off('another.event', ['AClass', 'anotherMethod']);
  274. $expected = [
  275. ['callable' => 'fakeFunction']
  276. ];
  277. $this->assertEquals($expected, $manager->listeners('another.event'));
  278. $manager->off('another.event', 'fakeFunction');
  279. $this->assertEquals([], $manager->listeners('another.event'));
  280. }
  281. /**
  282. * Tests off'ing an event from all event queues
  283. *
  284. * @return void
  285. */
  286. public function testOffFromAll()
  287. {
  288. $manager = new EventManager();
  289. $manager->on('fake.event', ['AClass', 'aMethod']);
  290. $manager->on('another.event', ['AClass', 'aMethod']);
  291. $manager->on('another.event', ['priority' => 1], 'fakeFunction');
  292. $manager->off(['AClass', 'aMethod']);
  293. $expected = [
  294. ['callable' => 'fakeFunction']
  295. ];
  296. $this->assertEquals($expected, $manager->listeners('another.event'));
  297. $this->assertEquals([], $manager->listeners('fake.event'));
  298. }
  299. /**
  300. * Tests off'ing all listeners for an event
  301. */
  302. public function testRemoveAllListeners()
  303. {
  304. $manager = new EventManager();
  305. $manager->on('fake.event', ['AClass', 'aMethod']);
  306. $manager->on('another.event', ['priority' => 1], 'fakeFunction');
  307. $manager->off('fake.event');
  308. $expected = [
  309. ['callable' => 'fakeFunction']
  310. ];
  311. $this->assertEquals($expected, $manager->listeners('another.event'));
  312. $this->assertEquals([], $manager->listeners('fake.event'));
  313. }
  314. /**
  315. * Tests detaching an event from a event key queue
  316. *
  317. * @group deprecated
  318. * @return void
  319. */
  320. public function testDetach()
  321. {
  322. $this->deprecated(function () {
  323. $manager = new EventManager();
  324. $manager->attach(['AClass', 'aMethod'], 'fake.event');
  325. $manager->attach(['AClass', 'anotherMethod'], 'another.event');
  326. $manager->attach('fakeFunction', 'another.event', ['priority' => 1]);
  327. $manager->detach(['AClass', 'aMethod'], 'fake.event');
  328. $this->assertEquals([], $manager->listeners('fake.event'));
  329. $manager->detach(['AClass', 'anotherMethod'], 'another.event');
  330. $expected = [
  331. ['callable' => 'fakeFunction']
  332. ];
  333. $this->assertEquals($expected, $manager->listeners('another.event'));
  334. $manager->detach('fakeFunction', 'another.event');
  335. $this->assertEquals([], $manager->listeners('another.event'));
  336. });
  337. }
  338. /**
  339. * Tests detaching an event from all event queues
  340. *
  341. * @group deprecated
  342. * @return void
  343. */
  344. public function testDetachFromAll()
  345. {
  346. $this->deprecated(function () {
  347. $manager = new EventManager();
  348. $manager->attach(['AClass', 'aMethod'], 'fake.event');
  349. $manager->attach(['AClass', 'aMethod'], 'another.event');
  350. $manager->attach('fakeFunction', 'another.event', ['priority' => 1]);
  351. $manager->detach(['AClass', 'aMethod']);
  352. $expected = [
  353. ['callable' => 'fakeFunction']
  354. ];
  355. $this->assertEquals($expected, $manager->listeners('another.event'));
  356. $this->assertEquals([], $manager->listeners('fake.event'));
  357. });
  358. }
  359. /**
  360. * Tests event dispatching
  361. *
  362. * @return void
  363. * @triggers fake.event
  364. */
  365. public function testDispatch()
  366. {
  367. $manager = new EventManager();
  368. $listener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  369. ->getMock();
  370. $anotherListener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  371. ->getMock();
  372. $manager->on('fake.event', [$listener, 'listenerFunction']);
  373. $manager->on('fake.event', [$anotherListener, 'listenerFunction']);
  374. $event = new Event('fake.event');
  375. $listener->expects($this->once())->method('listenerFunction')->with($event);
  376. $anotherListener->expects($this->once())->method('listenerFunction')->with($event);
  377. $manager->dispatch($event);
  378. }
  379. /**
  380. * Tests event dispatching using event key name
  381. *
  382. * @return void
  383. */
  384. public function testDispatchWithKeyName()
  385. {
  386. $manager = new EventManager();
  387. $listener = new EventTestListener;
  388. $manager->on('fake.event', [$listener, 'listenerFunction']);
  389. $event = 'fake.event';
  390. $manager->dispatch($event);
  391. $expected = ['listenerFunction'];
  392. $this->assertEquals($expected, $listener->callList);
  393. }
  394. /**
  395. * Tests event dispatching with a return value
  396. *
  397. * @return void
  398. * @triggers fake.event
  399. */
  400. public function testDispatchReturnValue()
  401. {
  402. $manager = new EventManager;
  403. $listener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  404. ->getMock();
  405. $anotherListener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  406. ->getMock();
  407. $manager->on('fake.event', [$listener, 'listenerFunction']);
  408. $manager->on('fake.event', [$anotherListener, 'listenerFunction']);
  409. $event = new Event('fake.event');
  410. $listener->expects($this->at(0))->method('listenerFunction')
  411. ->with($event)
  412. ->will($this->returnValue('something special'));
  413. $anotherListener->expects($this->at(0))
  414. ->method('listenerFunction')
  415. ->with($event);
  416. $manager->dispatch($event);
  417. $this->assertEquals('something special', $event->getResult());
  418. $this->assertEquals('something special', $event->result);
  419. }
  420. /**
  421. * Tests that returning false in a callback stops the event
  422. *
  423. * @return void
  424. * @triggers fake.event
  425. */
  426. public function testDispatchFalseStopsEvent()
  427. {
  428. $manager = new EventManager();
  429. $listener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  430. ->getMock();
  431. $anotherListener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  432. ->getMock();
  433. $manager->on('fake.event', [$listener, 'listenerFunction']);
  434. $manager->on('fake.event', [$anotherListener, 'listenerFunction']);
  435. $event = new Event('fake.event');
  436. $listener->expects($this->at(0))->method('listenerFunction')
  437. ->with($event)
  438. ->will($this->returnValue(false));
  439. $anotherListener->expects($this->never())
  440. ->method('listenerFunction');
  441. $manager->dispatch($event);
  442. $this->assertTrue($event->isStopped());
  443. }
  444. /**
  445. * Tests event dispatching using priorities
  446. *
  447. * @return void
  448. * @triggers fake.event
  449. */
  450. public function testDispatchPrioritized()
  451. {
  452. $manager = new EventManager();
  453. $listener = new EventTestListener;
  454. $manager->on('fake.event', [$listener, 'listenerFunction']);
  455. $manager->on('fake.event', ['priority' => 5], [$listener, 'secondListenerFunction']);
  456. $event = new Event('fake.event');
  457. $manager->dispatch($event);
  458. $expected = ['secondListenerFunction', 'listenerFunction'];
  459. $this->assertEquals($expected, $listener->callList);
  460. }
  461. /**
  462. * Tests subscribing a listener object and firing the events it subscribed to
  463. *
  464. * @return void
  465. * @triggers fake.event
  466. * @triggers another.event $this, array(some => data)
  467. */
  468. public function testOnSubscriber()
  469. {
  470. $manager = new EventManager();
  471. $listener = $this->getMockBuilder(__NAMESPACE__ . '\CustomTestEventListenerInterface')
  472. ->setMethods(['secondListenerFunction'])
  473. ->getMock();
  474. $manager->on($listener);
  475. $event = new Event('fake.event');
  476. $manager->dispatch($event);
  477. $expected = ['listenerFunction'];
  478. $this->assertEquals($expected, $listener->callList);
  479. $event = new Event('another.event', $this, ['some' => 'data']);
  480. $listener->expects($this->at(0))
  481. ->method('secondListenerFunction')
  482. ->with($event, 'data');
  483. $manager->dispatch($event);
  484. }
  485. /**
  486. * Test implementedEvents binding multiple callbacks to the same event name.
  487. *
  488. * @return void
  489. * @triggers multiple.handlers
  490. */
  491. public function testOnSubscriberMultiple()
  492. {
  493. $manager = new EventManager();
  494. $listener = $this->getMockBuilder(__NAMESPACE__ . '\CustomTestEventListenerInterface')
  495. ->setMethods(['listenerFunction', 'thirdListenerFunction'])
  496. ->getMock();
  497. $manager->on($listener);
  498. $event = new Event('multiple.handlers');
  499. $listener->expects($this->once())
  500. ->method('listenerFunction')
  501. ->with($event);
  502. $listener->expects($this->once())
  503. ->method('thirdListenerFunction')
  504. ->with($event);
  505. $manager->dispatch($event);
  506. }
  507. /**
  508. * Tests subscribing a listener object and firing the events it subscribed to
  509. *
  510. * @return void
  511. */
  512. public function testDetachSubscriber()
  513. {
  514. $manager = new EventManager();
  515. $listener = $this->getMockBuilder(__NAMESPACE__ . '\CustomTestEventListenerInterface')
  516. ->setMethods(['secondListenerFunction'])
  517. ->getMock();
  518. $manager->on($listener);
  519. $expected = [
  520. ['callable' => [$listener, 'secondListenerFunction']]
  521. ];
  522. $this->assertEquals($expected, $manager->listeners('another.event'));
  523. $expected = [
  524. ['callable' => [$listener, 'listenerFunction']]
  525. ];
  526. $this->assertEquals($expected, $manager->listeners('fake.event'));
  527. $manager->off($listener);
  528. $this->assertEquals([], $manager->listeners('fake.event'));
  529. $this->assertEquals([], $manager->listeners('another.event'));
  530. }
  531. /**
  532. * Tests that it is possible to get/set the manager singleton
  533. *
  534. * @return void
  535. */
  536. public function testGlobalDispatcherGetter()
  537. {
  538. $this->assertInstanceOf('Cake\Event\EventManager', EventManager::instance());
  539. $manager = new EventManager();
  540. EventManager::instance($manager);
  541. $this->assertSame($manager, EventManager::instance());
  542. }
  543. /**
  544. * Tests that the global event manager gets the event too from any other manager
  545. *
  546. * @return void
  547. * @triggers fake.event
  548. */
  549. public function testDispatchWithGlobal()
  550. {
  551. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')
  552. ->setMethods(['prioritisedListeners'])
  553. ->getMock();
  554. $manager = new EventManager();
  555. $event = new Event('fake.event');
  556. EventManager::instance($generalManager);
  557. $generalManager->expects($this->once())->method('prioritisedListeners')->with('fake.event');
  558. $manager->dispatch($event);
  559. EventManager::instance(new EventManager());
  560. }
  561. /**
  562. * Tests that stopping an event will not notify the rest of the listeners
  563. *
  564. * @return void
  565. * @triggers fake.event
  566. */
  567. public function testStopPropagation()
  568. {
  569. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')->getMock();
  570. $manager = new EventManager();
  571. $listener = new EventTestListener();
  572. EventManager::instance($generalManager);
  573. $generalManager->expects($this->any())
  574. ->method('prioritisedListeners')
  575. ->with('fake.event')
  576. ->will($this->returnValue([]));
  577. $manager->on('fake.event', [$listener, 'listenerFunction']);
  578. $manager->on('fake.event', ['priority' => 8], [$listener, 'stopListener']);
  579. $manager->on('fake.event', ['priority' => 5], [$listener, 'secondListenerFunction']);
  580. $event = new Event('fake.event');
  581. $manager->dispatch($event);
  582. $expected = ['secondListenerFunction'];
  583. $this->assertEquals($expected, $listener->callList);
  584. EventManager::instance(new EventManager());
  585. }
  586. /**
  587. * Tests event dispatching using priorities
  588. *
  589. * @return void
  590. * @triggers fake.event
  591. */
  592. public function testDispatchPrioritizedWithGlobal()
  593. {
  594. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')->getMock();
  595. $manager = new EventManager();
  596. $listener = new CustomTestEventListenerInterface();
  597. $event = new Event('fake.event');
  598. EventManager::instance($generalManager);
  599. $generalManager->expects($this->any())
  600. ->method('prioritisedListeners')
  601. ->with('fake.event')
  602. ->will($this->returnValue(
  603. [11 => [
  604. ['callable' => [$listener, 'secondListenerFunction']]
  605. ]]
  606. ));
  607. $manager->on('fake.event', [$listener, 'listenerFunction']);
  608. $manager->on('fake.event', ['priority' => 15], [$listener, 'thirdListenerFunction']);
  609. $manager->dispatch($event);
  610. $expected = ['listenerFunction', 'secondListenerFunction', 'thirdListenerFunction'];
  611. $this->assertEquals($expected, $listener->callList);
  612. EventManager::instance(new EventManager());
  613. }
  614. /**
  615. * Tests event dispatching using priorities
  616. *
  617. * @return void
  618. * @triggers fake.event
  619. */
  620. public function testDispatchGlobalBeforeLocal()
  621. {
  622. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')->getMock();
  623. $manager = new EventManager();
  624. $listener = new CustomTestEventListenerInterface();
  625. $event = new Event('fake.event');
  626. EventManager::instance($generalManager);
  627. $generalManager->expects($this->any())
  628. ->method('prioritisedListeners')
  629. ->with('fake.event')
  630. ->will($this->returnValue(
  631. [10 => [
  632. ['callable' => [$listener, 'listenerFunction']]
  633. ]]
  634. ));
  635. $manager->on('fake.event', [$listener, 'secondListenerFunction']);
  636. $manager->dispatch($event);
  637. $expected = ['listenerFunction', 'secondListenerFunction'];
  638. $this->assertEquals($expected, $listener->callList);
  639. EventManager::instance(new EventManager());
  640. }
  641. /**
  642. * test callback
  643. *
  644. * @param Event $event
  645. */
  646. public function onMyEvent(Event $event)
  647. {
  648. $event->setData('callback', 'ok');
  649. }
  650. /**
  651. * Tests events dispatched by a local manager can be handled by
  652. * handler registered in the global event manager
  653. * @triggers my_event $manager
  654. */
  655. public function testDispatchLocalHandledByGlobal()
  656. {
  657. $callback = [$this, 'onMyEvent'];
  658. EventManager::instance()->on('my_event', $callback);
  659. $manager = new EventManager();
  660. $event = new Event('my_event', $manager);
  661. $manager->dispatch($event);
  662. $this->assertEquals('ok', $event->getData('callback'));
  663. }
  664. /**
  665. * Test that events are dispatched properly when there are global and local
  666. * listeners at the same priority.
  667. *
  668. * @return void
  669. * @triggers fake.event $this
  670. */
  671. public function testDispatchWithGlobalAndLocalEvents()
  672. {
  673. $listener = new CustomTestEventListenerInterface();
  674. EventManager::instance()->on($listener);
  675. $listener2 = new EventTestListener();
  676. $manager = new EventManager();
  677. $manager->on('fake.event', [$listener2, 'listenerFunction']);
  678. $manager->dispatch(new Event('fake.event', $this));
  679. $this->assertEquals(['listenerFunction'], $listener->callList);
  680. $this->assertEquals(['listenerFunction'], $listener2->callList);
  681. }
  682. /**
  683. * Test getting a list of dispatched events from the manager.
  684. *
  685. * @return void
  686. * @triggers my_event $this
  687. * @triggers my_second_event $this
  688. */
  689. public function testGetDispatchedEvents()
  690. {
  691. $eventList = new EventList();
  692. $event = new Event('my_event', $this);
  693. $event2 = new Event('my_second_event', $this);
  694. $manager = new EventManager();
  695. $manager->setEventList($eventList);
  696. $manager->dispatch($event);
  697. $manager->dispatch($event2);
  698. $result = $manager->getEventList();
  699. $this->assertInstanceOf('\Cake\Event\EventList', $result);
  700. $this->assertCount(2, $result);
  701. $this->assertEquals($result[0], $event);
  702. $this->assertEquals($result[1], $event2);
  703. $manager->getEventList()->flush();
  704. $result = $manager->getEventList();
  705. $this->assertCount(0, $result);
  706. $manager->unsetEventList();
  707. $manager->dispatch($event);
  708. $manager->dispatch($event2);
  709. $result = $manager->getEventList();
  710. $this->assertNull($result);
  711. }
  712. /**
  713. * Test that locally dispatched events are also added to the global manager's event list
  714. *
  715. * @return void
  716. * @triggers Event $this
  717. */
  718. public function testGetLocallyDispatchedEventsFromGlobal()
  719. {
  720. $localList = new EventList();
  721. $globalList = new EventList();
  722. $globalManager = EventManager::instance();
  723. $globalManager->setEventList($globalList);
  724. $localManager = new EventManager();
  725. $localManager->setEventList($localList);
  726. $globalEvent = new Event('GlobalEvent', $this);
  727. $globalManager->dispatch($globalEvent);
  728. $localEvent = new Event('LocalEvent', $this);
  729. $localManager->dispatch($localEvent);
  730. $this->assertTrue($globalList->hasEvent('GlobalEvent'));
  731. $this->assertFalse($localList->hasEvent('GlobalEvent'));
  732. $this->assertTrue($localList->hasEvent('LocalEvent'));
  733. $this->assertTrue($globalList->hasEvent('LocalEvent'));
  734. }
  735. /**
  736. * Test isTrackingEvents
  737. *
  738. * @return void
  739. */
  740. public function testIsTrackingEvents()
  741. {
  742. $this->assertFalse(EventManager::instance()->isTrackingEvents());
  743. $manager = new EventManager();
  744. $manager->setEventList(new EventList());
  745. $this->assertTrue($manager->isTrackingEvents());
  746. $manager->trackEvents(false);
  747. $this->assertFalse($manager->isTrackingEvents());
  748. }
  749. public function testDebugInfo()
  750. {
  751. $eventManager = new EventManager();
  752. $this->assertSame(
  753. [
  754. '_listeners' => [],
  755. '_isGlobal' => false,
  756. '_eventList' => null,
  757. '_trackEvents' => false,
  758. '_generalManager' => '(object) EventManager',
  759. ],
  760. $eventManager->__debugInfo()
  761. );
  762. $func = function () {
  763. };
  764. $eventManager->on('foo', $func);
  765. $this->assertSame(
  766. [
  767. '_listeners' => [
  768. 'foo' => '1 listener(s)',
  769. ],
  770. '_isGlobal' => false,
  771. '_eventList' => null,
  772. '_trackEvents' => false,
  773. '_generalManager' => '(object) EventManager',
  774. ],
  775. $eventManager->__debugInfo()
  776. );
  777. $eventManager->off('foo', $func);
  778. $this->assertSame(
  779. [
  780. '_listeners' => [
  781. 'foo' => '0 listener(s)',
  782. ],
  783. '_isGlobal' => false,
  784. '_eventList' => null,
  785. '_trackEvents' => false,
  786. '_generalManager' => '(object) EventManager',
  787. ],
  788. $eventManager->__debugInfo()
  789. );
  790. $eventManager->on('bar', function () {
  791. });
  792. $eventManager->on('bar', function () {
  793. });
  794. $eventManager->on('bar', function () {
  795. });
  796. $eventManager->on('baz', function () {
  797. });
  798. $this->assertSame(
  799. [
  800. '_listeners' => [
  801. 'foo' => '0 listener(s)',
  802. 'bar' => '3 listener(s)',
  803. 'baz' => '1 listener(s)',
  804. ],
  805. '_isGlobal' => false,
  806. '_eventList' => null,
  807. '_trackEvents' => false,
  808. '_generalManager' => '(object) EventManager',
  809. ],
  810. $eventManager->__debugInfo()
  811. );
  812. }
  813. /**
  814. * test debugInfo with an event list.
  815. *
  816. * @return void
  817. */
  818. public function testDebubInfoEventList()
  819. {
  820. $eventList = new EventList();
  821. $eventManager = new EventManager();
  822. $eventManager->setEventList($eventList);
  823. $eventManager->on('example', function () {
  824. });
  825. $eventManager->dispatch('example');
  826. $this->assertSame(
  827. [
  828. '_listeners' => [
  829. 'example' => '1 listener(s)',
  830. ],
  831. '_isGlobal' => false,
  832. '_eventList' => $eventList,
  833. '_trackEvents' => true,
  834. '_generalManager' => '(object) EventManager',
  835. ],
  836. $eventManager->__debugInfo()
  837. );
  838. }
  839. /**
  840. * Test that chainable methods return correct values.
  841. *
  842. * @return void
  843. */
  844. public function testChainableMethods()
  845. {
  846. $eventManager = new EventManager();
  847. $listener = $this->createMock(EventListenerInterface::class);
  848. $callable = function () {
  849. };
  850. $returnValue = $eventManager->on($listener);
  851. $this->assertSame($eventManager, $returnValue);
  852. $returnValue = $eventManager->on('foo', $callable);
  853. $this->assertSame($eventManager, $returnValue);
  854. $returnValue = $eventManager->on('foo', [], $callable);
  855. $this->assertSame($eventManager, $returnValue);
  856. $returnValue = $eventManager->off($listener);
  857. $this->assertSame($eventManager, $returnValue);
  858. $returnValue = $eventManager->off('foo', $listener);
  859. $this->assertSame($eventManager, $returnValue);
  860. $returnValue = $eventManager->off('foo', $callable);
  861. $this->assertSame($eventManager, $returnValue);
  862. $returnValue = $eventManager->off('foo');
  863. $this->assertSame($eventManager, $returnValue);
  864. $returnValue = $eventManager->setEventList(new EventList());
  865. $this->assertSame($eventManager, $returnValue);
  866. $returnValue = $eventManager->addEventToList(new Event('foo'));
  867. $this->assertSame($eventManager, $returnValue);
  868. $returnValue = $eventManager->trackEvents(true);
  869. $this->assertSame($eventManager, $returnValue);
  870. $returnValue = $eventManager->unsetEventList();
  871. $this->assertSame($eventManager, $returnValue);
  872. }
  873. }