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 = '';
    protected bool $confidential = false;
 
    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;
 
    public function isConfidential(): bool
    {
        return $this->confidential;
    }
 
    public function setConfidential(bool $confidential): void
    {
        $this->confidential = $confidential;
    }
}