write(); $money = new DBMoney(); $money->setAmount(100); $money->setCurrency('USD'); // the actual test is that this does not generate an error in the sql. $obj->Clients()->add( $obj, [ 'Worth' => $money, 'Reference' => 'Foo' ] ); $check = $obj->Clients()->First(); $this->assertEquals('Foo', $check->Reference, 'Basic scalar fields should exist'); $this->assertInstanceOf(DBMoney::class, $check->Worth, 'Composite fields should exist on the record'); $this->assertEquals(100, $check->Worth->getAmount()); } /** * This test targets a bug where appending many_many_extraFields to a query would * result in erroneous queries for sort orders that rely on _SortColumn0 */ public function testAddCompositedExtraFieldsWithSortColumn0() { $obj = new ExtraFieldsObject(); $obj->write(); $product = new Product(); $product->Title = 'Test Product'; $product->write(); // the actual test is that this does not generate an error in the sql. $obj->Products()->add($product, [ 'Reference' => 'Foo', ]); $result = $obj->Products()->First(); $this->assertEquals('Foo', $result->Reference, 'Basic scalar fields should exist'); $this->assertEquals('Test Product', $result->Title); } public function testGetExtraFields() { $team1 = $this->objFromFixture(Team::class, 'team1'); $expected = DataObject::getSchema()->manyManyExtraFieldsForComponent(Team::class, 'Players'); $this->assertSame($expected, $team1->Players()->getExtraFields()); } public function testGetExtraData() { // Get fixtures $player1 = new Player(); $player1->write(); $player2 = new Player(); $player2->write(); $team1 = $this->objFromFixture(Team::class, 'team1'); // Validate extra data $team1->Players()->add($player1, ['Position' => 'Captain']); $this->assertEquals(['Position' => 'Captain'], $team1->Players()->getExtraData('Teams', $player1->ID)); // Validate no extra data $team1->Players()->add($player2); $this->assertEquals(['Position' => null], $team1->Players()->getExtraData('Teams', $player2->ID)); // Validate no record $this->assertEquals([], $team1->Players()->getExtraData('Teams', 99999)); } public function testGetExtraDataBadID() { $team1 = $this->objFromFixture(Team::class, 'team1'); $this->expectException(InvalidArgumentException::class); $this->expectExceptionMessage('ManyManyList::getExtraData() passed a non-numeric child ID'); $team1->Players()->getExtraData('Teams', 'abc'); } public function testSetExtraData() { $obj = new ManyManyListTest\ExtraFieldsObject(); $obj->write(); $obj2 = new ManyManyListTest\ExtraFieldsObject(); $obj2->write(); $money = new DBMoney(); $money->setAmount(100); $money->setCurrency('USD'); // Set some data on add $obj->Clients()->add($obj2, [ 'Worth' => $money, 'Reference' => 'Foo', ]); // Change the data afterward $money->setAmount(50); $obj->Clients()->setExtraData($obj2->ID, [ 'Worth' => $money, 'Reference' => 'Bar', ]); $result = $obj->Clients()->First(); $this->assertEquals('Bar', $result->Reference, 'Basic scalar fields should exist'); $this->assertInstanceOf(DBMoney::class, $result->Worth, 'Composite fields should exist on the record'); $this->assertEquals(50, $result->Worth->getAmount()); } public function testCreateList() { $list = ManyManyList::create( Team::class, 'DataObjectTest_Team_Players', 'DataObjectTest_TeamID', 'DataObjectTest_PlayerID' ); $this->assertEquals(2, $list->count()); } public function testRelationshipEmptyOnNewRecords() { // Relies on the fact that (unrelated) teams exist in the fixture file already $newPlayer = new Player(); // many_many Teams $this->assertEquals([], $newPlayer->Teams()->column('ID')); } public function testAddingSingleDataObjectByReference() { $player1 = $this->objFromFixture(Player::class, 'player1'); $team1 = $this->objFromFixture(Team::class, 'team1'); $player1->Teams()->add($team1); $player1->flushCache(); $compareTeams = new ManyManyList( Team::class, 'DataObjectTest_Team_Players', 'DataObjectTest_TeamID', 'DataObjectTest_PlayerID' ); $compareTeams = $compareTeams->forForeignID($player1->ID); $this->assertEquals( $player1->Teams()->column('ID'), $compareTeams->column('ID'), "Adding single record as DataObject to many_many" ); } public function testRemovingSingleDataObjectByReference() { $player1 = $this->objFromFixture(Player::class, 'player1'); $team1 = $this->objFromFixture(Team::class, 'team1'); $player1->Teams()->remove($team1); $player1->flushCache(); $compareTeams = new ManyManyList( Team::class, 'DataObjectTest_Team_Players', 'DataObjectTest_TeamID', 'DataObjectTest_PlayerID' ); $compareTeams = $compareTeams->forForeignID($player1->ID); $this->assertEquals( $player1->Teams()->column('ID'), $compareTeams->column('ID'), "Removing single record as DataObject from many_many" ); } public function testAddingSingleDataObjectByID() { $player1 = $this->objFromFixture(Player::class, 'player1'); $team1 = $this->objFromFixture(Team::class, 'team1'); $player1->Teams()->add($team1->ID); $player1->flushCache(); $compareTeams = new ManyManyList( Team::class, 'DataObjectTest_Team_Players', 'DataObjectTest_TeamID', 'DataObjectTest_PlayerID' ); $compareTeams = $compareTeams->forForeignID($player1->ID); $this->assertEquals( $player1->Teams()->column('ID'), $compareTeams->column('ID'), "Adding single record as ID to many_many" ); } public function testRemoveByID() { $player1 = $this->objFromFixture(Player::class, 'player1'); $team1 = $this->objFromFixture(Team::class, 'team1'); $player1->Teams()->removeByID($team1->ID); $player1->flushCache(); $compareTeams = new ManyManyList( Team::class, 'DataObjectTest_Team_Players', 'DataObjectTest_TeamID', 'DataObjectTest_PlayerID' ); $compareTeams = $compareTeams->forForeignID($player1->ID); $this->assertEquals( $player1->Teams()->column('ID'), $compareTeams->column('ID'), "Removing single record as ID from many_many" ); } public function testSetByIdList() { $player1 = $this->objFromFixture(Player::class, 'player1'); $team1 = $this->objFromFixture(Team::class, 'team1'); $team2 = $this->objFromFixture(Team::class, 'team2'); $player1->Teams()->setByIdList([$team1->ID, $team2->ID]); $this->assertEquals([$team1->ID, $team2->ID], $player1->Teams()->sort('Title')->column()); $player1->Teams()->setByIdList([$team1->ID]); $this->assertEquals([$team1->ID], $player1->Teams()->sort('Title')->column()); $player1->Teams()->setByIdList([$team2->ID]); $this->assertEquals([$team2->ID], $player1->Teams()->sort('Title')->column()); } public function testAddingWithMultipleForeignKeys() { $newPlayer = new Player(); $newPlayer->write(); $team1 = $this->objFromFixture(Team::class, 'team1'); $team2 = $this->objFromFixture(Team::class, 'team2'); $playersTeam1Team2 = Team::get()->relation('Players') ->forForeignID([$team1->ID, $team2->ID]); $playersTeam1Team2->add($newPlayer); $this->assertEquals( [$team1->ID, $team2->ID], $newPlayer->Teams()->sort('Title')->column('ID') ); } public function testAddingExistingDoesntRemoveExtraFields() { $player = new Player(); $player->write(); $team1 = $this->objFromFixture(Team::class, 'team1'); $team1->Players()->add($player, ['Position' => 'Captain']); $this->assertEquals( ['Position' => 'Captain'], $team1->Players()->getExtraData('Teams', $player->ID), 'Writes extrafields' ); $team1->Players()->add($player); $this->assertEquals( ['Position' => 'Captain'], $team1->Players()->getExtraData('Teams', $player->ID), 'Retains extrafields on subsequent adds with NULL fields' ); $team1->Players()->add($player, ['Position' => 'Defense']); $this->assertEquals( ['Position' => 'Defense'], $team1->Players()->getExtraData('Teams', $player->ID), 'Updates extrafields on subsequent adds with fields' ); $team1->Players()->add($player, ['Position' => null]); $this->assertEquals( ['Position' => null], $team1->Players()->getExtraData('Teams', $player->ID), 'Allows clearing of extrafields on subsequent adds' ); } public function testSubtractOnAManyManyList() { $allList = ManyManyList::create( Player::class, 'DataObjectTest_Team_Players', 'DataObjectTest_PlayerID', 'DataObjectTest_TeamID' ); $this->assertEquals( 3, $allList->count(), 'Precondition; we have all 3 players connected to a team in the list' ); $teamOneID = $this->idFromFixture(Team::class, 'team1'); $teamTwoID = $this->idFromFixture(Team::class, 'team2'); // Captain 1 belongs to one team; team1 $captain1 = $this->objFromFixture(Player::class, 'captain1'); $this->assertEquals( [$teamOneID], $captain1->Teams()->column("ID"), 'Precondition; player2 belongs to team1' ); // Player 2 belongs to both teams: team1, team2 $player2 = $this->objFromFixture(Player::class, 'player2'); $this->assertEquals( [$teamOneID,$teamTwoID], $player2->Teams()->sort('Title')->column('ID'), 'Precondition; player2 belongs to team1 and team2' ); // We want to find the teams for player2 where the captain does not belong to $teamsWithoutTheCaptain = $player2->Teams()->subtract($captain1->Teams()); // Assertions $this->assertEquals( 1, $teamsWithoutTheCaptain->count(), 'The ManyManyList should onlu contain one team' ); $this->assertEquals( $teamTwoID, $teamsWithoutTheCaptain->first()->ID, 'The ManyManyList contains the wrong team' ); } public function testRemoveAll() { $first = new Team(); $first->write(); $second = new Team(); $second->write(); $firstPlayers = $first->Players(); $secondPlayers = $second->Players(); $a = new Player(); $a->ShirtNumber = 'a'; $a->write(); $b = new Player(); $b->ShirtNumber = 'b'; $b->write(); $firstPlayers->add($a); $firstPlayers->add($b); $secondPlayers->add($a); $secondPlayers->add($b); $this->assertEquals(['a', 'b'], $firstPlayers->sort('ShirtNumber')->column('ShirtNumber')); $this->assertEquals(['a', 'b'], $secondPlayers->sort('ShirtNumber')->column('ShirtNumber')); $firstPlayers->removeAll(); $this->assertEquals(0, count($firstPlayers ?? [])); $this->assertEquals(2, count($secondPlayers ?? [])); $firstPlayers->removeAll(); $firstPlayers->add($a); $firstPlayers->add($b); $this->assertEquals(['a', 'b'], $firstPlayers->sort('ShirtNumber')->column('ShirtNumber')); $firstPlayers->filter('ShirtNumber', 'b')->removeAll(); $this->assertEquals(['a'], $firstPlayers->column('ShirtNumber')); $this->assertEquals(['a', 'b'], $secondPlayers->sort('ShirtNumber')->column('ShirtNumber')); $this->assertNotNull(Player::get()->byID($a->ID)); $this->assertNotNull(Player::get()->byID($b->ID)); } public function testAppendExtraFieldsToQuery() { $list = new ManyManyList( ManyManyListTest\ExtraFieldsObject::class, 'ManyManyListTest_ExtraFields_Clients', 'ManyManyListTest_ExtraFieldsID', 'ChildID', [ 'Worth' => 'Money', 'Reference' => 'Varchar' ] ); // ensure that ManyManyListTest_ExtraFields_Clients.ValueCurrency is // selected. $expected = 'SELECT DISTINCT "ManyManyListTest_ExtraFields_Clients"."WorthCurrency",' . ' "ManyManyListTest_ExtraFields_Clients"."WorthAmount", "ManyManyListTest_ExtraFields_Clients"."Reference",' . ' "ManyManyListTest_ExtraFields"."ClassName", "ManyManyListTest_ExtraFields"."LastEdited",' . ' "ManyManyListTest_ExtraFields"."Created", "ManyManyListTest_ExtraFields"."ID",' . ' CASE WHEN "ManyManyListTest_ExtraFields"."ClassName" IS NOT NULL THEN' . ' "ManyManyListTest_ExtraFields"."ClassName" ELSE ' . Convert::raw2sql(ManyManyListTest\ExtraFieldsObject::class, true) . ' END AS "RecordClassName" FROM "ManyManyListTest_ExtraFields" INNER JOIN' . ' "ManyManyListTest_ExtraFields_Clients" ON' . ' "ManyManyListTest_ExtraFields_Clients"."ManyManyListTest_ExtraFieldsID" =' . ' "ManyManyListTest_ExtraFields"."ID"'; $this->assertSQLEquals($expected, $list->sql($parameters)); } /** * This tests that we can set a default sort on a join table, even though the class doesn't exist. * * @return void */ public function testSortByExtraFieldsDefaultSort() { $obj = new ManyManyListTest\ExtraFieldsObject(); $obj->write(); $obj2 = new ManyManyListTest\ExtraFieldsObject(); $obj2->write(); $money = new DBMoney(); $money->setAmount(100); $money->setCurrency('USD'); // Add two objects as relations (first is linking back to itself) $obj->Clients()->add($obj, ['Worth' => $money, 'Reference' => 'A']); $obj->Clients()->add($obj2, ['Worth' => $money, 'Reference' => 'B']); // Set the default sort for this relation Config::inst()->set('ManyManyListTest_ExtraFields_Clients', 'default_sort', 'Reference ASC'); $clients = $obj->Clients(); $this->assertCount(2, $clients); list($first, $second) = $obj->Clients(); $this->assertEquals('A', $first->Reference); $this->assertEquals('B', $second->Reference); // Now we ensure the default sort is being respected by reversing its order Config::inst()->set('ManyManyListTest_ExtraFields_Clients', 'default_sort', 'Reference DESC'); $reverseClients = $obj->Clients(); $this->assertCount(2, $reverseClients); list($reverseFirst, $reverseSecond) = $obj->Clients(); $this->assertEquals('B', $reverseFirst->Reference); $this->assertEquals('A', $reverseSecond->Reference); } public function testFilteringOnPreviouslyJoinedTable() { /** @var ManyManyListTest\Category $category */ $category = $this->objFromFixture(ManyManyListTest\Category::class, 'categorya'); /** @var ManyManyList $productsRelatedToProductB */ $productsRelatedToProductB = $category->Products()->filter('RelatedProducts.Title', 'Product A'); $this->assertEquals(1, $productsRelatedToProductB->count()); } public function testWriteManipulationWithNonScalarValuesAllowed() { $left = DataObjectTest\MockDynamicAssignmentDataObject::create(); $left->write(); $right = DataObjectTest\MockDynamicAssignmentDataObject::create(); $right->write(); $left->MockManyMany()->add($right, [ 'ManyManyStaticScalarOnlyField' => true, 'ManyManyDynamicScalarOnlyField' => false, 'ManyManyDynamicField' => true, ]); $pivot = $left->MockManyMany()->first(); $this->assertNotFalse($pivot->ManyManyStaticScalarOnlyField); $this->assertNotTrue($pivot->ManyManyDynamicScalarOnlyField); $this->assertNotFalse($pivot->ManyManyDynamicField); } public function testWriteManipulationWithNonScalarValuesDisallowed() { $this->expectException(\InvalidArgumentException::class); $left = DataObjectTest\MockDynamicAssignmentDataObject::create(); $left->write(); $right = DataObjectTest\MockDynamicAssignmentDataObject::create(); $right->write(); $left->MockManyMany()->add($right, [ 'ManyManyStaticScalarOnlyField' => false, 'ManyManyDynamicScalarOnlyField' => true, 'ManyManyDynamicField' => false, ]); } public function testCallbackOnSetById() { $addedIds = []; $removedIds = []; $base = $this->objFromFixture(Team::class, 'team1'); $relation = $base->Players(); $remove = $relation->First(); $add = new Player(); $add->write(); $relation->addCallbacks()->add(function ($list, $item, $extraFields) use (&$removedIds) { $addedIds[] = $item; }); $relation->removeCallbacks()->add(function ($list, $ids) use (&$removedIds) { $removedIds = $ids; }); $relation->setByIDList(array_merge( $base->Players()->exclude('ID', $remove->ID)->column('ID'), [$add->ID] )); $this->assertEquals([$remove->ID], $removedIds); } public function testAddCallbackWithExtraFields() { $added = []; $base = $this->objFromFixture(Team::class, 'team1'); $relation = $base->Players(); $add = new Player(); $add->write(); $relation->addCallbacks()->add(function ($list, $item, $extraFields) use (&$added) { $added[] = [$item, $extraFields]; }); $relation->add($add, ['Position' => 'Quarterback']); $this->assertEquals([[$add, ['Position' => 'Quarterback']]], $added); } public function testRemoveCallbackOnRemove() { $removedIds = []; $base = $this->objFromFixture(Team::class, 'team1'); $relation = $base->Players(); $remove = $relation->First(); $relation->removeCallbacks()->add(function ($list, $ids) use (&$removedIds) { $removedIds = $ids; }); $relation->remove($remove); $this->assertEquals([$remove->ID], $removedIds); } public function testRemoveCallbackOnRemoveById() { $removedIds = []; $base = $this->objFromFixture(Team::class, 'team1'); $relation = $base->Players(); $remove = $relation->First(); $relation->removeCallbacks()->add(function ($list, $ids) use (&$removedIds) { $removedIds = $ids; }); $relation->removeByID($remove->ID); $this->assertEquals([$remove->ID], $removedIds); } public function testRemoveCallbackOnRemoveAll() { $removedIds = []; $base = $this->objFromFixture(Team::class, 'team1'); $relation = $base->Players(); $remove = $relation->column('ID'); $relation->removeCallbacks()->add(function ($list, $ids) use (&$removedIds) { $removedIds = $ids; }); $relation->removeAll(); $this->assertEquals(sort($remove), sort($removedIds)); } /** * @dataProvider provideForForeignIDPlaceholders */ public function testForForeignIDPlaceholders(bool $config, bool $useInt, bool $expected): void { Config::modify()->set(DataList::class, 'use_placeholders_for_integer_ids', $config); $team1 = $this->objFromFixture(Team::class, 'team1'); $team2 = $this->objFromFixture(Team::class, 'team2'); $players1 = $team1->Players(); $players2 = $team2->Players(); $ids = $useInt ? [$team1->ID, $team2->ID] : ['Lorem', 'Ipsum']; $newPlayersList = $players1->forForeignID($ids); $sql = $newPlayersList->dataQuery()->sql(); preg_match('#ID" IN \(([^\)]+)\)\)#', $sql, $matches); $usesPlaceholders = $matches[1] === '?, ?'; $this->assertSame($expected, $usesPlaceholders); $expectedIDs = $useInt ? array_values(array_merge($players1->column('ID'), $players2->column('ID'))) : []; $this->assertEqualsCanonicalizing($expectedIDs, $newPlayersList->column('ID')); } public function provideForForeignIDPlaceholders(): array { return [ 'config false' => [ 'config' => false, 'useInt' => true, 'expected' => false, ], 'config false non-int' => [ 'config' => false, 'useInt' => false, 'expected' => true, ], 'config true' => [ 'config' => true, 'useInt' => true, 'expected' => true, ], 'config true non-int' => [ 'config' => true, 'useInt' => false, 'expected' => true, ], ]; } }