'A Title', 'body' => 'A body' ]); $entity->author = new Entity([ 'name' => 'Jose' ]); $table = TableRegistry::get('articles'); $table->belongsTo('authors'); $table->association('authors') ->target() ->rulesChecker() ->add( function (Entity $author, array $options) use ($table) { $this->assertSame($options['repository'], $table->association('authors')->target()); return false; }, ['errorField' => 'name', 'message' => 'This is an error'] ); $this->assertFalse($table->save($entity)); $this->assertTrue($entity->isNew()); $this->assertTrue($entity->author->isNew()); $this->assertNull($entity->get('author_id')); $this->assertNotEmpty($entity->author->errors('name')); $this->assertEquals(['This is an error'], $entity->author->errors('name')); } /** * Tests saving hasOne association and returning a validation error will * abort the saving process * * @group save * @return void */ public function testSaveHasOneWithValidationError() { $entity = new \Cake\ORM\Entity([ 'name' => 'Jose' ]); $entity->article = new \Cake\ORM\Entity([ 'title' => 'A Title', 'body' => 'A body' ]); $table = TableRegistry::get('authors'); $table->hasOne('articles'); $table->association('articles') ->target() ->rulesChecker() ->add( function (Entity $entity) { return false; }, ['errorField' => 'title', 'message' => 'This is an error'] ); $this->assertFalse($table->save($entity)); $this->assertTrue($entity->isNew()); $this->assertTrue($entity->article->isNew()); $this->assertNull($entity->article->id); $this->assertNull($entity->article->get('author_id')); $this->assertFalse($entity->article->dirty('author_id')); $this->assertNotEmpty($entity->article->errors('title')); } /** * Tests saving multiple entities in a hasMany association and getting and * error while saving one of them. It should abort all the save operation * when options are set to defaults * * @return void */ public function testSaveHasManyWithErrorsAtomic() { $entity = new \Cake\ORM\Entity([ 'name' => 'Jose' ]); $entity->articles = [ new \Cake\ORM\Entity([ 'title' => '1', 'body' => 'A body' ]), new \Cake\ORM\Entity([ 'title' => 'Another Title', 'body' => 'Another body' ]) ]; $table = TableRegistry::get('authors'); $table->hasMany('articles'); $table->association('articles') ->target() ->rulesChecker() ->add( function (Entity $entity, $options) use ($table) { $this->assertSame($table, $options['_sourceTable']); return $entity->title === '1'; }, ['errorField' => 'title', 'message' => 'This is an error'] ); $this->assertFalse($table->save($entity)); $this->assertTrue($entity->isNew()); $this->assertTrue($entity->articles[0]->isNew()); $this->assertTrue($entity->articles[1]->isNew()); $this->assertNull($entity->articles[0]->id); $this->assertNull($entity->articles[1]->id); $this->assertNull($entity->articles[0]->author_id); $this->assertNull($entity->articles[1]->author_id); $this->assertEmpty($entity->articles[0]->errors()); $this->assertNotEmpty($entity->articles[1]->errors()); } /** * Tests that it is possible to continue saving hasMany associations * even if any of the records fail validation when atomic is set * to false * * @return void */ public function testSaveHasManyWithErrorsNonAtomic() { $entity = new \Cake\ORM\Entity([ 'name' => 'Jose' ]); $entity->articles = [ new \Cake\ORM\Entity([ 'title' => 'A title', 'body' => 'A body' ]), new \Cake\ORM\Entity([ 'title' => '1', 'body' => 'Another body' ]) ]; $table = TableRegistry::get('authors'); $table->hasMany('articles'); $table->association('articles') ->target() ->rulesChecker() ->add( function (Entity $article) { return is_numeric($article->title); }, ['errorField' => 'title', 'message' => 'This is an error'] ); $result = $table->save($entity, ['atomic' => false]); $this->assertSame($entity, $result); $this->assertFalse($entity->isNew()); $this->assertTrue($entity->articles[0]->isNew()); $this->assertFalse($entity->articles[1]->isNew()); $this->assertEquals(4, $entity->articles[1]->id); $this->assertNull($entity->articles[0]->id); $this->assertNotEmpty($entity->articles[0]->errors('title')); } /** * Tests saving belongsToMany records with a validation error in a joint entity * * @group save * @return void */ public function testSaveBelongsToManyWithValidationErrorInJointEntity() { $entity = new \Cake\ORM\Entity([ 'title' => 'A Title', 'body' => 'A body' ]); $entity->tags = [ new \Cake\ORM\Entity([ 'name' => 'Something New' ]), new \Cake\ORM\Entity([ 'name' => '100' ]) ]; $table = TableRegistry::get('articles'); $table->belongsToMany('tags'); $table->association('tags') ->junction() ->rulesChecker() ->add(function (Entity $entity) { return $entity->article_id > 4; }); $this->assertFalse($table->save($entity)); $this->assertTrue($entity->isNew()); $this->assertTrue($entity->tags[0]->isNew()); $this->assertTrue($entity->tags[1]->isNew()); $this->assertNull($entity->tags[0]->id); $this->assertNull($entity->tags[1]->id); $this->assertNull($entity->tags[0]->_joinData); $this->assertNull($entity->tags[1]->_joinData); } /** * Tests saving belongsToMany records with a validation error in a joint entity * and atomic set to false * * @group save * @return void */ public function testSaveBelongsToManyWithValidationErrorInJointEntityNonAtomic() { $entity = new \Cake\ORM\Entity([ 'title' => 'A Title', 'body' => 'A body' ]); $entity->tags = [ new \Cake\ORM\Entity([ 'name' => 'Something New' ]), new \Cake\ORM\Entity([ 'name' => 'New one' ]) ]; $table = TableRegistry::get('articles'); $table->belongsToMany('tags'); $table->association('tags') ->junction() ->rulesChecker() ->add(function (Entity $entity) { return $entity->tag_id > 4; }); $this->assertSame($entity, $table->save($entity, ['atomic' => false])); $this->assertFalse($entity->isNew()); $this->assertFalse($entity->tags[0]->isNew()); $this->assertFalse($entity->tags[1]->isNew()); $this->assertEquals(4, $entity->tags[0]->id); $this->assertEquals(5, $entity->tags[1]->id); $this->assertTrue($entity->tags[0]->_joinData->isNew()); $this->assertEquals(4, $entity->tags[1]->_joinData->article_id); $this->assertEquals(5, $entity->tags[1]->_joinData->tag_id); } /** * Test adding rule with name * * @group save * @return void */ public function testAddingRuleWithName() { $entity = new Entity([ 'name' => 'larry' ]); $table = TableRegistry::get('Authors'); $rules = $table->rulesChecker(); $rules->add( function () { return false; }, 'ruleName', ['errorField' => 'name'] ); $this->assertFalse($table->save($entity)); $this->assertEquals(['ruleName' => 'invalid'], $entity->errors('name')); } /** * Tests the isUnique domain rule * * @group save * @return void */ public function testIsUniqueDomainRule() { $entity = new Entity([ 'name' => 'larry' ]); $table = TableRegistry::get('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->isUnique(['name'])); $this->assertFalse($table->save($entity)); $this->assertEquals(['_isUnique' => 'This value is already in use'], $entity->errors('name')); $entity->name = 'jose'; $this->assertSame($entity, $table->save($entity)); $entity = $table->get(1); $entity->dirty('name', true); $this->assertSame($entity, $table->save($entity)); } /** * Tests isUnique with multiple fields * * @group save * @return void */ public function testIsUniqueMultipleFields() { $entity = new Entity([ 'author_id' => 1, 'title' => 'First Article' ]); $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->add($rules->isUnique(['title', 'author_id'], 'Nope')); $this->assertFalse($table->save($entity)); $this->assertEquals(['title' => ['_isUnique' => 'Nope']], $entity->errors()); $entity->clean(); $entity->author_id = 2; $this->assertSame($entity, $table->save($entity)); } /** * Tests the existsIn domain rule * * @group save * @return void */ public function testExistsInDomainRule() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', 'Authors')); $this->assertFalse($table->save($entity)); $this->assertEquals(['_existsIn' => 'This value does not exist'], $entity->errors('author_id')); } /** * Tests the existsIn domain rule when passing an object * * @group save * @return void */ public function testExistsInDomainRuleWithObject() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', TableRegistry::get('Authors'), 'Nope')); $this->assertFalse($table->save($entity)); $this->assertEquals(['_existsIn' => 'Nope'], $entity->errors('author_id')); } /** * ExistsIn uses the schema to verify that nullable fields are ok. * * @return */ public function testExistsInNullValue() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => null ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', 'Authors')); $this->assertEquals($entity, $table->save($entity)); $this->assertEquals([], $entity->errors('author_id')); } /** * Tests exists in uses the bindingKey of the association * * @return */ public function testExistsInWithBindingKey() { $entity = new Entity([ 'title' => 'An Article', ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors', [ 'bindingKey' => 'name', 'foreignKey' => 'title' ]); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('title', 'Authors')); $this->assertFalse($table->save($entity)); $this->assertNotEmpty($entity->errors('title')); $entity->clean(); $entity->title = 'larry'; $this->assertEquals($entity, $table->save($entity)); } /** * Tests existsIn with invalid associations * * @group save * @expectedException RuntimeException * @expectedExceptionMessage ExistsIn rule for 'author_id' is invalid. The 'NotValid' association is not defined. * @return void */ public function testExistsInInvalidAssociation() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', 'NotValid')); $table->save($entity); } /** * Tests the checkRules save option * * @group save * @return void */ public function testSkipRulesChecking() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', TableRegistry::get('Authors'), 'Nope')); $this->assertSame($entity, $table->save($entity, ['checkRules' => false])); } /** * Tests the beforeRules event * * @group save * @return void */ public function testUseBeforeRules() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', TableRegistry::get('Authors'), 'Nope')); $table->eventManager()->attach( function ($event, Entity $entity, \ArrayObject $options, $operation) { $this->assertEquals( [ 'atomic' => true, 'associated' => true, 'checkRules' => true, 'checkExisting' => true, '_primary' => true, ], $options->getArrayCopy() ); $this->assertEquals('create', $operation); $event->stopPropagation(); return true; }, 'Model.beforeRules' ); $this->assertSame($entity, $table->save($entity)); } /** * Tests the afterRules event * * @group save * @return void */ public function testUseAfterRules() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', TableRegistry::get('Authors'), 'Nope')); $table->eventManager()->attach( function ($event, Entity $entity, \ArrayObject $options, $result, $operation) { $this->assertEquals( [ 'atomic' => true, 'associated' => true, 'checkRules' => true, 'checkExisting' => true, '_primary' => true, ], $options->getArrayCopy() ); $this->assertEquals('create', $operation); $this->assertFalse($result); $event->stopPropagation(); return true; }, 'Model.afterRules' ); $this->assertSame($entity, $table->save($entity)); } /** * Tests that rules can be changed using the buildRules event * * @group save * @return void */ public function testUseBuildRulesEvent() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $table->eventManager()->attach(function ($event, $rules) { $rules->add($rules->existsIn('author_id', TableRegistry::get('Authors'), 'Nope')); }, 'Model.buildRules'); $this->assertFalse($table->save($entity)); } /** * Tests isUnique with untouched fields * * @group save * @return void */ public function testIsUniqueWithCleanFields() { $table = TableRegistry::get('Articles'); $entity = $table->get(1); $rules = $table->rulesChecker(); $rules->add($rules->isUnique(['title', 'author_id'], 'Nope')); $entity->body = 'Foo'; $this->assertSame($entity, $table->save($entity)); $entity->title = 'Third Article'; $this->assertFalse($table->save($entity)); } /** * Tests isUnique rule with coflicting columns * * @group save * @return void */ public function testIsUniqueAliasPrefix() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 1 ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->isUnique(['author_id'])); $table->Authors->eventManager()->on('Model.beforeFind', function ($event, $query) { $query->leftJoin(['a2' => 'authors']); }); $this->assertFalse($table->save($entity)); $this->assertEquals(['_isUnique' => 'This value is already in use'], $entity->errors('author_id')); } /** * Tests the existsIn rule when passing non dirty fields * * @group save * @return void */ public function testExistsInWithCleanFields() { $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', 'Authors')); $entity = $table->get(1); $entity->title = 'Foo'; $entity->author_id = 1000; $entity->dirty('author_id', false); $this->assertSame($entity, $table->save($entity)); } /** * Tests the existsIn with coflicting columns * * @group save * @return void */ public function testExistsInAliasPrefix() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn('author_id', 'Authors')); $table->Authors->eventManager()->on('Model.beforeFind', function ($event, $query) { $query->leftJoin(['a2' => 'authors']); }); $this->assertFalse($table->save($entity)); $this->assertEquals(['_existsIn' => 'This value does not exist'], $entity->errors('author_id')); } /** * Tests that using an array in existsIn() sets the error message correctly * * @return */ public function testExistsInErrorWithArrayField() { $entity = new Entity([ 'title' => 'An Article', 'author_id' => 500 ]); $table = TableRegistry::get('Articles'); $table->belongsTo('Authors'); $rules = $table->rulesChecker(); $rules->add($rules->existsIn(['author_id'], 'Authors')); $this->assertFalse($table->save($entity)); $this->assertEquals(['_existsIn' => 'This value does not exist'], $entity->errors('author_id')); } /** * Tests using rules to prevent delete operations * * @group delete * @return void */ public function testDeleteRules() { $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->addDelete(function ($entity) { return false; }); $entity = $table->get(1); $this->assertFalse($table->delete($entity)); } /** * Checks that it is possible to pass custom options to rules when saving * * @group save * @return void */ public function testCustomOptionsPassingSave() { $entity = new Entity([ 'name' => 'jose' ]); $table = TableRegistry::get('Authors'); $rules = $table->rulesChecker(); $rules->add(function ($entity, $options) { $this->assertEquals('bar', $options['foo']); $this->assertEquals('option', $options['another']); return false; }, ['another' => 'option']); $this->assertFalse($table->save($entity, ['foo' => 'bar'])); } /** * Tests passing custom options to rules from delete * * @group delete * @return void */ public function testCustomOptionsPassingDelete() { $table = TableRegistry::get('Articles'); $rules = $table->rulesChecker(); $rules->addDelete(function ($entity, $options) { $this->assertEquals('bar', $options['foo']); $this->assertEquals('option', $options['another']); return false; }, ['another' => 'option']); $entity = $table->get(1); $this->assertFalse($table->delete($entity, ['foo' => 'bar'])); } /** * Test adding rules that return error string * * @group save * @return void */ public function testCustomErrorMessageFromRule() { $entity = new Entity([ 'name' => 'larry' ]); $table = TableRegistry::get('Authors'); $rules = $table->rulesChecker(); $rules->add(function () { return 'So much nope'; }, ['errorField' => 'name']); $this->assertFalse($table->save($entity)); $this->assertEquals(['So much nope'], $entity->errors('name')); } /** * Test adding rules with no errorField do not accept strings * * @group save * @return void */ public function testCustomErrorMessageFromRuleNoErrorField() { $entity = new Entity([ 'name' => 'larry' ]); $table = TableRegistry::get('Authors'); $rules = $table->rulesChecker(); $rules->add(function () { return 'So much nope'; }); $this->assertFalse($table->save($entity)); $this->assertEmpty($entity->errors()); } /** * Tests that using existsIn for a hasMany association will not be called * as the foreign key for the association was automatically validated already. * * @group save * @return void */ public function testAvoidExistsInOnAutomaticSaving() { $entity = new \Cake\ORM\Entity([ 'name' => 'Jose' ]); $entity->articles = [ new \Cake\ORM\Entity([ 'title' => '1', 'body' => 'A body' ]), new \Cake\ORM\Entity([ 'title' => 'Another Title', 'body' => 'Another body' ]) ]; $table = TableRegistry::get('authors'); $table->hasMany('articles'); $table->association('articles')->belongsTo('authors'); $checker = $table->association('articles')->target()->rulesChecker(); $checker->add(function ($entity, $options) use ($checker) { $rule = $checker->existsIn('author_id', 'authors'); $id = $entity->author_id; $entity->author_id = 5000; $result = $rule($entity, $options); $this->assertTrue($result); $entity->author_id = $id; return true; }); $this->assertSame($entity, $table->save($entity)); } }