cakephp/tests/TestCase/Model/Behavior/TimestampBehaviorTest.php

<?php
/**
 * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
 * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 *
 * Licensed under The MIT License
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 * @link          http://cakephp.org CakePHP(tm) Project
 * @since         3.0.0
 * @license       http://www.opensource.org/licenses/mit-license.php MIT License
 */
namespace Cake\Test\TestCase\Model\Behavior;

use Cake\Event\Event;
use Cake\I18n\Time;
use Cake\Model\Behavior\TimestampBehavior;
use Cake\ORM\Entity;
use Cake\ORM\TableRegistry;
use Cake\TestSuite\TestCase;

/**
 * Behavior test case
 */
class TimestampBehaviorTest extends TestCase {

/**
 * autoFixtures
 *
 * Don't load fixtures for all tests
 *
 * @var bool
 */
	public $autoFixtures = false;

/**
 * fixtures
 *
 * @var array
 */
	public $fixtures = [
		'core.users'
	];

/**
 * Sanity check Implemented events
 *
 * @return void
 */
	public function testImplementedEventsDefault() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);

		$expected = [
			'Model.beforeSave' => 'handleEvent'
		];
		$this->assertEquals($expected, $this->Behavior->implementedEvents());
	}

/**
 * testImplementedEventsCustom
 *
 * The behavior allows for handling any event - test an example
 *
 * @return void
 */
	public function testImplementedEventsCustom() {
		$table = $this->getMock('Cake\ORM\Table');
		$settings = ['events' => ['Something.special' => ['date_specialed' => 'always']]];
		$this->Behavior = new TimestampBehavior($table, $settings);

		$expected = [
			'Something.special' => 'handleEvent'
		];
		$this->assertEquals($expected, $this->Behavior->implementedEvents());
	}

/**
 * testCreatedAbsent
 *
 * @return void
 * @triggers Model.beforeSave
 */
	public function testCreatedAbsent() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$event = new Event('Model.beforeSave');
		$entity = new Entity(['name' => 'Foo']);

		$return = $this->Behavior->handleEvent($event, $entity);
		$this->assertTrue($return, 'Handle Event is expected to always return true');
		$this->assertInstanceOf('Cake\I18n\Time', $entity->created);
		$this->assertSame($ts->format('c'), $entity->created->format('c'), 'Created timestamp is not the same');
	}

/**
 * testCreatedPresent
 *
 * @return void
 * @triggers Model.beforeSave
 */
	public function testCreatedPresent() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$event = new Event('Model.beforeSave');
		$existingValue = new \DateTime('2011-11-11');
		$entity = new Entity(['name' => 'Foo', 'created' => $existingValue]);

		$return = $this->Behavior->handleEvent($event, $entity);
		$this->assertTrue($return, 'Handle Event is expected to always return true');
		$this->assertSame($existingValue, $entity->created, 'Created timestamp is expected to be unchanged');
	}

/**
 * testCreatedNotNew
 *
 * @return void
 * @triggers Model.beforeSave
 */
	public function testCreatedNotNew() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$event = new Event('Model.beforeSave');
		$entity = new Entity(['name' => 'Foo']);
		$entity->isNew(false);

		$return = $this->Behavior->handleEvent($event, $entity);
		$this->assertTrue($return, 'Handle Event is expected to always return true');
		$this->assertNull($entity->created, 'Created timestamp is expected to be untouched if the entity is not new');
	}

/**
 * testModifiedAbsent
 *
 * @return void
 * @triggers Model.beforeSave
 */
	public function testModifiedAbsent() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$event = new Event('Model.beforeSave');
		$entity = new Entity(['name' => 'Foo']);
		$entity->isNew(false);

		$return = $this->Behavior->handleEvent($event, $entity);
		$this->assertTrue($return, 'Handle Event is expected to always return true');
		$this->assertInstanceOf('Cake\I18n\Time', $entity->modified);
		$this->assertSame($ts->format('c'), $entity->modified->format('c'), 'Modified timestamp is not the same');
	}

/**
 * testModifiedPresent
 *
 * @return void
 * @triggers Model.beforeSave
 */
	public function testModifiedPresent() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$event = new Event('Model.beforeSave');
		$existingValue = new \DateTime('2011-11-11');
		$entity = new Entity(['name' => 'Foo', 'modified' => $existingValue]);
		$entity->clean();
		$entity->isNew(false);

		$return = $this->Behavior->handleEvent($event, $entity);
		$this->assertTrue($return, 'Handle Event is expected to always return true');
		$this->assertInstanceOf('Cake\I18n\Time', $entity->modified);
		$this->assertSame($ts->format('c'), $entity->modified->format('c'), 'Modified timestamp is expected to be updated');
	}

