sort('ID'); // We can iterate on the DataList $names = array(); foreach($list as $item) { $names[] = $item->Name; } $this->assertEquals(array('Joe', 'Bob', 'Phil'), $names); // If we don't want to iterate, we can extract a single column from the list with column() $this->assertEquals(array('Joe', 'Bob', 'Phil'), $list->column('Name')); // We can sort a list $list = $list->sort('Name'); $this->assertEquals(array('Bob', 'Joe', 'Phil'), $list->column('Name')); // We can also restrict the output to a range $this->assertEquals(array('Joe', 'Phil'), $list->getRange(1,2)->column('Name')); } function testFilter() { // coming soon! } function testWhere() { // We can use raw SQL queries with where. This is only recommended for advanced uses; // if you can, you should use filter(). $list = DataList::create('DataObjectTest_TeamComment'); // where() returns a new DataList, like all the other modifiers, so it can be chained. $list2 = $list->where('"Name" = \'Joe\''); $this->assertEquals(array('This is a team comment by Joe'), $list2->column('Comment')); // The where() clauses are chained together with AND $list3 = $list2->where('"Name" = \'Bob\''); $this->assertEquals(array(), $list3->column('Comment')); } /** * Test DataList->byID() */ function testByID() { // We can get a single item by ID. $id = $this->idFromFixture('DataObjectTest_Team','team2'); $team = DataList::create("DataObjectTest_Team")->byID($id); // byID() returns a DataObject, rather than a DataList $this->assertInstanceOf('DataObjectTest_Team', $team); $this->assertEquals('Team 2', $team->Title); } /** * Test DataList->removeByID() */ function testRemoveByID() { $list = DataList::create("DataObjectTest_Team"); $id = $this->idFromFixture('DataObjectTest_Team','team2'); $this->assertNotNull($list->byID($id)); $list->removeByID($id); $this->assertNull($list->byID($id)); } /** * Test DataList->canSortBy() */ function testCanSortBy() { // Basic check $team = DataList::create("DataObjectTest_Team"); $this->assertTrue($team->canSortBy("Title")); $this->assertFalse($team->canSortBy("SomethingElse")); // Subclasses $subteam = DataList::create("DataObjectTest_SubTeam"); $this->assertTrue($subteam->canSortBy("Title")); $this->assertTrue($subteam->canSortBy("SubclassDatabaseField")); } function testDataListArrayAccess() { $list = DataList::create("DataObjectTest_Team")->sort("Title"); // We can use array access to refer to single items in the DataList, as if it were an array $this->assertEquals("Subteam 1", $list[0]->Title); $this->assertEquals("Subteam 3", $list[2]->Title); $this->assertEquals("Team 2", $list[4]->Title); } }