silverstripe-framework/tests/php/ORM/ManyManyListTest.php
2024-09-18 13:53:44 +12:00

667 lines
23 KiB
PHP

<?php
namespace SilverStripe\ORM\Tests;
use InvalidArgumentException;
use SilverStripe\Core\Config\Config;
use SilverStripe\ORM\FieldType\DBMoney;
use SilverStripe\ORM\ManyManyList;
use SilverStripe\Core\Convert;
use SilverStripe\Dev\SapphireTest;
use SilverStripe\ORM\DataObject;
use SilverStripe\ORM\Tests\DataObjectTest\Player;
use SilverStripe\ORM\Tests\DataObjectTest\Team;
use SilverStripe\ORM\Tests\ManyManyListTest\ExtraFieldsObject;
use SilverStripe\ORM\Tests\ManyManyListTest\Product;
use SilverStripe\ORM\DataList;
use PHPUnit\Framework\Attributes\DataProvider;
class ManyManyListTest extends SapphireTest
{
protected static $fixture_file = 'DataObjectTest.yml';
public static $extra_data_objects = [
ManyManyListTest\Category::class,
ManyManyListTest\ExtraFieldsObject::class,
ManyManyListTest\Product::class,
DataObjectTest\MockDynamicAssignmentDataObject::class
];
public static function getExtraDataObjects()
{
return array_merge(
DataObjectTest::$extra_data_objects,
ManyManyListTest::$extra_data_objects
);
}
public function testAddCompositedExtraFields()
{
$obj = new ManyManyListTest\ExtraFieldsObject();
$obj->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 static 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,
],
];
}
}