/**
 * testInvalidEventConfig
 *
 * @expectedException \UnexpectedValueException
 * @expectedExceptionMessage When should be one of "always", "new" or "existing". The passed value "fat fingers" is invalid
 * @return void
 * @triggers Model.beforeSave
 */
	public function testInvalidEventConfig() {
		$table = $this->getMock('Cake\ORM\Table');
		$settings = ['events' => ['Model.beforeSave' => ['created' => 'fat fingers']]];
		$this->Behavior = new TimestampBehavior($table, $settings);

		$event = new Event('Model.beforeSave');
		$entity = new Entity(['name' => 'Foo']);
		$this->Behavior->handleEvent($event, $entity);
	}

/**
 * testGetTimestamp
 *
 * @return void
 */
	public function testGetTimestamp() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);

		$return = $this->Behavior->timestamp();
		$this->assertInstanceOf(
			'DateTime',
			$return,
			'Should return a timestamp object'
		);

		$now = Time::now();
		$this->assertEquals($now, $return);

		return $this->Behavior;
	}

/**
 * testGetTimestampPersists
 *
 * @depends testGetTimestamp
 * @return void
 */
	public function testGetTimestampPersists($behavior) {
		$this->Behavior = $behavior;

		$initialValue = $this->Behavior->timestamp();
		$postValue = $this->Behavior->timestamp();

		$this->assertSame(
			$initialValue,
			$postValue,
			'The timestamp should be exactly the same object'
		);
	}

/**
 * testGetTimestampRefreshes
 *
 * @depends testGetTimestamp
 * @return void
 */
	public function testGetTimestampRefreshes($behavior) {
		$this->Behavior = $behavior;

		$initialValue = $this->Behavior->timestamp();
		$postValue = $this->Behavior->timestamp(null, true);

		$this->assertNotSame(
			$initialValue,
			$postValue,
			'The timestamp should be a different object if refreshTimestamp is truthy'
		);
	}

/**
 * testSetTimestampExplicit
 *
 * @return void
 */
	public function testSetTimestampExplicit() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);

		$ts = new \DateTime();
		$this->Behavior->timestamp($ts);
		$return = $this->Behavior->timestamp();

		$this->assertEquals(
			$ts->format('c'),
			$return->format('c'),
			'Should return the same value as initially set'
		);
	}

/**
 * testTouch
 *
 * @return void
 */
	public function testTouch() {
		$table = $this->getMock('Cake\ORM\Table');
		$this->Behavior = new TimestampBehavior($table);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$entity = new Entity(['username' => 'timestamp test']);
		$return = $this->Behavior->touch($entity);
		$this->assertTrue($return, 'touch is expected to return true if it sets a field value');
		$this->assertSame(
			$ts->format('Y-m-d H:i:s'),
			$entity->modified->format('Y-m-d H:i:s'),
			'Modified field is expected to be updated'
		);
		$this->assertNull($entity->created, 'Created field is NOT expected to change');
	}

/**
 * testTouchNoop
 *
 * @return void
 */
	public function testTouchNoop() {
		$table = $this->getMock('Cake\ORM\Table');
		$config = [
			'events' => [
				'Model.beforeSave' => [
					'created' => 'new',
				]
			]
		];

		$this->Behavior = new TimestampBehavior($table, $config);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$entity = new Entity(['username' => 'timestamp test']);
		$return = $this->Behavior->touch($entity);
		$this->assertFalse($return, 'touch is expected to do nothing and return false');
		$this->assertNull($entity->modified, 'Modified field is NOT expected to change');
		$this->assertNull($entity->created, 'Created field is NOT expected to change');
	}

/**
 * testTouchCustomEvent
 *
 * @return void
 */
	public function testTouchCustomEvent() {
		$table = $this->getMock('Cake\ORM\Table');
		$settings = ['events' => ['Something.special' => ['date_specialed' => 'always']]];
		$this->Behavior = new TimestampBehavior($table, $settings);
		$ts = new \DateTime('2000-01-01');
		$this->Behavior->timestamp($ts);

		$entity = new Entity(['username' => 'timestamp test']);
		$return = $this->Behavior->touch($entity, 'Something.special');
		$this->assertTrue($return, 'touch is expected to return true if it sets a field value');
		$this->assertSame(
			$ts->format('Y-m-d H:i:s'),
			$entity->date_specialed->format('Y-m-d H:i:s'),
			'Modified field is expected to be updated'
		);
		$this->assertNull($entity->created, 'Created field is NOT expected to change');
	}

/**
 * Test that calling save, triggers an insert including the created and updated field values
 *
 * @return void
 */
	public function testSaveTriggersInsert() {
		$this->loadFixtures('Users');

		$table = TableRegistry::get('users');
		$table->addBehavior('Timestamp', [
			'events' => [
				'Model.beforeSave' => [
					'created' => 'new',
					'updated' => 'always'
				]
			]
		]);

		$entity = new Entity(['username' => 'timestamp test']);
		$return = $table->save($entity);
		$this->assertSame($entity, $return, 'The returned object is expected to be the same entity object');

		$row = $table->find('all')->where(['id' => $entity->id])->first();

		$now = Time::now();
		$this->assertEquals($now, $row->created);
		$this->assertEquals($now, $row->updated);
	}
}