ilFileDataForumDraftsRCImplementation Class Reference

Inheritance diagram for ilFileDataForumDraftsRCImplementation:

Collaboration diagram for ilFileDataForumDraftsRCImplementation:

Public Member Functions
	__construct (private readonly int $obj_id=0, private int $draft_id=0)
	getObjId ()
	getPosId ()
	setPosId (int $posting_id)
	getForumPath ()
	getFilesOfPost ()
	moveFilesOfPost (int $new_frm_id=0)
	ilClone (int $new_obj_id, int $new_posting_id)
	delete (?array $posting_ids_to_delete=null)
	storeUploadedFiles ()
	unlinkFile (string $filename)
	getFileDataByMD5Filename (string $hashed_filename)
	unlinkFilesByMD5Filenames ($hashed_filename_or_filenames)
	deliverFile (string $file)
	deliverZipFile ()

Data Fields
const	FORUM_PATH_RCID = 'RCID'

Private Member Functions
	getCurrentDraft (bool $use_cache=true)
	getDraftById (int $draft_id, bool $use_cache=true)
	getCurrentCollection ()
	getResourceIdByHash (string $hash)

Private Attributes
readonly ILIAS ResourceStorage Services	$irss
readonly ILIAS FileUpload FileUpload	$upload
array	$collection_cache = []
array	$posting_cache = []
readonly ilForumPostingFileStakeholder	$stakeholder

Detailed Description

Definition at line 24 of file class.ilFileDataForumDraftsRCImplementation.php.

Constructor & Destructor Documentation

__construct()

ilFileDataForumDraftsRCImplementation::__construct	(	private readonly int	$obj_id = 0,
		private int	$draft_id = 0
	)

Definition at line 36 of file class.ilFileDataForumDraftsRCImplementation.php.

References $DIC, and ILIAS\Repository\upload().

      {
        global $DIC;
        $this->irss = $DIC->resourceStorage();
        $this->upload = $DIC->upload();
        $this->stakeholder = new ilForumPostingFileStakeholder();
    }

Here is the call graph for this function:

Member Function Documentation

delete()

ilFileDataForumDraftsRCImplementation::delete

(

?array

$posting_ids_to_delete = null

)

Parameters

list<int>|null

$posting_ids_to_delete

Implements ilFileDataForumInterface.

Definition at line 140 of file class.ilFileDataForumDraftsRCImplementation.php.

References $stakeholder, getDraftById(), and null.

                                                                : bool
    {
        // Each element of $posting_ids_to_delete represents a "Draft Id", NOT a "Posting Id"
        if ($posting_ids_to_delete === null) {
            return true;
        }

        foreach ($posting_ids_to_delete as $draft_id) {
            $this->irss->collection()->remove(
                $this->irss->collection()->id(
                    $this->getDraftById($draft_id)->getRCID()
                ),
                $this->stakeholder,
                true
            );
        }

        return true;
    }

Here is the call graph for this function:

deliverFile()

ilFileDataForumDraftsRCImplementation::deliverFile

(

string

$file

)

Implements ilFileDataForumInterface.

Definition at line 230 of file class.ilFileDataForumDraftsRCImplementation.php.

References getResourceIdByHash(), and null.

                                             : void
    {
        $rid = $this->getResourceIdByHash($file);
        if ($rid !== null) {
            $this->irss->consume()->download($rid)->run();
        }
    }

Here is the call graph for this function:

deliverZipFile()

ilFileDataForumDraftsRCImplementation::deliverZipFile

(

)

Implements ilFileDataForumInterface.

Definition at line 238 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentCollection(), getCurrentDraft(), and ILIAS\FileDelivery\Delivery\returnASCIIFileName().

                                    : bool
    {
        // https://mantis.ilias.de/view.php?id=39910
        $zip_filename = \ILIAS\FileDelivery\Delivery::returnASCIIFileName(
            $this->getCurrentDraft()->getPostSubject() . '.zip'
        );
        $rcid = $this->getCurrentCollection()->getIdentification();

        $this->irss
            ->consume()
            ->downloadCollection($rcid, $zip_filename)
            ->useRevisionTitlesForFileNames(false)
            ->run();

        return true;
    }

Here is the call graph for this function:

getCurrentCollection()

ilFileDataForumDraftsRCImplementation::getCurrentCollection ( )

private

Definition at line 60 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentDraft().

