class.ilObjFileImplementationStorage.php

Go to the documentation of this file.

<?php
 
use ILIAS\ResourceStorage\Resource\StorableResource;
use ILIAS\ResourceStorage\Services;
use ILIAS\components\File\Settings\General;
use ILIAS\ResourceStorage\Revision\RevisionStatus;
 
class ilObjFileImplementationStorage extends ilObjFileImplementationAbstract implements ilObjFileImplementationInterface
{
    protected Services $storage;
 
    public function __construct(protected StorableResource $resource)
    {
        global $DIC;
        $settings = new General();
        $this->storage = $DIC->resourceStorage();
    }
 
    public function handleChangedObjectTitle(string $new_title): void
    {
        $current_revision = $this->resource->getCurrentRevision();
        $current_revision->setTitle($new_title);
        $this->storage->manage()->updateRevision($current_revision);
    }
 
    public function getFile(?int $a_hist_entry_id = null): string
    {
        $stream = $this->storage->consume()->stream($this->resource->getIdentification());
        if ($a_hist_entry_id) {
            $stream = $stream->setRevisionNumber($a_hist_entry_id);
        }
        return $stream->getStream()->getMetadata('uri');
    }
 
    public function getFileName(): string
    {
        return $this->resource->getCurrentRevision()->getInformation()->getTitle();
    }
 
    public function getFileSize(): int
    {
        return $this->resource->getCurrentRevision()->getInformation()->getSize() ?: 0;
    }
 
    public function getFileType(): string
    {
        return $this->resource->getCurrentRevision()->getInformation()->getMimeType();
    }
 
    public function getDirectory(int $a_version = 0): string
    {
        $consumer = $this->storage->consume()->stream($this->resource->getIdentification());
        if ($a_version !== 0) {
            $consumer->setRevisionNumber($a_version);
        }
        $stream = $consumer->getStream();
 
        return dirname((string) $stream->getMetadata('uri'));
    }
 
    public function sendFile(?int $a_hist_entry_id = null, bool $inline = true): void
    {
        if ($inline) {
            $consumer = $this->storage->consume()->inline($this->resource->getIdentification());
        } else {
            $consumer = $this->storage->consume()->download($this->resource->getIdentification());
        }
 
        if ($a_hist_entry_id) {
            $revision = $this->resource->getSpecificRevision($a_hist_entry_id);
            $consumer->setRevisionNumber($a_hist_entry_id);
        } else {
            $revision = $this->resource->getCurrentRevision();
        }
        $consumer->overrideFileName($revision->getTitle());
 
        $consumer->run();
    }
 
    public function deleteVersions(?array $a_hist_entry_ids = null): void
    {
        if (is_array($a_hist_entry_ids)) {
            foreach ($a_hist_entry_ids as $id) {
                $this->storage->manage()->removeRevision($this->resource->getIdentification(), $id);
            }
        }
    }
 
    public function getFileExtension(): string
    {
        return $this->resource->getCurrentRevision()->getInformation()->getSuffix();
    }
 
    public function getVersions(?array $version_ids = null): array
    {
        $versions = [];
        $current_revision = $this->resource->getCurrentRevisionIncludingDraft();
        foreach ($this->resource->getAllRevisionsIncludingDraft() as $revision) {
            if (is_array($version_ids) && !in_array($revision->getVersionNumber(), $version_ids)) {
                continue;
            }
            $information = $revision->getInformation();
            $v = new ilObjFileVersion();
            $v->setVersion($revision->getVersionNumber());
            $v->setHistEntryId($revision->getVersionNumber());
            $v->setFilename($information->getTitle());
            if ($revision->getStatus() === RevisionStatus::DRAFT) {
                $v->setAction('draft');
            } else {
                $version_number = $revision->getVersionNumber();
                match ($version_number) {
                    1 => $v->setAction('create'),
                    $current_revision->getVersionNumber() => $v->setAction('published_version'),
                    default => $v->setAction('intermediate_version'),
                };
            }
            $v->setTitle($revision->getTitle());
            $v->setDate($information->getCreationDate()->format(DATE_ATOM));
            $v->setUserId($revision->getOwnerId() !== 0 ? $revision->getOwnerId() : 6);
            $v->setSize($information->getSize());
 
            $versions[] = $v;
        }
 
        return $versions;
    }
 
    public function getStorageID(): ?string
    {
        return $this->resource->getStorageID();
    }
 
    public function getVersion(bool $inclduing_drafts = false): int
    {
        try {
            if ($inclduing_drafts) {
                return $this->resource->getCurrentRevisionIncludingDraft()->getVersionNumber();
            }
            return $this->resource->getCurrentRevision()->getVersionNumber();
        } catch (Throwable) {
            return 0;
        }
    }
 
    public function getMaxVersion(): int
    {
        return $this->resource->getMaxRevision(false);
    }
}