Description of class class. More...

Inheritance diagram for ilCheckSumOfFileSizesJob:

Collaboration diagram for ilCheckSumOfFileSizesJob:

Public Member Functions
	__construct ()
	Construct. More...

	getInputTypes ()
	@inheritDoc More...

	getOutputType ()
	@inheritDoc More...

	isStateless ()
	@inheritDoc More...

	run (array $input, \ILIAS\BackgroundTasks\Observer $observer)
	@inheritDoc More...

	getExpectedTimeOfTaskInSeconds ()
	Returns int the amount of seconds this task usually taskes. If your task-duration scales with the the amount of data, try to set a possible high value of try to calculate it. If a task duration exceeds this value, it will be displayed as "possibly failed" to the user More...

Public Member Functions inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractJob
	getInput ()
	Returns Value[] More...

Public Member Functions inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
	setInput (array $values)

	getOutput ()

	getInput ()

	getType ()

	unfoldTask ()
	Unfold the task. More...

	getRemoveOption ()
	Returns Option An Option to remove the current task and do some cleanup if possible. This Option is displayed if the Bucket is completed. You do not have to provide an additional Option to remove in your UserInteraction, the remove-Option is added to the list of Options (last position) See also self::getAbortOption(); More...

	getAbortOption ()
	Returns Option In case a Job is failed or did not respond for some time, an Abort-Option is displayed. There is already a Standard-Abort-Option registered, you can override with your own and do some cleanup if possible. More...

	getType ()

	getInputTypes ()

	getOutputType ()

	getOutput ()

	setInput (array $values)

	getInput ()

	unfoldTask ()

	getRemoveOption ()

	getAbortOption ()

Public Member Functions inherited from ILIAS\BackgroundTasks\Task\Job
	run (array $input, Observer $observer)

	isStateless ()

	getInput ()

	getExpectedTimeOfTaskInSeconds ()

Protected Member Functions
	calculateRecursive (array $a_ref_ids, int &$a_file_size)
	Calculates the number and size of the files being downloaded recursively. More...

	validateAccess (int $ref_id)
	Check file access. More...

Protected Member Functions inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
	checkTypes ($values)

	extractType ($value)

Protected Attributes
ilSetting	$settings

Protected Attributes inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
array	$input = []

ILIAS BackgroundTasks Value	$output

Private Attributes
ilLogger	$logger

Additional Inherited Members
Data Fields inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
const	MAIN_REMOVE = 'bt_main_remove'

const	MAIN_ABORT = 'bt_main_abort'

Detailed Description

Description of class class.

Author: Lukas Zehnder lz@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 30 of file class.ilCheckSumOfFileSizesJob.php.

Constructor & Destructor Documentation

◆ __construct()

ilCheckSumOfFileSizesJob::__construct ( )

Construct.

Definition at line 39 of file class.ilCheckSumOfFileSizesJob.php.

    {
        global $DIC;
        $this->logger = $DIC->logger()->cal();
        $this->settings = new ilSetting("fold");
    }

References $DIC, ILIAS\Repository\logger(), and ILIAS\Repository\settings().

Here is the call graph for this function:

Member Function Documentation

◆ calculateRecursive()

ilCheckSumOfFileSizesJob::calculateRecursive	(	array	$a_ref_ids,
		int &	$a_file_size
	)

protected

Calculates the number and size of the files being downloaded recursively.

Definition at line 114 of file class.ilCheckSumOfFileSizesJob.php.

                                                                              : void
    {
        global $DIC;
        $tree = $DIC['tree'];
 
        // parse folders
        foreach ($a_ref_ids as $ref_id) {
            if (!$this->validateAccess($ref_id)) {
                continue;
            }
 
            // we are only interested in folders and files
            switch (ilObject::_lookupType($ref_id, true)) {
                case "fold":
                    // get child objects
                    $subtree = $tree->getChildsByTypeFilter($ref_id, array("fold", "file"));
                    if (count($subtree) > 0) {
                        $child_ref_ids = array();
                        foreach ($subtree as $child) {
                            $child_ref_ids[] = $child["ref_id"];
                        }
                        $this->calculateRecursive($child_ref_ids, $a_file_size);
                    }
                    break;
 
                case "file":
                    $a_file_size += ilObjFileAccess::_lookupFileSize($ref_id);
                    break;
            }
        }
    }

