Database object collections

[BurntimeX]

The idea behind database object collections is to lazy-load additional data when it is needed, abandoning the concept of the "viewable" decorators for database objects.

Example:

class FoobarCollection extends DatabaseObjectCollection
{
    /**
     * @var Label[][]
     */
    private array $labels;

    /**
     * @return Label[]
     */
    public function getLabels(Foobar $object): array
    {
        $this->loadLabels();

        return $this->labels[$object->getObjectID()] ?? [];
    }

    private function loadLabels(): void
    {
        if (isset($this->labels)) {
            return;
        }

        $this->labels = LabelObjectHandler::getInstance()->getAssignedLabels(
            \array_map(
                static fn($object) => $object->getObjectID(),
                \array_filter($this->objects, static fn($object) => $object->hasLabels)
            )
        );
    }
}

class Foobar extends CollectionDatabaseObject {
    /**
     * @return Label[]
     */
    public function getLabels(): array
    {
        return $this->getCollection()->getLabels($this);
    }
}