AbstractStorableResource.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\ResourceStorage\Resource;

use ILIAS\ResourceStorage\Identification\ResourceIdentification;
use ILIAS\ResourceStorage\Revision\Revision;
use ILIAS\ResourceStorage\Revision\RevisionCollection;
use ILIAS\ResourceStorage\Stakeholder\ResourceStakeholder;

abstract class AbstractStorableResource implements StorableResource
{
    protected RevisionCollection $revisions;
    protected array $stakeholders = [];
    protected string $storage_id = '';

    public function __construct(protected ResourceIdentification $identification)
    {
        $this->revisions = new RevisionCollection($this->identification);
    }

    public function getIdentification(): ResourceIdentification
    {
        return $this->identification;
    }

    public function getCurrentRevision(): Revision
    {
        return $this->revisions->getCurrent(false);
    }

    public function getCurrentRevisionIncludingDraft(): Revision
    {
        return $this->revisions->getCurrent(true);
    }

    public function getSpecificRevision(int $number): ?Revision
    {
        foreach ($this->getAllRevisionsIncludingDraft() as $revision) {
            if ($revision->getVersionNumber() === $number) {
                return $revision;
            }
        }
        return null;
    }

    public function hasSpecificRevision(int $number): bool
    {
        foreach ($this->getAllRevisionsIncludingDraft() as $revision) {
            if ($revision->getVersionNumber() === $number) {
                return true;
            }
        }
        return false;
    }

    public function getAllRevisions(): array
    {
        return $this->revisions->getAll(false);
    }

    public function getAllRevisionsIncludingDraft(): array
    {
        return $this->revisions->getAll(true);
    }

    public function addRevision(Revision $revision): void
    {
        $this->revisions->add($revision);
    }

    public function removeRevision(Revision $revision): void
    {
        $this->revisions->remove($revision);
    }

    public function replaceRevision(Revision $revision): void
    {
        $this->revisions->replaceSingleRevision($revision);
    }

    public function setRevisions(RevisionCollection $collection): void
    {
        $this->revisions = $collection;
    }

    public function getStakeholders(): array
    {
        return $this->stakeholders;
    }

    public function addStakeholder(ResourceStakeholder $s): void
    {
        $this->stakeholders[] = $s;
    }

    public function removeStakeholder(ResourceStakeholder $s): void
    {
        foreach ($this->stakeholders as $k => $stakeholder) {
            if ($stakeholder->getId() === $s->getId()) {
                unset($this->stakeholders[$k]);
            }
        }
    }

    public function setStakeholders(array $stakeholders): self
    {
        $this->stakeholders = $stakeholders;

        return $this;
    }

    public function getStorageId(): string
    {
        return $this->storage_id;
    }

    public function setStorageId(string $storage_id): void
    {
        $this->storage_id = $storage_id;
    }

    public function getMaxRevision(bool $including_drafts = false): int
    {
        return $this->revisions->getMax($including_drafts);
    }

    public function getFullSize(): int
    {
        return $this->revisions->getFullSize();
    }

    abstract public function getType(): ResourceType;
}