References $DIC, $ref_id, ilObjFileAccess\_lookupFileSize(), ilObject\_lookupType(), calculateRecursive(), and validateAccess().

Referenced by calculateRecursive(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getExpectedTimeOfTaskInSeconds()

ilCheckSumOfFileSizesJob::getExpectedTimeOfTaskInSeconds ( )

Returns: int the amount of seconds this task usually taskes. If your task-duration scales with the the amount of data, try to set a possible high value of try to calculate it. If a task duration exceeds this value, it will be displayed as "possibly failed" to the user

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 167 of file class.ilCheckSumOfFileSizesJob.php.

◆ getInputTypes()

ilCheckSumOfFileSizesJob::getInputTypes ( )

@inheritDoc

Implements ILIAS\BackgroundTasks\Task.

Definition at line 50 of file class.ilCheckSumOfFileSizesJob.php.

                                   : array
    {
        return
            [
                new SingleType(ilCopyDefinition::class),
            ];
    }

◆ getOutputType()

ilCheckSumOfFileSizesJob::getOutputType ( )

@inheritDoc

Implements ILIAS\BackgroundTasks\Task.

Definition at line 62 of file class.ilCheckSumOfFileSizesJob.php.

                                   : Type
    {
        return new SingleType(ilCopyDefinition::class);
    }

◆ isStateless()

ilCheckSumOfFileSizesJob::isStateless ( )

@inheritDoc

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 71 of file class.ilCheckSumOfFileSizesJob.php.

                                 : bool
    {
        return true;
    }

◆ run()

ilCheckSumOfFileSizesJob::run	(	array	$input,
		\ILIAS\BackgroundTasks\Observer	$observer
	)

@inheritDoc

Todo:: use filesystem service

Definition at line 81 of file class.ilCheckSumOfFileSizesJob.php.

                                                                                : Value
    {
        $this->logger->debug('Start checking adherence to maxsize!');
        $this->logger->dump($input);
        $definition = $input[0];
        $object_ref_ids = $definition->getObjectRefIds();
 
        // get global limit (max sum of individual file-sizes) from file settings
        $size_limit = (int) $this->settings->get("bgtask_download_limit", '0');
        $size_limit_bytes = $size_limit * 1024 * 1024;
        $this->logger->debug('Global limit (max sum of all file-sizes) in file-settings: ' . $size_limit_bytes . ' bytes');
        // get sum of individual file-sizes
        $total_bytes = 0;
        $this->calculateRecursive($object_ref_ids, $total_bytes);
        $this->logger->debug('Calculated sum of all file-sizes: ' . $total_bytes . 'MB');
        // check if calculated total size adheres top global limit
        $adheres_to_limit = new BooleanValue();
        $adheres_to_limit->setValue(true);
        if ($total_bytes > $size_limit_bytes) {
            $adheres_to_limit->setValue(false);
        }
 
        $definition->setSumFileSizes($total_bytes);
        $definition->setAdheresToLimit($adheres_to_limit);
 
        return $definition;
    }

References ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask\$input, calculateRecursive(), ILIAS\Repository\int(), ILIAS\Repository\logger(), and ILIAS\Repository\settings().

Here is the call graph for this function:

◆ validateAccess()

ilCheckSumOfFileSizesJob::validateAccess ( int $ref_id )

protected

Check file access.

Definition at line 152 of file class.ilCheckSumOfFileSizesJob.php.

                                                  : bool
    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        if (!$ilAccess->checkAccess("read", "", $ref_id)) {
            return false;
        }
        return !ilObject::_isInTrash($ref_id);
    }