Inheritance diagram for TYPO3\CMS\Core\Collection\AbstractRecordCollection:

Public Member Functions
	__construct ()

T null	current ()

	next ()

int string	key ()

bool	valid ()

	rewind ()

	__serialize ()

	__unserialize (array $arrayRepresentation)

int	count ()

string	getTitle ()

int	getUid ()

string	getDescription ()

	setTitle ($title)

	setDescription ($desc)

string	getItemTableName ()

	setItemTableName ($tableName)

	usort ($callbackFunction)

	moveItemAt ($currentPosition, $newPosition=0)

int	getIdentifier ()

	setIdentifier ($id)

	persist ()

array	toArray ()

	fromArray (array $array)

‪Public Member Functions inherited from ‪TYPO3\CMS\Core\Collection\PersistableCollectionInterface
	loadContents ()

Static Public Member Functions
static CollectionInterface	load ($id, $fillItems=false)

static CollectionInterface	create (array $collectionRecord, $fillItems=false)

Protected Member Functions
array	getPersistableDataArray ()

string	getItemUidList ($includeTableName=true)

Static Protected Member Functions
static	getCollectionDatabaseTable ()

Protected Attributes
int	$uid = 0

string	$title

string	$description

string	$itemTableName

SplDoublyLinkedList	$storage

Static Protected Attributes
static string	$storageItemsField = 'items'

static string	$storageTableName = ''

Detailed Description

Abstract implementation of a RecordCollection

RecordCollection is a collections of TCA-Records. The collection is meant to be stored in TCA-table sys_file_collections and is manageable via FormEngine.

A RecordCollection might be used to group a set of records (e.g. news, images, contentElements) for output in frontend

The AbstractRecordCollection uses SplDoublyLinkedList for internal storage

@template T <T>

Definition at line 39 of file AbstractRecordCollection.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::__construct ( )

Creates this object.

Definition at line 86 of file AbstractRecordCollection.php.

Member Function Documentation

◆ __serialize()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::__serialize ( )

Returns class state to be serialized.

Definition at line 141 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\getIdentifier().

◆ __unserialize()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::__unserialize ( array $arrayRepresentation )

Load records with the given serialized information

Definition at line 151 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\load().

◆ count()

int TYPO3\CMS\Core\Collection\AbstractRecordCollection::count ( )

Count elements of an object

Returns: ‪int The custom count as an integer.

Definition at line 161 of file AbstractRecordCollection.php.

◆ create()

static CollectionInterface TYPO3\CMS\Core\Collection\AbstractRecordCollection::create	(	array	$collectionRecord,
			$fillItems = `false`
	)

static

Creates a new collection objects and reconstitutes the given database record to the new object.

Parameters

array	$collectionRecord	‪Database record
bool	$fillItems	‪Populates the entries directly on load, might be bad for memory on large collections

Returns: ‪CollectionInterface

Reimplemented in TYPO3\CMS\Core\Category\Collection\CategoryCollection, and TYPO3\CMS\Frontend\Category\Collection\CategoryCollection.

Definition at line 317 of file AbstractRecordCollection.php.

Referenced by TYPO3\CMS\Core\Collection\AbstractRecordCollection\load().

◆ current()

T null TYPO3\CMS\Core\Collection\AbstractRecordCollection::current ( )

Return the current element

Returns: ‪T|null

Definition at line 96 of file AbstractRecordCollection.php.

◆ fromArray()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::fromArray ( array $array )

Loads the properties of this collection from an array

Reimplemented in TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection, and TYPO3\CMS\Core\Resource\Collection\FolderBasedFileCollection.

Definition at line 400 of file AbstractRecordCollection.php.

References TYPO3\CMS\Redirects\Message\description.

◆ getCollectionDatabaseTable()

static TYPO3\CMS\Core\Collection\AbstractRecordCollection::getCollectionDatabaseTable ( )

staticprotected

Definition at line 408 of file AbstractRecordCollection.php.

◆ getDescription()

string TYPO3\CMS\Core\Collection\AbstractRecordCollection::getDescription ( )

