EventManagerTest.php 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936
  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. * Tests the attach() method for multiple event key in multiple queues
  121. *
  122. * @group deprecated
  123. * @return void
  124. */
  125. public function testAttachMultipleEventKeys()
  126. {
  127. $this->deprecated(function () {
  128. $manager = new EventManager();
  129. $manager->attach('fakeFunction', 'fake.event');
  130. $manager->attach('fakeFunction2', 'another.event');
  131. $manager->attach('fakeFunction3', 'another.event', ['priority' => 1]);
  132. $expected = [
  133. ['callable' => 'fakeFunction']
  134. ];
  135. $this->assertEquals($expected, $manager->listeners('fake.event'));
  136. $expected = [
  137. ['callable' => 'fakeFunction3'],
  138. ['callable' => 'fakeFunction2']
  139. ];
  140. $this->assertEquals($expected, $manager->listeners('another.event'));
  141. });
  142. }
  143. /**
  144. * Tests attached event listeners for matching key pattern
  145. *
  146. * @return void
  147. */
  148. public function testMatchingListeners()
  149. {
  150. $manager = new EventManager();
  151. $manager->on('fake.event', 'fakeFunction1');
  152. $manager->on('real.event', 'fakeFunction2');
  153. $manager->on('test.event', 'fakeFunction3');
  154. $manager->on('event.test', 'fakeFunction4');
  155. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('fake.event'));
  156. $this->assertArrayHasKey('real.event', $manager->matchingListeners('real.event'));
  157. $this->assertArrayHasKey('test.event', $manager->matchingListeners('test.event'));
  158. $this->assertArrayHasKey('event.test', $manager->matchingListeners('event.test'));
  159. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('fake'));
  160. $this->assertArrayHasKey('real.event', $manager->matchingListeners('real'));
  161. $this->assertArrayHasKey('test.event', $manager->matchingListeners('test'));
  162. $this->assertArrayHasKey('event.test', $manager->matchingListeners('test'));
  163. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('event'));
  164. $this->assertArrayHasKey('real.event', $manager->matchingListeners('event'));
  165. $this->assertArrayHasKey('test.event', $manager->matchingListeners('event'));
  166. $this->assertArrayHasKey('event.test', $manager->matchingListeners('event'));
  167. $this->assertArrayHasKey('fake.event', $manager->matchingListeners('.event'));
  168. $this->assertArrayHasKey('real.event', $manager->matchingListeners('.event'));
  169. $this->assertArrayHasKey('test.event', $manager->matchingListeners('.event'));
  170. $this->assertArrayHasKey('test.event', $manager->matchingListeners('test.'));
  171. $this->assertArrayHasKey('event.test', $manager->matchingListeners('.test'));
  172. $this->assertEmpty($manager->matchingListeners('/test'));
  173. $this->assertEmpty($manager->matchingListeners('test/'));
  174. $this->assertEmpty($manager->matchingListeners('/test/'));
  175. $this->assertEmpty($manager->matchingListeners('test$'));
  176. $this->assertEmpty($manager->matchingListeners('ev.nt'));
  177. $this->assertEmpty($manager->matchingListeners('^test'));
  178. $this->assertEmpty($manager->matchingListeners('^event'));
  179. $this->assertEmpty($manager->matchingListeners('*event'));
  180. $this->assertEmpty($manager->matchingListeners('event*'));
  181. $this->assertEmpty($manager->matchingListeners('foo'));
  182. $expected = ['fake.event', 'real.event', 'test.event', 'event.test'];
  183. $result = $manager->matchingListeners('event');
  184. $this->assertNotEmpty($result);
  185. $this->assertSame($expected, array_keys($result));
  186. $expected = ['fake.event', 'real.event', 'test.event'];
  187. $result = $manager->matchingListeners('.event');
  188. $this->assertNotEmpty($result);
  189. $this->assertSame($expected, array_keys($result));
  190. $expected = ['test.event', 'event.test'];
  191. $result = $manager->matchingListeners('test');
  192. $this->assertNotEmpty($result);
  193. $this->assertSame($expected, array_keys($result));
  194. $expected = ['test.event'];
  195. $result = $manager->matchingListeners('test.');
  196. $this->assertNotEmpty($result);
  197. $this->assertSame($expected, array_keys($result));
  198. $expected = ['event.test'];
  199. $result = $manager->matchingListeners('.test');
  200. $this->assertNotEmpty($result);
  201. $this->assertSame($expected, array_keys($result));
  202. }
  203. /**
  204. * Test the on() method for basic callable types.
  205. *
  206. * @return void
  207. */
  208. public function testOn()
  209. {
  210. $count = 1;
  211. $manager = new EventManager();
  212. $manager->on('my.event', 'myfunc');
  213. $expected = [
  214. ['callable' => 'myfunc']
  215. ];
  216. $this->assertSame($expected, $manager->listeners('my.event'));
  217. $manager->on('my.event', ['priority' => 1], 'func2');
  218. $expected = [
  219. ['callable' => 'func2'],
  220. ['callable' => 'myfunc'],
  221. ];
  222. $this->assertSame($expected, $manager->listeners('my.event'));
  223. $listener = new CustomTestEventListenerInterface();
  224. $manager->on($listener);
  225. $expected = [
  226. ['callable' => [$listener, 'listenerFunction']],
  227. ];
  228. $this->assertEquals($expected, $manager->listeners('fake.event'));
  229. }
  230. /**
  231. * Tests off'ing an event from a event key queue
  232. *
  233. * @return void
  234. */
  235. public function testOff()
  236. {
  237. $manager = new EventManager();
  238. $manager->on('fake.event', ['AClass', 'aMethod']);
  239. $manager->on('another.event', ['AClass', 'anotherMethod']);
  240. $manager->on('another.event', ['priority' => 1], 'fakeFunction');
  241. $manager->off('fake.event', ['AClass', 'aMethod']);
  242. $this->assertEquals([], $manager->listeners('fake.event'));
  243. $manager->off('another.event', ['AClass', 'anotherMethod']);
  244. $expected = [
  245. ['callable' => 'fakeFunction']
  246. ];
  247. $this->assertEquals($expected, $manager->listeners('another.event'));
  248. $manager->off('another.event', 'fakeFunction');
  249. $this->assertEquals([], $manager->listeners('another.event'));
  250. }
  251. /**
  252. * Tests off'ing an event from all event queues
  253. *
  254. * @return void
  255. */
  256. public function testOffFromAll()
  257. {
  258. $manager = new EventManager();
  259. $manager->on('fake.event', ['AClass', 'aMethod']);
  260. $manager->on('another.event', ['AClass', 'aMethod']);
  261. $manager->on('another.event', ['priority' => 1], 'fakeFunction');
  262. $manager->off(['AClass', 'aMethod']);
  263. $expected = [
  264. ['callable' => 'fakeFunction']
  265. ];
  266. $this->assertEquals($expected, $manager->listeners('another.event'));
  267. $this->assertEquals([], $manager->listeners('fake.event'));
  268. }
  269. /**
  270. * Tests off'ing all listeners for an event
  271. */
  272. public function testRemoveAllListeners()
  273. {
  274. $manager = new EventManager();
  275. $manager->on('fake.event', ['AClass', 'aMethod']);
  276. $manager->on('another.event', ['priority' => 1], 'fakeFunction');
  277. $manager->off('fake.event');
  278. $expected = [
  279. ['callable' => 'fakeFunction']
  280. ];
  281. $this->assertEquals($expected, $manager->listeners('another.event'));
  282. $this->assertEquals([], $manager->listeners('fake.event'));
  283. }
  284. /**
  285. * Tests detaching an event from a event key queue
  286. *
  287. * @group deprecated
  288. * @return void
  289. */
  290. public function testDetach()
  291. {
  292. $this->deprecated(function () {
  293. $manager = new EventManager();
  294. $manager->attach(['AClass', 'aMethod'], 'fake.event');
  295. $manager->attach(['AClass', 'anotherMethod'], 'another.event');
  296. $manager->attach('fakeFunction', 'another.event', ['priority' => 1]);
  297. $manager->detach(['AClass', 'aMethod'], 'fake.event');
  298. $this->assertEquals([], $manager->listeners('fake.event'));
  299. $manager->detach(['AClass', 'anotherMethod'], 'another.event');
  300. $expected = [
  301. ['callable' => 'fakeFunction']
  302. ];
  303. $this->assertEquals($expected, $manager->listeners('another.event'));
  304. $manager->detach('fakeFunction', 'another.event');
  305. $this->assertEquals([], $manager->listeners('another.event'));
  306. });
  307. }
  308. /**
  309. * Tests detaching an event from all event queues
  310. *
  311. * @group deprecated
  312. * @return void
  313. */
  314. public function testDetachFromAll()
  315. {
  316. $this->deprecated(function () {
  317. $manager = new EventManager();
  318. $manager->attach(['AClass', 'aMethod'], 'fake.event');
  319. $manager->attach(['AClass', 'aMethod'], 'another.event');
  320. $manager->attach('fakeFunction', 'another.event', ['priority' => 1]);
  321. $manager->detach(['AClass', 'aMethod']);
  322. $expected = [
  323. ['callable' => 'fakeFunction']
  324. ];
  325. $this->assertEquals($expected, $manager->listeners('another.event'));
  326. $this->assertEquals([], $manager->listeners('fake.event'));
  327. });
  328. }
  329. /**
  330. * Tests event dispatching
  331. *
  332. * @return void
  333. * @triggers fake.event
  334. */
  335. public function testDispatch()
  336. {
  337. $manager = new EventManager();
  338. $listener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  339. ->getMock();
  340. $anotherListener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  341. ->getMock();
  342. $manager->on('fake.event', [$listener, 'listenerFunction']);
  343. $manager->on('fake.event', [$anotherListener, 'listenerFunction']);
  344. $event = new Event('fake.event');
  345. $listener->expects($this->once())->method('listenerFunction')->with($event);
  346. $anotherListener->expects($this->once())->method('listenerFunction')->with($event);
  347. $manager->dispatch($event);
  348. }
  349. /**
  350. * Tests event dispatching using event key name
  351. *
  352. * @return void
  353. */
  354. public function testDispatchWithKeyName()
  355. {
  356. $manager = new EventManager();
  357. $listener = new EventTestListener;
  358. $manager->on('fake.event', [$listener, 'listenerFunction']);
  359. $event = 'fake.event';
  360. $manager->dispatch($event);
  361. $expected = ['listenerFunction'];
  362. $this->assertEquals($expected, $listener->callList);
  363. }
  364. /**
  365. * Tests event dispatching with a return value
  366. *
  367. * @return void
  368. * @triggers fake.event
  369. */
  370. public function testDispatchReturnValue()
  371. {
  372. $manager = new EventManager;
  373. $listener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  374. ->getMock();
  375. $anotherListener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  376. ->getMock();
  377. $manager->on('fake.event', [$listener, 'listenerFunction']);
  378. $manager->on('fake.event', [$anotherListener, 'listenerFunction']);
  379. $event = new Event('fake.event');
  380. $listener->expects($this->at(0))->method('listenerFunction')
  381. ->with($event)
  382. ->will($this->returnValue('something special'));
  383. $anotherListener->expects($this->at(0))
  384. ->method('listenerFunction')
  385. ->with($event);
  386. $manager->dispatch($event);
  387. $this->assertEquals('something special', $event->getResult());
  388. $this->assertEquals('something special', $event->result);
  389. }
  390. /**
  391. * Tests that returning false in a callback stops the event
  392. *
  393. * @return void
  394. * @triggers fake.event
  395. */
  396. public function testDispatchFalseStopsEvent()
  397. {
  398. $manager = new EventManager();
  399. $listener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  400. ->getMock();
  401. $anotherListener = $this->getMockBuilder(__NAMESPACE__ . '\EventTestListener')
  402. ->getMock();
  403. $manager->on('fake.event', [$listener, 'listenerFunction']);
  404. $manager->on('fake.event', [$anotherListener, 'listenerFunction']);
  405. $event = new Event('fake.event');
  406. $listener->expects($this->at(0))->method('listenerFunction')
  407. ->with($event)
  408. ->will($this->returnValue(false));
  409. $anotherListener->expects($this->never())
  410. ->method('listenerFunction');
  411. $manager->dispatch($event);
  412. $this->assertTrue($event->isStopped());
  413. }
  414. /**
  415. * Tests event dispatching using priorities
  416. *
  417. * @return void
  418. * @triggers fake.event
  419. */
  420. public function testDispatchPrioritized()
  421. {
  422. $manager = new EventManager();
  423. $listener = new EventTestListener;
  424. $manager->on('fake.event', [$listener, 'listenerFunction']);
  425. $manager->on('fake.event', ['priority' => 5], [$listener, 'secondListenerFunction']);
  426. $event = new Event('fake.event');
  427. $manager->dispatch($event);
  428. $expected = ['secondListenerFunction', 'listenerFunction'];
  429. $this->assertEquals($expected, $listener->callList);
  430. }
  431. /**
  432. * Tests subscribing a listener object and firing the events it subscribed to
  433. *
  434. * @return void
  435. * @triggers fake.event
  436. * @triggers another.event $this, array(some => data)
  437. */
  438. public function testOnSubscriber()
  439. {
  440. $manager = new EventManager();
  441. $listener = $this->getMockBuilder(__NAMESPACE__ . '\CustomTestEventListenerInterface')
  442. ->setMethods(['secondListenerFunction'])
  443. ->getMock();
  444. $manager->on($listener);
  445. $event = new Event('fake.event');
  446. $manager->dispatch($event);
  447. $expected = ['listenerFunction'];
  448. $this->assertEquals($expected, $listener->callList);
  449. $event = new Event('another.event', $this, ['some' => 'data']);
  450. $listener->expects($this->at(0))
  451. ->method('secondListenerFunction')
  452. ->with($event, 'data');
  453. $manager->dispatch($event);
  454. }
  455. /**
  456. * Test implementedEvents binding multiple callbacks to the same event name.
  457. *
  458. * @return void
  459. * @triggers multiple.handlers
  460. */
  461. public function testOnSubscriberMultiple()
  462. {
  463. $manager = new EventManager();
  464. $listener = $this->getMockBuilder(__NAMESPACE__ . '\CustomTestEventListenerInterface')
  465. ->setMethods(['listenerFunction', 'thirdListenerFunction'])
  466. ->getMock();
  467. $manager->on($listener);
  468. $event = new Event('multiple.handlers');
  469. $listener->expects($this->once())
  470. ->method('listenerFunction')
  471. ->with($event);
  472. $listener->expects($this->once())
  473. ->method('thirdListenerFunction')
  474. ->with($event);
  475. $manager->dispatch($event);
  476. }
  477. /**
  478. * Tests subscribing a listener object and firing the events it subscribed to
  479. *
  480. * @return void
  481. */
  482. public function testDetachSubscriber()
  483. {
  484. $manager = new EventManager();
  485. $listener = $this->getMockBuilder(__NAMESPACE__ . '\CustomTestEventListenerInterface')
  486. ->setMethods(['secondListenerFunction'])
  487. ->getMock();
  488. $manager->on($listener);
  489. $expected = [
  490. ['callable' => [$listener, 'secondListenerFunction']]
  491. ];
  492. $this->assertEquals($expected, $manager->listeners('another.event'));
  493. $expected = [
  494. ['callable' => [$listener, 'listenerFunction']]
  495. ];
  496. $this->assertEquals($expected, $manager->listeners('fake.event'));
  497. $manager->off($listener);
  498. $this->assertEquals([], $manager->listeners('fake.event'));
  499. $this->assertEquals([], $manager->listeners('another.event'));
  500. }
  501. /**
  502. * Tests that it is possible to get/set the manager singleton
  503. *
  504. * @return void
  505. */
  506. public function testGlobalDispatcherGetter()
  507. {
  508. $this->assertInstanceOf('Cake\Event\EventManager', EventManager::instance());
  509. $manager = new EventManager();
  510. EventManager::instance($manager);
  511. $this->assertSame($manager, EventManager::instance());
  512. }
  513. /**
  514. * Tests that the global event manager gets the event too from any other manager
  515. *
  516. * @return void
  517. * @triggers fake.event
  518. */
  519. public function testDispatchWithGlobal()
  520. {
  521. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')
  522. ->setMethods(['prioritisedListeners'])
  523. ->getMock();
  524. $manager = new EventManager();
  525. $event = new Event('fake.event');
  526. EventManager::instance($generalManager);
  527. $generalManager->expects($this->once())->method('prioritisedListeners')->with('fake.event');
  528. $manager->dispatch($event);
  529. EventManager::instance(new EventManager());
  530. }
  531. /**
  532. * Tests that stopping an event will not notify the rest of the listeners
  533. *
  534. * @return void
  535. * @triggers fake.event
  536. */
  537. public function testStopPropagation()
  538. {
  539. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')->getMock();
  540. $manager = new EventManager();
  541. $listener = new EventTestListener();
  542. EventManager::instance($generalManager);
  543. $generalManager->expects($this->any())
  544. ->method('prioritisedListeners')
  545. ->with('fake.event')
  546. ->will($this->returnValue([]));
  547. $manager->on('fake.event', [$listener, 'listenerFunction']);
  548. $manager->on('fake.event', ['priority' => 8], [$listener, 'stopListener']);
  549. $manager->on('fake.event', ['priority' => 5], [$listener, 'secondListenerFunction']);
  550. $event = new Event('fake.event');
  551. $manager->dispatch($event);
  552. $expected = ['secondListenerFunction'];
  553. $this->assertEquals($expected, $listener->callList);
  554. EventManager::instance(new EventManager());
  555. }
  556. /**
  557. * Tests event dispatching using priorities
  558. *
  559. * @return void
  560. * @triggers fake.event
  561. */
  562. public function testDispatchPrioritizedWithGlobal()
  563. {
  564. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')->getMock();
  565. $manager = new EventManager();
  566. $listener = new CustomTestEventListenerInterface();
  567. $event = new Event('fake.event');
  568. EventManager::instance($generalManager);
  569. $generalManager->expects($this->any())
  570. ->method('prioritisedListeners')
  571. ->with('fake.event')
  572. ->will($this->returnValue(
  573. [11 => [
  574. ['callable' => [$listener, 'secondListenerFunction']]
  575. ]]
  576. ));
  577. $manager->on('fake.event', [$listener, 'listenerFunction']);
  578. $manager->on('fake.event', ['priority' => 15], [$listener, 'thirdListenerFunction']);
  579. $manager->dispatch($event);
  580. $expected = ['listenerFunction', 'secondListenerFunction', 'thirdListenerFunction'];
  581. $this->assertEquals($expected, $listener->callList);
  582. EventManager::instance(new EventManager());
  583. }
  584. /**
  585. * Tests event dispatching using priorities
  586. *
  587. * @return void
  588. * @triggers fake.event
  589. */
  590. public function testDispatchGlobalBeforeLocal()
  591. {
  592. $generalManager = $this->getMockBuilder('Cake\Event\EventManager')->getMock();
  593. $manager = new EventManager();
  594. $listener = new CustomTestEventListenerInterface();
  595. $event = new Event('fake.event');
  596. EventManager::instance($generalManager);
  597. $generalManager->expects($this->any())
  598. ->method('prioritisedListeners')
  599. ->with('fake.event')
  600. ->will($this->returnValue(
  601. [10 => [
  602. ['callable' => [$listener, 'listenerFunction']]
  603. ]]
  604. ));
  605. $manager->on('fake.event', [$listener, 'secondListenerFunction']);
  606. $manager->dispatch($event);
  607. $expected = ['listenerFunction', 'secondListenerFunction'];
  608. $this->assertEquals($expected, $listener->callList);
  609. EventManager::instance(new EventManager());
  610. }
  611. /**
  612. * test callback
  613. *
  614. * @param Event $event
  615. */
  616. public function onMyEvent(Event $event)
  617. {
  618. $event->setData('callback', 'ok');
  619. }
  620. /**
  621. * Tests events dispatched by a local manager can be handled by
  622. * handler registered in the global event manager
  623. * @triggers my_event $manager
  624. */
  625. public function testDispatchLocalHandledByGlobal()
  626. {
  627. $callback = [$this, 'onMyEvent'];
  628. EventManager::instance()->on('my_event', $callback);
  629. $manager = new EventManager();
  630. $event = new Event('my_event', $manager);
  631. $manager->dispatch($event);
  632. $this->assertEquals('ok', $event->getData('callback'));
  633. }
  634. /**
  635. * Test that events are dispatched properly when there are global and local
  636. * listeners at the same priority.
  637. *
  638. * @return void
  639. * @triggers fake.event $this
  640. */
  641. public function testDispatchWithGlobalAndLocalEvents()
  642. {
  643. $listener = new CustomTestEventListenerInterface();
  644. EventManager::instance()->on($listener);
  645. $listener2 = new EventTestListener();
  646. $manager = new EventManager();
  647. $manager->on('fake.event', [$listener2, 'listenerFunction']);
  648. $manager->dispatch(new Event('fake.event', $this));
  649. $this->assertEquals(['listenerFunction'], $listener->callList);
  650. $this->assertEquals(['listenerFunction'], $listener2->callList);
  651. }
  652. /**
  653. * Test getting a list of dispatched events from the manager.
  654. *
  655. * @return void
  656. * @triggers my_event $this
  657. * @triggers my_second_event $this
  658. */
  659. public function testGetDispatchedEvents()
  660. {
  661. $eventList = new EventList();
  662. $event = new Event('my_event', $this);
  663. $event2 = new Event('my_second_event', $this);
  664. $manager = new EventManager();
  665. $manager->setEventList($eventList);
  666. $manager->dispatch($event);
  667. $manager->dispatch($event2);
  668. $result = $manager->getEventList();
  669. $this->assertInstanceOf('\Cake\Event\EventList', $result);
  670. $this->assertCount(2, $result);
  671. $this->assertEquals($result[0], $event);
  672. $this->assertEquals($result[1], $event2);
  673. $manager->getEventList()->flush();
  674. $result = $manager->getEventList();
  675. $this->assertCount(0, $result);
  676. $manager->unsetEventList();
  677. $manager->dispatch($event);
  678. $manager->dispatch($event2);
  679. $result = $manager->getEventList();
  680. $this->assertNull($result);
  681. }
  682. /**
  683. * Test that locally dispatched events are also added to the global manager's event list
  684. *
  685. * @return void
  686. * @triggers Event $this
  687. */
  688. public function testGetLocallyDispatchedEventsFromGlobal()
  689. {
  690. $localList = new EventList();
  691. $globalList = new EventList();
  692. $globalManager = EventManager::instance();
  693. $globalManager->setEventList($globalList);
  694. $localManager = new EventManager();
  695. $localManager->setEventList($localList);
  696. $globalEvent = new Event('GlobalEvent', $this);
  697. $globalManager->dispatch($globalEvent);
  698. $localEvent = new Event('LocalEvent', $this);
  699. $localManager->dispatch($localEvent);
  700. $this->assertTrue($globalList->hasEvent('GlobalEvent'));
  701. $this->assertFalse($localList->hasEvent('GlobalEvent'));
  702. $this->assertTrue($localList->hasEvent('LocalEvent'));
  703. $this->assertTrue($globalList->hasEvent('LocalEvent'));
  704. }
  705. /**
  706. * Test isTrackingEvents
  707. *
  708. * @return void
  709. */
  710. public function testIsTrackingEvents()
  711. {
  712. $this->assertFalse(EventManager::instance()->isTrackingEvents());
  713. $manager = new EventManager();
  714. $manager->setEventList(new EventList());
  715. $this->assertTrue($manager->isTrackingEvents());
  716. $manager->trackEvents(false);
  717. $this->assertFalse($manager->isTrackingEvents());
  718. }
  719. public function testDebugInfo()
  720. {
  721. $eventManager = new EventManager();
  722. $this->assertSame(
  723. [
  724. '_listeners' => [],
  725. '_isGlobal' => false,
  726. '_eventList' => null,
  727. '_trackEvents' => false,
  728. '_generalManager' => '(object) EventManager',
  729. ],
  730. $eventManager->__debugInfo()
  731. );
  732. $func = function () {
  733. };
  734. $eventManager->on('foo', $func);
  735. $this->assertSame(
  736. [
  737. '_listeners' => [
  738. 'foo' => '1 listener(s)',
  739. ],
  740. '_isGlobal' => false,
  741. '_eventList' => null,
  742. '_trackEvents' => false,
  743. '_generalManager' => '(object) EventManager',
  744. ],
  745. $eventManager->__debugInfo()
  746. );
  747. $eventManager->off('foo', $func);
  748. $this->assertSame(
  749. [
  750. '_listeners' => [
  751. 'foo' => '0 listener(s)',
  752. ],
  753. '_isGlobal' => false,
  754. '_eventList' => null,
  755. '_trackEvents' => false,
  756. '_generalManager' => '(object) EventManager',
  757. ],
  758. $eventManager->__debugInfo()
  759. );
  760. $eventManager->on('bar', function () {
  761. });
  762. $eventManager->on('bar', function () {
  763. });
  764. $eventManager->on('bar', function () {
  765. });
  766. $eventManager->on('baz', function () {
  767. });
  768. $this->assertSame(
  769. [
  770. '_listeners' => [
  771. 'foo' => '0 listener(s)',
  772. 'bar' => '3 listener(s)',
  773. 'baz' => '1 listener(s)',
  774. ],
  775. '_isGlobal' => false,
  776. '_eventList' => null,
  777. '_trackEvents' => false,
  778. '_generalManager' => '(object) EventManager',
  779. ],
  780. $eventManager->__debugInfo()
  781. );
  782. }
  783. /**
  784. * Test that chainable methods return correct values.
  785. *
  786. * @return void
  787. */
  788. public function testChainableMethods()
  789. {
  790. $eventManager = new EventManager();
  791. $listener = $this->createMock(EventListenerInterface::class);
  792. $callable = function () {
  793. };
  794. $returnValue = $eventManager->on($listener);
  795. $this->assertSame($eventManager, $returnValue);
  796. $returnValue = $eventManager->on('foo', $callable);
  797. $this->assertSame($eventManager, $returnValue);
  798. $returnValue = $eventManager->on('foo', [], $callable);
  799. $this->assertSame($eventManager, $returnValue);
  800. $returnValue = $eventManager->off($listener);
  801. $this->assertSame($eventManager, $returnValue);
  802. $returnValue = $eventManager->off('foo', $listener);
  803. $this->assertSame($eventManager, $returnValue);
  804. $returnValue = $eventManager->off('foo', $callable);
  805. $this->assertSame($eventManager, $returnValue);
  806. $returnValue = $eventManager->off('foo');
  807. $this->assertSame($eventManager, $returnValue);
  808. $returnValue = $eventManager->setEventList(new EventList());
  809. $this->assertSame($eventManager, $returnValue);
  810. $returnValue = $eventManager->addEventToList(new Event('foo'));
  811. $this->assertSame($eventManager, $returnValue);
  812. $returnValue = $eventManager->trackEvents(true);
  813. $this->assertSame($eventManager, $returnValue);
  814. $returnValue = $eventManager->unsetEventList();
  815. $this->assertSame($eventManager, $returnValue);
  816. }
  817. }