EventManagerTest.php 33 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015
  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. '_trackEvents' => false,
  757. '_generalManager' => '(object) EventManager',
  758. '_dispatchedEvents' => null,
  759. ],
  760. $eventManager->__debugInfo()
  761. );
  762. $eventManager->setEventList(new EventList());
  763. $eventManager->addEventToList(new Event('Foo', $this));
  764. $this->assertSame(
  765. [
  766. '_listeners' => [],
  767. '_isGlobal' => false,
  768. '_trackEvents' => true,
  769. '_generalManager' => '(object) EventManager',
  770. '_dispatchedEvents' => [
  771. 'Foo with subject Cake\Test\TestCase\Event\EventManagerTest'
  772. ],
  773. ],
  774. $eventManager->__debugInfo()
  775. );
  776. $eventManager->unsetEventList();
  777. $func = function () {
  778. };
  779. $eventManager->on('foo', $func);
  780. $this->assertSame(
  781. [
  782. '_listeners' => [
  783. 'foo' => '1 listener(s)',
  784. ],
  785. '_isGlobal' => false,
  786. '_trackEvents' => false,
  787. '_generalManager' => '(object) EventManager',
  788. '_dispatchedEvents' => null,
  789. ],
  790. $eventManager->__debugInfo()
  791. );
  792. $eventManager->off('foo', $func);
  793. $this->assertSame(
  794. [
  795. '_listeners' => [
  796. 'foo' => '0 listener(s)',
  797. ],
  798. '_isGlobal' => false,
  799. '_trackEvents' => false,
  800. '_generalManager' => '(object) EventManager',
  801. '_dispatchedEvents' => null,
  802. ],
  803. $eventManager->__debugInfo()
  804. );
  805. $eventManager->on('bar', function () {
  806. });
  807. $eventManager->on('bar', function () {
  808. });
  809. $eventManager->on('bar', function () {
  810. });
  811. $eventManager->on('baz', function () {
  812. });
  813. $this->assertSame(
  814. [
  815. '_listeners' => [
  816. 'foo' => '0 listener(s)',
  817. 'bar' => '3 listener(s)',
  818. 'baz' => '1 listener(s)',
  819. ],
  820. '_isGlobal' => false,
  821. '_trackEvents' => false,
  822. '_generalManager' => '(object) EventManager',
  823. '_dispatchedEvents' => null,
  824. ],
  825. $eventManager->__debugInfo()
  826. );
  827. }
  828. /**
  829. * test debugInfo with an event list.
  830. *
  831. * @return void
  832. */
  833. public function testDebugInfoEventList()
  834. {
  835. $eventList = new EventList();
  836. $eventManager = new EventManager();
  837. $eventManager->setEventList($eventList);
  838. $eventManager->on('example', function () {
  839. });
  840. $eventManager->dispatch('example');
  841. $this->assertSame(
  842. [
  843. '_listeners' => [
  844. 'example' => '1 listener(s)',
  845. ],
  846. '_isGlobal' => false,
  847. '_trackEvents' => true,
  848. '_generalManager' => '(object) EventManager',
  849. '_dispatchedEvents' => [
  850. 'example with no subject',
  851. ],
  852. ],
  853. $eventManager->__debugInfo()
  854. );
  855. }
  856. /**
  857. * Test that chainable methods return correct values.
  858. *
  859. * @return void
  860. */
  861. public function testChainableMethods()
  862. {
  863. $eventManager = new EventManager();
  864. $listener = $this->createMock(EventListenerInterface::class);
  865. $callable = function () {
  866. };
  867. $returnValue = $eventManager->on($listener);
  868. $this->assertSame($eventManager, $returnValue);
  869. $returnValue = $eventManager->on('foo', $callable);
  870. $this->assertSame($eventManager, $returnValue);
  871. $returnValue = $eventManager->on('foo', [], $callable);
  872. $this->assertSame($eventManager, $returnValue);
  873. $returnValue = $eventManager->off($listener);
  874. $this->assertSame($eventManager, $returnValue);
  875. $returnValue = $eventManager->off('foo', $listener);
  876. $this->assertSame($eventManager, $returnValue);
  877. $returnValue = $eventManager->off('foo', $callable);
  878. $this->assertSame($eventManager, $returnValue);
  879. $returnValue = $eventManager->off('foo');
  880. $this->assertSame($eventManager, $returnValue);
  881. $returnValue = $eventManager->setEventList(new EventList());
  882. $this->assertSame($eventManager, $returnValue);
  883. $returnValue = $eventManager->addEventToList(new Event('foo'));
  884. $this->assertSame($eventManager, $returnValue);
  885. $returnValue = $eventManager->trackEvents(true);
  886. $this->assertSame($eventManager, $returnValue);
  887. $returnValue = $eventManager->unsetEventList();
  888. $this->assertSame($eventManager, $returnValue);
  889. }
  890. }