Getter for the description

Returns: ‪string

Implements TYPO3\CMS\Core\Collection\NameableCollectionInterface.

Definition at line 191 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$description.

Referenced by TYPO3\CMS\Core\Resource\Collection\FolderBasedFileCollection\getPersistableDataArray(), TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection\getPersistableDataArray(), TYPO3\CMS\Core\Category\Collection\CategoryCollection\getPersistableDataArray(), TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection\toArray(), and TYPO3\CMS\Core\Collection\AbstractRecordCollection\toArray().

◆ getIdentifier()

int TYPO3\CMS\Core\Collection\AbstractRecordCollection::getIdentifier ( )

Returns the uid of the collection

Returns: ‪int

Implements TYPO3\CMS\Core\Collection\PersistableCollectionInterface.

Definition at line 271 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$uid.

Referenced by TYPO3\CMS\Core\Collection\AbstractRecordCollection\__serialize(), TYPO3\CMS\Core\Resource\Collection\StaticFileCollection\loadContents(), TYPO3\CMS\Core\Collection\AbstractRecordCollection\persist(), TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection\toArray(), and TYPO3\CMS\Core\Collection\AbstractRecordCollection\toArray().

◆ getItemTableName()

string TYPO3\CMS\Core\Collection\AbstractRecordCollection::getItemTableName ( )

Setter for the name of the data-source table

Returns: ‪string

Implements TYPO3\CMS\Core\Collection\RecordCollectionInterface.

Definition at line 221 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$itemTableName.

Referenced by TYPO3\CMS\Frontend\Category\Collection\CategoryCollection\getCollectedRecords(), TYPO3\CMS\Core\Category\Collection\CategoryCollection\getCollectedRecordsQueryBuilder(), TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection\getItemUidList(), TYPO3\CMS\Core\Collection\AbstractRecordCollection\getItemUidList(), and TYPO3\CMS\Core\Collection\AbstractRecordCollection\toArray().

◆ getItemUidList()

string TYPO3\CMS\Core\Collection\AbstractRecordCollection::getItemUidList ( $includeTableName = true )

protected

Generates comma-separated list of entry uids for usage in DataHandler

also allow to add table name, if it might be needed by DataHandler for storing the relation

Parameters

bool $includeTableName

Returns: ‪string

Reimplemented in TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection.

Definition at line 368 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\getItemTableName().

Referenced by TYPO3\CMS\Core\Category\Collection\CategoryCollection\getPersistableDataArray().

◆ getPersistableDataArray()

array TYPO3\CMS\Core\Collection\AbstractRecordCollection::getPersistableDataArray ( )

abstractprotected

Returns an array of the persistable properties and contents which are processable by DataHandler.

For internal usage in persist only.

Returns: ‪array

Reimplemented in TYPO3\CMS\Core\Category\Collection\CategoryCollection, TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection, and TYPO3\CMS\Core\Resource\Collection\FolderBasedFileCollection.

Referenced by TYPO3\CMS\Core\Collection\AbstractRecordCollection\persist().

◆ getTitle()

string TYPO3\CMS\Core\Collection\AbstractRecordCollection::getTitle ( )

Getter for the title

Returns: ‪string

Implements TYPO3\CMS\Core\Collection\NameableCollectionInterface.

Definition at line 171 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$title.

Referenced by TYPO3\CMS\Core\Resource\Collection\FolderBasedFileCollection\getPersistableDataArray(), TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection\getPersistableDataArray(), TYPO3\CMS\Core\Category\Collection\CategoryCollection\getPersistableDataArray(), TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection\toArray(), and TYPO3\CMS\Core\Collection\AbstractRecordCollection\toArray().

◆ getUid()

int TYPO3\CMS\Core\Collection\AbstractRecordCollection::getUid ( )

Getter for the UID

Returns: ‪int

Definition at line 181 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$uid.

◆ key()

int string TYPO3\CMS\Core\Collection\AbstractRecordCollection::key ( )

Return the key of the current element

Returns: ‪int|string 0 on failure.

