RevisionCollection.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\ResourceStorage\Revision;
 
use ILIAS\ResourceStorage\Identification\ResourceIdentification;
 
class RevisionCollection
{
    public function __construct(private ResourceIdentification $identification, private array $revisions = [])
    {
    }
 
    public function add(Revision $revision): void
    {
        if ($this->identification->serialize() !== $revision->getIdentification()->serialize()) {
            throw new NonMatchingIdentificationException(
                "Can't add Revision since it's not the same ResourceIdentification"
            );
        }
        foreach ($this->revisions as $r) {
            if ($r->getVersionNumber() === $revision->getVersionNumber()) {
                throw new RevisionExistsException(
                    sprintf(
                        "Can't add already existing version number: %s",
                        $revision->getVersionNumber()
                    )
                );
            }
        }
        $this->revisions[$revision->getVersionNumber()] = $revision;
        asort($this->revisions);
    }
 
    public function remove(Revision $revision): void
    {
        foreach ($this->revisions as $k => $revision_e) {
            if ($revision->getVersionNumber() === $revision_e->getVersionNumber()) {
                unset($this->revisions[$k]);
 
                return;
            }
        }
    }
 
    public function replaceSingleRevision(Revision $revision): void
    {
        foreach ($this->revisions as $k => $revision_e) {
            if ($revision_e->getVersionNumber() === $revision->getVersionNumber()) {
                $this->revisions[$k] = $revision;
            }
        }
    }
 
    public function replaceAllRevisions(Revision $revision): void
    {
        $this->revisions = [];
        $this->add($revision);
    }
 
    public function getCurrent(bool $including_drafts): Revision
    {
        $v = $this->revisions;
 
        if (!$including_drafts) {
            $v = array_filter($v, static fn(Revision $revision): bool => $revision->getStatus() === RevisionStatus::PUBLISHED);
        }
        usort($v, static fn(Revision $a, Revision $b): int => $a->getVersionNumber() <=> $b->getVersionNumber());
 
        $current = end($v);
        if (!$current instanceof Revision) {
            return new NullRevision($this->identification);
        }
 
        return $current;
    }
 
    public function getAll(bool $including_drafts): array
    {
        if ($including_drafts) {
            return $this->revisions;
        }
        return array_filter($this->revisions, static fn(Revision $revision): bool => $revision->getStatus() === RevisionStatus::PUBLISHED);
    }
 
    public function getMax(bool $including_drafts): int
    {
        if ($this->revisions === []) {
            return 0;
        }
        return $this->getCurrent($including_drafts)->getVersionNumber();
    }
 
    public function getFullSize(): int
    {
        $size = 0;
        foreach ($this->revisions as $revision) {
            $size += $revision->getInformation()->getSize();
        }
 
        return $size;
    }
}