RequestHandlerComponentTest.php 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878
  1. <?php
  2. declare(strict_types=1);
  3. /**
  4. * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
  5. * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
  6. *
  7. * Licensed under The MIT License
  8. * For full copyright and license information, please see the LICENSE.txt
  9. * Redistributions of files must retain the above copyright notice
  10. *
  11. * @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
  12. * @link https://cakephp.org CakePHP(tm) Project
  13. * @since 1.2.0
  14. * @license https://opensource.org/licenses/mit-license.php MIT License
  15. */
  16. namespace Cake\Test\TestCase\Controller\Component;
  17. use Cake\Controller\Component\RequestHandlerComponent;
  18. use Cake\Controller\ComponentRegistry;
  19. use Cake\Controller\Controller;
  20. use Cake\Event\Event;
  21. use Cake\Event\EventInterface;
  22. use Cake\Http\Exception\NotFoundException;
  23. use Cake\Http\Response;
  24. use Cake\Http\ServerRequest;
  25. use Cake\Routing\Router;
  26. use Cake\TestSuite\TestCase;
  27. use Cake\View\AjaxView;
  28. use Cake\View\JsonView;
  29. use Cake\View\XmlView;
  30. use TestApp\Controller\Component\RequestHandlerExtComponent;
  31. use TestApp\Controller\RequestHandlerTestController;
  32. use TestApp\View\AppView;
  33. /**
  34. * RequestHandlerComponentTest class
  35. */
  36. class RequestHandlerComponentTest extends TestCase
  37. {
  38. /**
  39. * @var \TestApp\Controller\RequestHandlerTestController
  40. */
  41. protected $Controller;
  42. /**
  43. * @var \TestApp\Controller\Component\RequestHandlerExtComponent
  44. */
  45. protected $RequestHandler;
  46. /**
  47. * @var \Cake\Http\ServerRequest
  48. */
  49. protected $request;
  50. /**
  51. * Backup of $_SERVER
  52. *
  53. * @var array
  54. */
  55. protected $server = [];
  56. /**
  57. * @var \Cake\Routing\RouteBuilder
  58. */
  59. protected $builder;
  60. /**
  61. * setUp method
  62. */
  63. public function setUp(): void
  64. {
  65. parent::setUp();
  66. $this->server = $_SERVER;
  67. static::setAppNamespace();
  68. $this->_init();
  69. }
  70. /**
  71. * init method
  72. */
  73. protected function _init(): void
  74. {
  75. $request = new ServerRequest(['url' => 'controller_posts/index']);
  76. $response = new Response();
  77. $this->Controller = new RequestHandlerTestController($request, $response);
  78. $this->RequestHandler = $this->Controller->components()->load(RequestHandlerExtComponent::class);
  79. $this->request = $request;
  80. $this->builder = Router::createRouteBuilder('/');
  81. $this->builder->setExtensions('json');
  82. $this->builder->fallbacks('InflectedRoute');
  83. }
  84. /**
  85. * tearDown method
  86. */
  87. public function tearDown(): void
  88. {
  89. parent::tearDown();
  90. Router::reload();
  91. $_SERVER = $this->server;
  92. unset($this->RequestHandler, $this->Controller);
  93. }
  94. /**
  95. * Test that the constructor sets the config.
  96. */
  97. public function testConstructorConfig(): void
  98. {
  99. $config = [
  100. 'viewClassMap' => ['json' => 'MyPlugin.MyJson'],
  101. ];
  102. /** @var \Cake\Controller\Controller|\PHPUnit\Framework\MockObject\MockObject $controller */
  103. $controller = $this->getMockBuilder(Controller::class)
  104. ->onlyMethods(['redirect'])
  105. ->getMock();
  106. $collection = new ComponentRegistry($controller);
  107. $requestHandler = new RequestHandlerComponent($collection, $config);
  108. $this->assertEquals(['json' => 'MyPlugin.MyJson'], $requestHandler->getConfig('viewClassMap'));
  109. }
  110. /**
  111. * testInitializeCallback method
  112. */
  113. public function testInitializeCallback(): void
  114. {
  115. $this->assertNull($this->RequestHandler->getExt());
  116. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'rss'));
  117. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  118. $this->assertSame('rss', $this->RequestHandler->getExt());
  119. }
  120. /**
  121. * test that a mapped Accept-type header will set $this->ext correctly.
  122. */
  123. public function testInitializeContentTypeSettingExt(): void
  124. {
  125. Router::reload();
  126. $this->Controller->setRequest($this->request->withHeader('Accept', 'application/json'));
  127. $this->RequestHandler->setExt(null);
  128. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  129. $this->assertSame('json', $this->RequestHandler->getExt());
  130. }
  131. /**
  132. * Test that RequestHandler sets $this->ext when jQuery sends its wonky-ish headers.
  133. */
  134. public function testInitializeContentTypeWithjQueryAccept(): void
  135. {
  136. Router::reload();
  137. $this->Controller->setRequest($this->request
  138. ->withHeader('Accept', 'application/json, application/javascript, */*; q=0.01')
  139. ->withHeader('X-Requested-With', 'XMLHttpRequest'));
  140. $this->RequestHandler->setExt(null);
  141. Router::extensions('json', false);
  142. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  143. $this->assertSame('json', $this->RequestHandler->getExt());
  144. }
  145. /**
  146. * Test that RequestHandler does not set extension to csv for text/plain mimetype
  147. */
  148. public function testInitializeContentTypeWithjQueryTextPlainAccept(): void
  149. {
  150. Router::reload();
  151. $this->Controller->setRequest($this->request->withHeader('Accept', 'text/plain, */*; q=0.01'));
  152. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  153. $this->assertNull($this->RequestHandler->ext);
  154. }
  155. /**
  156. * Test that RequestHandler sets $this->ext when jQuery sends its wonky-ish headers
  157. * and the application is configured to handle multiple extensions
  158. */
  159. public function testInitializeContentTypeWithjQueryAcceptAndMultiplesExtensions(): void
  160. {
  161. Router::reload();
  162. $this->Controller->setRequest($this->request->withHeader('Accept', 'application/json, application/javascript, */*; q=0.01'));
  163. $this->RequestHandler->setExt(null);
  164. Router::extensions(['rss', 'json'], false);
  165. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  166. $this->assertSame('json', $this->RequestHandler->getExt());
  167. }
  168. /**
  169. * Test that RequestHandler does not set $this->ext when multiple accepts are sent.
  170. */
  171. public function testInitializeNoContentTypeWithSingleAccept(): void
  172. {
  173. Router::reload();
  174. $_SERVER['HTTP_ACCEPT'] = 'application/json, text/html, */*; q=0.01';
  175. $this->assertNull($this->RequestHandler->getExt());
  176. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  177. $this->assertNull($this->RequestHandler->getExt());
  178. }
  179. /**
  180. * Test that ext is set to the first listed extension with multiple accepted
  181. * content types.
  182. * Having multiple types accepted with same weight, means the client lets the
  183. * server choose the returned content type.
  184. */
  185. public function testInitializeNoContentTypeWithMultipleAcceptedTypes(): void
  186. {
  187. $this->Controller->setRequest($this->request->withHeader(
  188. 'Accept',
  189. 'application/json, application/javascript, application/xml, */*; q=0.01'
  190. ));
  191. $this->RequestHandler->setExt(null);
  192. Router::extensions(['xml', 'json'], false);
  193. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  194. $this->assertSame('xml', $this->RequestHandler->getExt());
  195. $this->RequestHandler->setExt(null);
  196. Router::extensions(['json', 'xml'], false);
  197. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  198. $this->assertSame('json', $this->RequestHandler->getExt());
  199. }
  200. /**
  201. * Test that ext is set to type with highest weight
  202. */
  203. public function testInitializeContentTypeWithMultipleAcceptedTypes(): void
  204. {
  205. Router::reload();
  206. $this->Controller->setRequest($this->request->withHeader(
  207. 'Accept',
  208. 'text/csv;q=1.0, application/json;q=0.8, application/xml;q=0.7'
  209. ));
  210. $this->RequestHandler->setExt(null);
  211. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  212. $this->assertSame('json', $this->RequestHandler->getExt());
  213. }
  214. /**
  215. * Test that ext is not set with confusing android accepts headers.
  216. */
  217. public function testInitializeAmbiguousAndroidAccepts(): void
  218. {
  219. Router::reload();
  220. $this->request = $this->request->withEnv(
  221. 'HTTP_ACCEPT',
  222. 'application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5'
  223. );
  224. $this->RequestHandler->setExt(null);
  225. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  226. $this->assertNull($this->RequestHandler->getExt());
  227. }
  228. /**
  229. * Test that the headers sent by firefox are not treated as XML requests.
  230. */
  231. public function testInititalizeFirefoxHeaderNotXml(): void
  232. {
  233. $_SERVER['HTTP_ACCEPT'] = 'text/html,application/xhtml+xml,application/xml;image/png,image/jpeg,image/*;q=0.9,*/*;q=0.8';
  234. Router::extensions(['xml', 'json'], false);
  235. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  236. $this->assertNull($this->RequestHandler->getExt());
  237. }
  238. /**
  239. * Test that a type mismatch doesn't incorrectly set the ext
  240. */
  241. public function testInitializeContentTypeAndExtensionMismatch(): void
  242. {
  243. $this->assertNull($this->RequestHandler->getExt());
  244. $extensions = Router::extensions();
  245. Router::extensions('xml', false);
  246. $request = new ServerRequest([
  247. 'environment' => ['HTTP_ACCEPT' => 'text/plain'],
  248. ]);
  249. $this->Controller->setRequest($request);
  250. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  251. $this->assertNull($this->RequestHandler->getExt());
  252. Router::extensions($extensions, false);
  253. }
  254. /**
  255. * Test that startup() throws deprecation warning if input data is available and request data is not populated.
  256. */
  257. public function testInitializeInputNoWarningEmptyJsonObject(): void
  258. {
  259. $request = new ServerRequest([
  260. 'input' => json_encode([]),
  261. ]);
  262. $this->Controller->setRequest($request->withMethod('POST'));
  263. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  264. $this->assertSame([], $request->getParsedBody());
  265. }
  266. /**
  267. * testViewClassMap
  268. */
  269. public function testViewClassMap(): void
  270. {
  271. $this->RequestHandler->setConfig(['viewClassMap' => ['json' => 'CustomJson']]);
  272. $result = $this->RequestHandler->getConfig('viewClassMap');
  273. $expected = [
  274. 'json' => 'CustomJson',
  275. 'xml' => 'Xml',
  276. 'ajax' => 'Ajax',
  277. ];
  278. $this->assertEquals($expected, $result);
  279. $this->RequestHandler->setConfig(['viewClassMap' => ['xls' => 'Excel.Excel']]);
  280. $result = $this->RequestHandler->getConfig('viewClassMap');
  281. $expected = [
  282. 'json' => 'CustomJson',
  283. 'xml' => 'Xml',
  284. 'ajax' => 'Ajax',
  285. 'xls' => 'Excel.Excel',
  286. ];
  287. $this->assertEquals($expected, $result);
  288. $this->RequestHandler->renderAs($this->Controller, 'json');
  289. $this->assertSame('TestApp\View\CustomJsonView', $this->Controller->viewBuilder()->getClassName());
  290. }
  291. /**
  292. * Verify that isAjax is set on the request params for AJAX requests
  293. *
  294. * @triggers Controller.startup $this->Controller
  295. */
  296. public function testIsAjaxParams(): void
  297. {
  298. $this->Controller->setRequest($this->request->withHeader('X-Requested-With', 'XMLHttpRequest'));
  299. $event = new Event('Controller.startup', $this->Controller);
  300. $this->Controller->beforeFilter($event);
  301. $this->RequestHandler->startup($event);
  302. $this->assertTrue($this->Controller->getRequest()->getAttribute('isAjax'));
  303. }
  304. /**
  305. * testAutoAjaxLayout method
  306. *
  307. * @triggers Controller.startup $this->Controller
  308. */
  309. public function testAutoAjaxLayout(): void
  310. {
  311. $event = new Event('Controller.startup', $this->Controller);
  312. $this->Controller->setRequest($this->request->withHeader('X-Requested-With', 'XMLHttpRequest'));
  313. $this->RequestHandler->startup($event);
  314. $event = new Event('Controller.beforeRender', $this->Controller);
  315. $this->RequestHandler->beforeRender($event);
  316. $view = $this->Controller->createView();
  317. $this->assertInstanceOf(AjaxView::class, $view);
  318. $this->assertSame('ajax', $view->getLayout());
  319. $this->assertSame((new Response(['type' => 'ajax']))->getType(), $view->getResponse()->getType());
  320. $this->_init();
  321. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'js'));
  322. $this->RequestHandler->startup($event);
  323. $this->assertNotEquals(AjaxView::class, $this->Controller->viewBuilder()->getClassName());
  324. }
  325. /**
  326. * @return array
  327. */
  328. public function defaultExtensionsProvider(): array
  329. {
  330. return [['html'], ['htm']];
  331. }
  332. /**
  333. * Tests that the default extensions are using the default view.
  334. *
  335. * @param string $extension Extension to test.
  336. * @dataProvider defaultExtensionsProvider
  337. */
  338. public function testDefaultExtensions($extension): void
  339. {
  340. Router::extensions([$extension], false);
  341. $this->Controller->setRequest($this->request->withParam('_ext', $extension));
  342. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  343. $this->RequestHandler->beforeRender(new Event('Controller.beforeRender', $this->Controller));
  344. $this->assertSame($extension, $this->RequestHandler->getExt());
  345. $this->assertSame('text/html', $this->Controller->getResponse()->getType());
  346. $view = $this->Controller->createView();
  347. $this->assertInstanceOf(AppView::class, $view);
  348. $this->assertEmpty($view->getLayoutPath());
  349. $this->assertEmpty($view->getSubDir());
  350. }
  351. /**
  352. * Tests that the default extensions can be overwritten by the accept header.
  353. *
  354. * @param string $extension Extension to test.
  355. * @dataProvider defaultExtensionsProvider
  356. */
  357. public function testDefaultExtensionsOverwrittenByAcceptHeader($extension): void
  358. {
  359. Router::extensions([$extension], false);
  360. $request = $this->request->withHeader(
  361. 'Accept',
  362. 'application/xml'
  363. );
  364. $this->Controller->setRequest($request->withParam('_ext', $extension));
  365. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  366. $this->RequestHandler->beforeRender(new Event('Controller.beforeRender', $this->Controller));
  367. $this->assertSame('xml', $this->RequestHandler->getExt());
  368. $this->assertSame('application/xml', $this->Controller->getResponse()->getType());
  369. $view = $this->Controller->createView();
  370. $this->assertInstanceOf(XmlView::class, $view);
  371. $this->assertSame('xml', $view->getLayoutPath());
  372. $this->assertSame('xml', $view->getSubDir());
  373. }
  374. /**
  375. * test custom JsonView class is loaded and correct.
  376. *
  377. * @triggers Controller.startup $this->Controller
  378. */
  379. public function testJsonViewLoaded(): void
  380. {
  381. Router::extensions(['json', 'xml', 'ajax'], false);
  382. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'json'));
  383. $event = new Event('Controller.startup', $this->Controller);
  384. $this->RequestHandler->startup($event);
  385. $event = new Event('Controller.beforeRender', $this->Controller);
  386. $this->RequestHandler->beforeRender($event);
  387. $view = $this->Controller->createView();
  388. $this->assertInstanceOf(JsonView::class, $view);
  389. $this->assertSame('json', $view->getLayoutPath());
  390. $this->assertSame('json', $view->getSubDir());
  391. }
  392. /**
  393. * test custom XmlView class is loaded and correct.
  394. *
  395. * @triggers Controller.startup $this->Controller
  396. */
  397. public function testXmlViewLoaded(): void
  398. {
  399. Router::extensions(['json', 'xml', 'ajax'], false);
  400. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'xml'));
  401. $event = new Event('Controller.startup', $this->Controller);
  402. $this->RequestHandler->startup($event);
  403. $event = new Event('Controller.beforeRender', $this->Controller);
  404. $this->RequestHandler->beforeRender($event);
  405. $view = $this->Controller->createView();
  406. $this->assertInstanceOf(XmlView::class, $view);
  407. $this->assertSame('xml', $view->getLayoutPath());
  408. $this->assertSame('xml', $view->getSubDir());
  409. }
  410. /**
  411. * test custom AjaxView class is loaded and correct.
  412. *
  413. * @triggers Controller.startup $this->Controller
  414. */
  415. public function testAjaxViewLoaded(): void
  416. {
  417. Router::extensions(['json', 'xml', 'ajax'], false);
  418. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'ajax'));
  419. $event = new Event('Controller.startup', $this->Controller);
  420. $this->RequestHandler->startup($event);
  421. $event = new Event('Controller.beforeRender', $this->Controller);
  422. $this->RequestHandler->beforeRender($event);
  423. $view = $this->Controller->createView();
  424. $this->assertInstanceOf(AjaxView::class, $view);
  425. $this->assertSame('ajax', $view->getLayout());
  426. }
  427. /**
  428. * test configured extension but no view class set.
  429. *
  430. * @triggers Controller.beforeRender $this->Controller
  431. */
  432. public function testNoViewClassExtension(): void
  433. {
  434. Router::extensions(['json', 'xml', 'ajax', 'csv'], false);
  435. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'csv'));
  436. $event = new Event('Controller.startup', $this->Controller);
  437. $this->RequestHandler->startup($event);
  438. $this->Controller->getEventManager()->on('Controller.beforeRender', function () {
  439. return $this->Controller->getResponse();
  440. });
  441. $this->Controller->render();
  442. $this->assertSame('RequestHandlerTest' . DS . 'csv', $this->Controller->viewBuilder()->getTemplatePath());
  443. $this->assertSame('csv', $this->Controller->viewBuilder()->getLayoutPath());
  444. }
  445. /**
  446. * Tests that configured extensions that have no configured mimetype do not silently fallback to HTML.
  447. */
  448. public function testUnrecognizedExtensionFailure(): void
  449. {
  450. $this->expectException(NotFoundException::class);
  451. $this->expectExceptionMessage('Invoked extension not recognized/configured: foo');
  452. Router::extensions(['json', 'foo'], false);
  453. $this->Controller->setRequest($this->Controller->getRequest()->withParam('_ext', 'foo'));
  454. $event = new Event('Controller.startup', $this->Controller);
  455. $this->RequestHandler->startup($event);
  456. $this->Controller->getEventManager()->on('Controller.beforeRender', function () {
  457. return $this->Controller->getResponse();
  458. });
  459. $this->Controller->render();
  460. $this->assertSame('RequestHandlerTest' . DS . 'csv', $this->Controller->viewBuilder()->getTemplatePath());
  461. }
  462. /**
  463. * testRenderAs method
  464. */
  465. public function testRenderAs(): void
  466. {
  467. $this->RequestHandler->renderAs($this->Controller, 'rss');
  468. $this->Controller->viewBuilder()->setTemplatePath('request_handler_test\\rss');
  469. $this->RequestHandler->renderAs($this->Controller, 'js');
  470. $this->assertSame('request_handler_test' . DS . 'js', $this->Controller->viewBuilder()->getTemplatePath());
  471. }
  472. /**
  473. * test that attachment headers work with renderAs
  474. */
  475. public function testRenderAsWithAttachment(): void
  476. {
  477. $this->Controller->setRequest($this->request->withHeader('Accept', 'application/xml;q=1.0'));
  478. $this->RequestHandler->renderAs($this->Controller, 'xml', ['attachment' => 'myfile.xml']);
  479. $this->assertSame(XmlView::class, $this->Controller->viewBuilder()->getClassName());
  480. $this->assertSame('application/xml', $this->Controller->getResponse()->getType());
  481. $this->assertSame('UTF-8', $this->Controller->getResponse()->getCharset());
  482. $this->assertStringContainsString('myfile.xml', $this->Controller->getResponse()->getHeaderLine('Content-Disposition'));
  483. }
  484. /**
  485. * test that respondAs works as expected.
  486. */
  487. public function testRespondAs(): void
  488. {
  489. $result = $this->RequestHandler->respondAs('json');
  490. $this->assertTrue($result);
  491. $this->assertSame('application/json', $this->Controller->getResponse()->getType());
  492. $result = $this->RequestHandler->respondAs('text/xml');
  493. $this->assertTrue($result);
  494. $this->assertSame('text/xml', $this->Controller->getResponse()->getType());
  495. }
  496. /**
  497. * test that attachment headers work with respondAs
  498. */
  499. public function testRespondAsWithAttachment(): void
  500. {
  501. $result = $this->RequestHandler->respondAs('xml', ['attachment' => 'myfile.xml']);
  502. $this->assertTrue($result);
  503. $response = $this->Controller->getResponse();
  504. $this->assertStringContainsString('myfile.xml', $response->getHeaderLine('Content-Disposition'));
  505. $this->assertStringContainsString('application/xml', $response->getType());
  506. }
  507. /**
  508. * test that calling renderAs() more than once continues to work.
  509. *
  510. * @link #6466
  511. */
  512. public function testRenderAsCalledTwice(): void
  513. {
  514. $this->Controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $e) {
  515. return $e->getSubject()->getResponse();
  516. });
  517. $this->Controller->render();
  518. $this->RequestHandler->renderAs($this->Controller, 'print');
  519. $this->assertSame('RequestHandlerTest' . DS . 'print', $this->Controller->viewBuilder()->getTemplatePath());
  520. $this->assertSame('print', $this->Controller->viewBuilder()->getLayoutPath());
  521. $this->RequestHandler->renderAs($this->Controller, 'js');
  522. $this->assertSame('RequestHandlerTest' . DS . 'js', $this->Controller->viewBuilder()->getTemplatePath());
  523. $this->assertSame('js', $this->Controller->viewBuilder()->getLayoutPath());
  524. }
  525. /**
  526. * testRequestContentTypes method
  527. */
  528. public function testRequestContentTypes(): void
  529. {
  530. $this->Controller->setRequest($this->request->withEnv('REQUEST_METHOD', 'GET'));
  531. $this->assertNull($this->RequestHandler->requestedWith());
  532. $this->Controller->setRequest($this->request->withEnv('REQUEST_METHOD', 'POST')
  533. ->withEnv('CONTENT_TYPE', 'application/json'));
  534. $this->assertSame('json', $this->RequestHandler->requestedWith());
  535. $result = $this->RequestHandler->requestedWith(['json', 'xml']);
  536. $this->assertSame('json', $result);
  537. $result = $this->RequestHandler->requestedWith(['rss', 'atom']);
  538. $this->assertFalse($result);
  539. $this->Controller->setRequest($this->request
  540. ->withEnv('REQUEST_METHOD', 'PATCH')
  541. ->withEnv('CONTENT_TYPE', 'application/json'));
  542. $this->assertSame('json', $this->RequestHandler->requestedWith());
  543. $this->Controller->setRequest($this->request
  544. ->withEnv('REQUEST_METHOD', 'DELETE')
  545. ->withEnv('CONTENT_TYPE', 'application/json'));
  546. $this->assertSame('json', $this->RequestHandler->requestedWith());
  547. $this->Controller->setRequest($this->request
  548. ->withEnv('REQUEST_METHOD', 'POST')
  549. ->withEnv('CONTENT_TYPE', 'application/json'));
  550. $result = $this->RequestHandler->requestedWith(['json', 'xml']);
  551. $this->assertSame('json', $result);
  552. $result = $this->RequestHandler->requestedWith(['rss', 'atom']);
  553. $this->assertFalse($result);
  554. $this->Controller->setRequest($this->request->withHeader(
  555. 'Accept',
  556. 'text/xml,application/xml,application/xhtml+xml,text/html,text/plain,image/png,*/*'
  557. ));
  558. $this->assertTrue($this->RequestHandler->prefers('xml'));
  559. $this->assertFalse($this->RequestHandler->prefers('atom'));
  560. $this->assertFalse($this->RequestHandler->prefers('rss'));
  561. $this->Controller->setRequest($this->request->withHeader(
  562. 'Accept',
  563. 'application/atom+xml,text/xml,application/xml,application/xhtml+xml,text/html,text/plain,image/png,*/*'
  564. ));
  565. $this->assertTrue($this->RequestHandler->prefers('atom'));
  566. $this->assertFalse($this->RequestHandler->prefers('rss'));
  567. $this->Controller->setRequest($this->request->withHeader(
  568. 'Accept',
  569. 'application/rss+xml,text/xml,application/xml,application/xhtml+xml,text/html,text/plain,image/png,*/*'
  570. ));
  571. $this->assertFalse($this->RequestHandler->prefers('atom'));
  572. $this->assertTrue($this->RequestHandler->prefers('rss'));
  573. }
  574. /**
  575. * test that map alias converts aliases to content types.
  576. */
  577. public function testMapAlias(): void
  578. {
  579. $result = $this->RequestHandler->mapAlias('xml');
  580. $this->assertSame('application/xml', $result);
  581. $result = $this->RequestHandler->mapAlias('text/html');
  582. $this->assertNull($result);
  583. $result = $this->RequestHandler->mapAlias('wap');
  584. $this->assertSame('text/vnd.wap.wml', $result);
  585. $result = $this->RequestHandler->mapAlias(['xml', 'js', 'json']);
  586. $expected = ['application/xml', 'application/javascript', 'application/json'];
  587. $this->assertEquals($expected, $result);
  588. }
  589. /**
  590. * test accepts() on the component
  591. */
  592. public function testAccepts(): void
  593. {
  594. $this->Controller->setRequest($this->request->withHeader(
  595. 'Accept',
  596. 'text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5'
  597. ));
  598. $this->assertTrue($this->RequestHandler->accepts(['js', 'xml', 'html']));
  599. $this->assertFalse($this->RequestHandler->accepts(['gif', 'jpeg', 'foo']));
  600. $this->Controller->setRequest($this->request->withHeader('Accept', '*/*;q=0.5'));
  601. $this->assertFalse($this->RequestHandler->accepts('rss'));
  602. }
  603. /**
  604. * test accepts and prefers methods.
  605. */
  606. public function testPrefers(): void
  607. {
  608. $this->Controller->setRequest($this->request->withHeader(
  609. 'Accept',
  610. 'text/xml,application/xml,application/xhtml+xml,text/html,text/plain,image/png,*/*'
  611. ));
  612. $this->assertNotEquals('rss', $this->RequestHandler->prefers());
  613. $this->RequestHandler->setExt('rss');
  614. $this->assertSame('rss', $this->RequestHandler->prefers());
  615. $this->assertFalse($this->RequestHandler->prefers('xml'));
  616. $this->assertSame('xml', $this->RequestHandler->prefers(['js', 'xml', 'xhtml']));
  617. $this->assertFalse($this->RequestHandler->prefers(['red', 'blue']));
  618. $this->assertSame('xhtml', $this->RequestHandler->prefers(['js', 'json', 'xhtml']));
  619. $this->assertTrue($this->RequestHandler->prefers(['rss']), 'Should return true if input matches ext.');
  620. $this->assertFalse($this->RequestHandler->prefers(['html']), 'No match with ext, return false.');
  621. $this->_init();
  622. $this->Controller->setRequest($this->request->withHeader(
  623. 'Accept',
  624. 'text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5'
  625. ));
  626. $this->assertSame('xml', $this->RequestHandler->prefers());
  627. $this->Controller->setRequest($this->request->withHeader('Accept', '*/*;q=0.5'));
  628. $this->assertSame('html', $this->RequestHandler->prefers());
  629. $this->assertFalse($this->RequestHandler->prefers('rss'));
  630. $this->Controller->setRequest($this->request->withEnv('HTTP_ACCEPT', ''));
  631. $this->RequestHandler->setExt('json');
  632. $this->assertFalse($this->RequestHandler->prefers('xml'));
  633. }
  634. /**
  635. * Test checkNotModified method
  636. *
  637. * @triggers Controller.beforeRender $this->Controller
  638. */
  639. public function testCheckNotModifiedByEtagStar(): void
  640. {
  641. $response = new Response();
  642. $response = $response->withEtag('something')
  643. ->withHeader('Content-Type', 'text/plain')
  644. ->withStringBody('keeper');
  645. $this->Controller->setResponse($response);
  646. $this->Controller->setRequest($this->request->withHeader('If-None-Match', '*'));
  647. $event = new Event('Controller.beforeRender', $this->Controller);
  648. $requestHandler = new RequestHandlerComponent($this->Controller->components());
  649. $requestHandler->beforeRender($event);
  650. $this->assertTrue($event->isStopped());
  651. $this->assertSame(304, $this->Controller->getResponse()->getStatusCode());
  652. $this->assertSame('', (string)$this->Controller->getResponse()->getBody());
  653. $this->assertFalse($this->Controller->getResponse()->hasHeader('Content-Type'), 'header should not be removed.');
  654. }
  655. /**
  656. * Test checkNotModified method
  657. *
  658. * @triggers Controller.beforeRender
  659. */
  660. public function testCheckNotModifiedByEtagExact(): void
  661. {
  662. $response = new Response();
  663. $response = $response->withEtag('something', true)
  664. ->withHeader('Content-Type', 'text/plain')
  665. ->withStringBody('keeper');
  666. $this->Controller->setResponse($response);
  667. $this->Controller->setRequest($this->request->withHeader('If-None-Match', 'W/"something", "other"'));
  668. $event = new Event('Controller.beforeRender', $this->Controller);
  669. $requestHandler = new RequestHandlerComponent($this->Controller->components());
  670. $requestHandler->beforeRender($event);
  671. $this->assertTrue($event->isStopped());
  672. $this->assertSame(304, $this->Controller->getResponse()->getStatusCode());
  673. $this->assertSame('', (string)$this->Controller->getResponse()->getBody());
  674. $this->assertFalse($this->Controller->getResponse()->hasHeader('Content-Type'));
  675. }
  676. /**
  677. * Test checkNotModified method
  678. *
  679. * @triggers Controller.beforeRender $this->Controller
  680. */
  681. public function testCheckNotModifiedByEtagAndTime(): void
  682. {
  683. $this->Controller->setRequest($this->request
  684. ->withHeader('If-None-Match', 'W/"something", "other"')
  685. ->withHeader('If-Modified-Since', '2012-01-01 00:00:00'));
  686. $response = new Response();
  687. $response = $response->withEtag('something', true)
  688. ->withHeader('Content-type', 'text/plain')
  689. ->withStringBody('should be removed')
  690. ->withModified('2012-01-01 00:00:00');
  691. $this->Controller->setResponse($response);
  692. $event = new Event('Controller.beforeRender', $this->Controller);
  693. $requestHandler = new RequestHandlerComponent($this->Controller->components());
  694. $requestHandler->beforeRender($event);
  695. $this->assertTrue($event->isStopped());
  696. $this->assertSame(304, $this->Controller->getResponse()->getStatusCode());
  697. $this->assertSame('', (string)$this->Controller->getResponse()->getBody());
  698. $this->assertFalse($this->Controller->getResponse()->hasHeader('Content-type'));
  699. }
  700. /**
  701. * Test checkNotModified method
  702. *
  703. * @triggers Controller.beforeRender $this->Controller
  704. */
  705. public function testCheckNotModifiedNoInfo(): void
  706. {
  707. $response = new Response();
  708. $this->Controller->setResponse($response);
  709. $event = new Event('Controller.beforeRender', $this->Controller);
  710. $requestHandler = new RequestHandlerComponent($this->Controller->components());
  711. $requestHandler->beforeRender($event);
  712. $this->assertSame(200, $response->getStatusCode());
  713. }
  714. /**
  715. * Test default options in construction
  716. */
  717. public function testConstructDefaultOptions(): void
  718. {
  719. $requestHandler = new RequestHandlerComponent($this->Controller->components());
  720. $viewClass = $requestHandler->getConfig('viewClassMap');
  721. $expected = [
  722. 'json' => 'Json',
  723. 'xml' => 'Xml',
  724. 'ajax' => 'Ajax',
  725. ];
  726. $this->assertEquals($expected, $viewClass);
  727. }
  728. /**
  729. * Test options in constructor replace defaults
  730. */
  731. public function testConstructReplaceOptions(): void
  732. {
  733. $requestHandler = new RequestHandlerComponent(
  734. $this->Controller->components(),
  735. [
  736. 'viewClassMap' => ['json' => 'Json'],
  737. 'inputTypeMap' => ['json' => ['json_decode', true]],
  738. ]
  739. );
  740. $viewClass = $requestHandler->getConfig('viewClassMap');
  741. $expected = [
  742. 'json' => 'Json',
  743. ];
  744. $this->assertEquals($expected, $viewClass);
  745. $inputs = $requestHandler->getConfig('inputTypeMap');
  746. $this->assertArrayHasKey('json', $inputs);
  747. $this->assertCount(1, $inputs);
  748. }
  749. /**
  750. * test beforeRender() doesn't override response type set in controller action
  751. */
  752. public function testBeforeRender(): void
  753. {
  754. $this->Controller->set_response_type();
  755. $event = new Event('Controller.beforeRender', $this->Controller);
  756. $this->RequestHandler->beforeRender($event);
  757. $this->assertSame('text/plain', $this->Controller->getResponse()->getType());
  758. }
  759. /**
  760. * tests beforeRender automatically uses renderAs when a supported extension is found
  761. */
  762. public function testBeforeRenderAutoRenderAs(): void
  763. {
  764. $this->Controller->setRequest($this->request->withParam('_ext', 'csv'));
  765. $this->RequestHandler->startup(new Event('Controller.startup', $this->Controller));
  766. $event = new Event('Controller.beforeRender', $this->Controller);
  767. $this->RequestHandler->beforeRender($event);
  768. $this->assertSame('text/csv', $this->Controller->getResponse()->getType());
  769. }
  770. }