Reimplemented in TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection.

Definition at line 114 of file AbstractRecordCollection.php.

◆ load()

static CollectionInterface TYPO3\CMS\Core\Collection\AbstractRecordCollection::load	(	$id,
		$fillItems = `false`
	)

static

Loads the collections with the given id from persistence

For memory reasons, per default only f.e. title, database-table, identifier (what ever static data is defined) is loaded. Entries can be load on first access.

Parameters

int	$id	‪Id of database record to be loaded
bool	$fillItems	‪Populates the entries directly on load, might be bad for memory on large collections

Returns: ‪CollectionInterface

Implements TYPO3\CMS\Core\Collection\PersistableCollectionInterface.

Definition at line 297 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\create(), and TYPO3\CMS\Core\Database\Connection\PARAM_INT.

Referenced by TYPO3\CMS\Core\Collection\AbstractRecordCollection\__unserialize().

◆ moveItemAt()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::moveItemAt	(	$currentPosition,
		$newPosition = `0`
	)

Moves the item within the collection

the item at $currentPosition will be moved to $newPosition. Omitting $newPosition will move to top.

Parameters

int	$currentPosition
int	$newPosition

Implements TYPO3\CMS\Core\Collection\SortableCollectionInterface.

Definition at line 260 of file AbstractRecordCollection.php.

◆ next()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::next ( )

Move forward to next element

Definition at line 104 of file AbstractRecordCollection.php.

◆ persist()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::persist ( )

Persists current collection state to underlying storage

Implements TYPO3\CMS\Core\Collection\PersistableCollectionInterface.

Definition at line 332 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$uid, TYPO3\CMS\Core\Collection\AbstractRecordCollection\getIdentifier(), and TYPO3\CMS\Core\Collection\AbstractRecordCollection\getPersistableDataArray().

◆ rewind()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::rewind ( )

Rewind the Iterator to the first element

Definition at line 133 of file AbstractRecordCollection.php.

◆ setDescription()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::setDescription ( $desc )

Setter for the description

Parameters

string $desc

Implements TYPO3\CMS\Core\Collection\NameableCollectionInterface.

Reimplemented in TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection.

Definition at line 211 of file AbstractRecordCollection.php.

References TYPO3\CMS\Redirects\Message\description.

◆ setIdentifier()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::setIdentifier ( $id )

Sets the identifier of the collection

Parameters

int $id

Implements TYPO3\CMS\Core\Collection\PersistableCollectionInterface.

Definition at line 281 of file AbstractRecordCollection.php.

◆ setItemTableName()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::setItemTableName ( $tableName )

Setter for the name of the data-source table

Parameters

string $tableName

Implements TYPO3\CMS\Core\Collection\RecordCollectionInterface.

Definition at line 231 of file AbstractRecordCollection.php.

Referenced by TYPO3\CMS\Core\Category\Collection\CategoryCollection\__construct().

◆ setTitle()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::setTitle ( $title )

Setter for the title

Parameters

string $title

Implements TYPO3\CMS\Core\Collection\NameableCollectionInterface.

Definition at line 201 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\$title.

◆ toArray()

array TYPO3\CMS\Core\Collection\AbstractRecordCollection::toArray ( )

Builds an array representation of this collection

Returns: ‪array

Reimplemented in TYPO3\CMS\Core\Resource\Collection\AbstractFileCollection.

Definition at line 382 of file AbstractRecordCollection.php.

References TYPO3\CMS\Core\Collection\AbstractRecordCollection\getDescription(), TYPO3\CMS\Core\Collection\AbstractRecordCollection\getIdentifier(), TYPO3\CMS\Core\Collection\AbstractRecordCollection\getItemTableName(), and TYPO3\CMS\Core\Collection\AbstractRecordCollection\getTitle().

◆ usort()

TYPO3\CMS\Core\Collection\AbstractRecordCollection::usort ( $callbackFunction )

Sorts collection via given callBackFunction

The comparison function given as must return an integer less than, equal to, or greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the second.

Parameters

callable $callbackFunction