Referenced by deliverZipFile(), getFileDataByMD5Filename(), getFilesOfPost(), getResourceIdByHash(), ilClone(), and storeUploadedFiles().

                                           : ResourceCollection
    {
        return $this->collection_cache[$this->draft_id] ?? ($this->collection_cache[$this->draft_id] = $this->irss->collection(
        )->get(
            $this->irss->collection()->id(
                $this->getCurrentDraft()->getRCID()
            )
        ));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentDraft()

ilFileDataForumDraftsRCImplementation::getCurrentDraft ( bool  $use_cache = true )

private

Definition at line 46 of file class.ilFileDataForumDraftsRCImplementation.php.

References getDraftById().

Referenced by deliverZipFile(), getCurrentCollection(), and storeUploadedFiles().

                                                            : ilForumPostDraft
    {
        return $this->getDraftById($this->draft_id, $use_cache);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getDraftById()

ilFileDataForumDraftsRCImplementation::getDraftById ( int  $draft_id, bool  $use_cache = true  )

private

Definition at line 51 of file class.ilFileDataForumDraftsRCImplementation.php.

References ilForumPostDraft\newInstanceByDraftId().

Referenced by delete(), getCurrentDraft(), and ilClone().

                                                                        : ilForumPostDraft
    {
        if ($use_cache && isset($this->posting_cache[$draft_id])) {
            return $this->posting_cache[$draft_id];
        }

        return $this->posting_cache[$draft_id] = ilForumPostDraft::newInstanceByDraftId($draft_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getFileDataByMD5Filename()

ilFileDataForumDraftsRCImplementation::getFileDataByMD5Filename

(

string

$hashed_filename

)

Returns

array{path: string, filename: string, clean_filename: string}|null

Implements ilFileDataForumInterface.

Definition at line 194 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentCollection(), and null.

                                                                     : ?array
    {
        foreach ($this->getCurrentCollection()->getResourceIdentifications() as $identification) {
            $revision = $this->irss->manage()->getCurrentRevision($identification);
            if ($revision->getTitle() === $hashed_filename) {
                $info = $revision->getInformation();
                return [
                    'path' => '',
                    'filename' => $info->getTitle(),
                    'clean_filename' => $info->getTitle()
                ];
            }
        }

        return null;
    }

Here is the call graph for this function:

getFilesOfPost()

ilFileDataForumDraftsRCImplementation::getFilesOfPost

(

)

Returns

array<string, array{path: string, md5: string, name: string, size: int, ctime: string}>

Implements ilFileDataForumInterface.

Definition at line 105 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentCollection().

                                    : array
    {
        $files = [];
        foreach ($this->getCurrentCollection()->getResourceIdentifications() as $identification) {
            $revision = $this->irss->manage()->getCurrentRevision($identification);
            $info = $revision->getInformation();
            $files[$revision->getTitle()] = [
                'path' => $this->irss->consume()->stream($identification)->getStream()->getMetadata('uri'),
                'md5' => $revision->getTitle(),
                'name' => $info->getTitle(),
                'size' => $info->getSize(),
                'ctime' => $info->getCreationDate()->format('Y-m-d H:i:s')
            ];
        }

        return $files;
    }

Here is the call graph for this function:

getForumPath()

ilFileDataForumDraftsRCImplementation::getForumPath

(

)

Implements ilFileDataForumInterface.

Definition at line 97 of file class.ilFileDataForumDraftsRCImplementation.php.

                                  : string
    {
        return self::FORUM_PATH_RCID;
    }

getObjId()

ilFileDataForumDraftsRCImplementation::getObjId

(

)

Implements ilFileDataForumInterface.

Definition at line 82 of file class.ilFileDataForumDraftsRCImplementation.php.

                              : int
    {
        return $this->obj_id;
    }

getPosId()

ilFileDataForumDraftsRCImplementation::getPosId

(

)

Implements ilFileDataForumInterface.

Definition at line 87 of file class.ilFileDataForumDraftsRCImplementation.php.

                              : int
    {
        return $this->draft_id;
    }

getResourceIdByHash()

ilFileDataForumDraftsRCImplementation::getResourceIdByHash ( string  $hash )

private

Definition at line 70 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentCollection(), and null.

Referenced by deliverFile(), and unlinkFilesByMD5Filenames().

                                                      : ?ResourceIdentification
    {
        foreach ($this->getCurrentCollection()->getResourceIdentifications() as $identification) {
            $revision = $this->irss->manage()->getCurrentRevision($identification);
            if ($revision->getTitle() === $hash) {
                return $identification;
            }
        }

        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

ilClone()

ilFileDataForumDraftsRCImplementation::ilClone	(	int	$new_obj_id,
		int	$new_posting_id
	)

Implements ilFileDataForumInterface.

Definition at line 129 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentCollection(), and getDraftById().

                                                                 : bool
    {
        $current_collection_id = $this->getCurrentCollection()->getIdentification();
        $new_collection_id = $this->irss->collection()->clone($current_collection_id);
        $new_draft = $this->getDraftById($new_posting_id);
        $new_draft->setRCID($new_collection_id->serialize());
        $new_draft->update();

        return true;
    }

Here is the call graph for this function:

moveFilesOfPost()

ilFileDataForumDraftsRCImplementation::moveFilesOfPost

(

int

$new_frm_id = 0

)

Implements ilFileDataForumInterface.

Definition at line 123 of file class.ilFileDataForumDraftsRCImplementation.php.

                                                        : bool
    {
        // nothing to do here since collections are related to the post
        return true;
    }

setPosId()

ilFileDataForumDraftsRCImplementation::setPosId

(

int

$posting_id

)

Implements ilFileDataForumInterface.

Definition at line 92 of file class.ilFileDataForumDraftsRCImplementation.php.

                                             : void
    {
        $this->draft_id = $posting_id;
    }

storeUploadedFiles()

ilFileDataForumDraftsRCImplementation::storeUploadedFiles

(

)

Implements ilFileDataForumInterface.

Definition at line 160 of file class.ilFileDataForumDraftsRCImplementation.php.

References getCurrentCollection(), getCurrentDraft(), and ILIAS\Repository\upload().

                                        : bool
    {
        if (!$this->upload->hasBeenProcessed()) {
            $this->upload->process();
        }
        $collection = $this->getCurrentCollection();

        foreach ($this->upload->getResults() as $result) {
            if (!$result->isOK()) {
                continue;
            }
            $rid = $this->irss->manage()->upload(
                $result,
                $this->stakeholder,
                md5($result->getName())
            );
            $collection->add($rid);
        }
        $this->irss->collection()->store($collection);
        $draft = $this->getCurrentDraft(false);
        $draft->setRCID($collection->getIdentification()->serialize());
        $draft->update();

        return true;
    }

Here is the call graph for this function:

unlinkFile()

ilFileDataForumDraftsRCImplementation::unlinkFile

(

string

$filename

)

Implements ilFileDataForumInterface.

Definition at line 186 of file class.ilFileDataForumDraftsRCImplementation.php.

                                                : bool
    {
        throw new DomainException('Not implemented');
    }

unlinkFilesByMD5Filenames()

ilFileDataForumDraftsRCImplementation::unlinkFilesByMD5Filenames

(

$hashed_filename_or_filenames

)

Parameters

string|string[]

$hashed_filename_or_filenames

Implements ilFileDataForumInterface.

Definition at line 214 of file class.ilFileDataForumDraftsRCImplementation.php.

References getResourceIdByHash(), and null.

                                                                            : bool
    {
        $hashes = is_array($hashed_filename_or_filenames)
            ? $hashed_filename_or_filenames
            : [$hashed_filename_or_filenames];

        foreach ($hashes as $hash) {
            $identification = $this->getResourceIdByHash($hash);
            if ($identification !== null) {
                $this->irss->manage()->remove($identification, $this->stakeholder);
            }
        }

        return true;
    }

Here is the call graph for this function:

Field Documentation

$collection_cache

array ilFileDataForumDraftsRCImplementation::$collection_cache = []

private

Definition at line 31 of file class.ilFileDataForumDraftsRCImplementation.php.

$irss

readonly ILIAS ResourceStorage Services ilFileDataForumDraftsRCImplementation::$irss

private

Definition at line 28 of file class.ilFileDataForumDraftsRCImplementation.php.

$posting_cache

array ilFileDataForumDraftsRCImplementation::$posting_cache = []

private

Definition at line 33 of file class.ilFileDataForumDraftsRCImplementation.php.

$stakeholder

readonly ilForumPostingFileStakeholder ilFileDataForumDraftsRCImplementation::$stakeholder

private

Definition at line 34 of file class.ilFileDataForumDraftsRCImplementation.php.

Referenced by delete().

$upload

readonly ILIAS FileUpload FileUpload ilFileDataForumDraftsRCImplementation::$upload

private

Definition at line 29 of file class.ilFileDataForumDraftsRCImplementation.php.

FORUM_PATH_RCID

const ilFileDataForumDraftsRCImplementation::FORUM_PATH_RCID = 'RCID'

Definition at line 26 of file class.ilFileDataForumDraftsRCImplementation.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Forum/classes/Files/class.ilFileDataForumDraftsRCImplementation.php