EventManagerTest.php 30 KB

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