Description of class class. More...

Inheritance diagram for ilCopyWorkspaceFilesToTempDirectoryJob:

Collaboration diagram for ilCopyWorkspaceFilesToTempDirectoryJob:

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

	getInputTypes ()

	getOutputType ()

	isStateless ()

	run (array $input, Observer $observer)
	run the job 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 ()

	run (array $input, Observer $observer)

	isStateless ()

	getInput ()

	getExpectedTimeOfTaskInSeconds ()

Protected Member Functions
	createUniqueTempDirectory ()

	createTargetDirectory ($a_tmpdir)

	copyFiles ($tmpdir, ilWorkspaceCopyDefinition $definition)
	Copy files. More...

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

	extractType ($value)

Protected Attributes
	$target_directory

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

	$output

Private Attributes
	$logger = null

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: killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 19 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

Constructor & Destructor Documentation

◆ __construct()

ilCopyWorkspaceFilesToTempDirectoryJob::__construct ( )

Constructor.

Definition at line 35 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        $this->logger = ilLoggerFactory::getLogger("pwsp");
    }

References ilLoggerFactory\getLogger().

Here is the call graph for this function:

Member Function Documentation

◆ copyFiles()

ilCopyWorkspaceFilesToTempDirectoryJob::copyFiles	(		$tmpdir,
		ilWorkspaceCopyDefinition	$definition
	)

protected

Copy files.

Parameters

string	$tmpdir
ilWorkspaceCopyDefinition	$definition

Definition at line 122 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        foreach ($definition->getCopyDefinitions() as $copy_task) {
            if (!file_exists($copy_task[ilWorkspaceCopyDefinition::COPY_SOURCE_DIR])) {
                // if the "file" to be copied is an empty folder the directory has to be created so it will be contained in the download zip
                $is_empty_folder = preg_match_all("/\/$/", $copy_task[ilWorkspaceCopyDefinition::COPY_TARGET_DIR]);
                if ($is_empty_folder) {
                    mkdir($tmpdir . '/' . $copy_task[ilWorkspaceCopyDefinition::COPY_TARGET_DIR]);
                    $this->logger->notice('Empty folder has been created: ' . $tmpdir . '/' . $copy_task[ilWorkspaceCopyDefinition::COPY_SOURCE_DIR]);
                } else {
                    $this->logger->notice('Cannot find file: ' . $copy_task[ilWorkspaceCopyDefinition::COPY_SOURCE_DIR]);
                }
                continue;
            }
            $this->logger->debug('Creating directory: ' . $tmpdir . '/' . dirname($copy_task[ilWorkspaceCopyDefinition::COPY_TARGET_DIR]));
            ilUtil::makeDirParents(
                $tmpdir . '/' . dirname($copy_task[ilWorkspaceCopyDefinition::COPY_TARGET_DIR])
            );
 
            $this->logger->debug(
                'Copying from: ' .
                $copy_task[ilWorkspaceCopyDefinition::COPY_SOURCE_DIR] .
                ' to ' .
                $tmpdir . '/' . $copy_task[ilWorkspaceCopyDefinition::COPY_TARGET_DIR]
            );
 
            copy(
                $copy_task[ilWorkspaceCopyDefinition::COPY_SOURCE_DIR],
                $tmpdir . '/' . $copy_task[ilWorkspaceCopyDefinition::COPY_TARGET_DIR]
            );
        }
        return;
    }

References ilWorkspaceCopyDefinition\COPY_SOURCE_DIR, ilWorkspaceCopyDefinition\COPY_TARGET_DIR, ilWorkspaceCopyDefinition\getCopyDefinitions(), and ilUtil\makeDirParents().

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createTargetDirectory()

ilCopyWorkspaceFilesToTempDirectoryJob::createTargetDirectory ( $a_tmpdir )

protected

Definition at line 108 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        $final_dir = $a_tmpdir . "/" . $this->target_directory;
        ilUtil::makeDirParents($final_dir);
        $this->logger->info('New final directory: ' . $final_dir);
        return $final_dir;
    }

References $target_directory, and ilUtil\makeDirParents().

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createUniqueTempDirectory()

ilCopyWorkspaceFilesToTempDirectoryJob::createUniqueTempDirectory ( )

protected

Todo:: refactor to new file system access Create unique temp directory

Returns: string absolute path to new temp directory

Definition at line 100 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        $tmpdir = ilUtil::ilTempnam();
        ilUtil::makeDirParents($tmpdir);
        $this->logger->info('New temp directory: ' . $tmpdir);
        return $tmpdir;
    }

References ilUtil\ilTempnam(), and ilUtil\makeDirParents().

Referenced by run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getExpectedTimeOfTaskInSeconds()

ilCopyWorkspaceFilesToTempDirectoryJob::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 159 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        return 30;
    }

◆ getInputTypes()

ilCopyWorkspaceFilesToTempDirectoryJob::getInputTypes ( )

Returns: Type[] A list of types that are taken as input.

Implements ILIAS\BackgroundTasks\Task.

Definition at line 42 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        return
            [
                new SingleType(ilWorkspaceCopyDefinition::class)
            ];
    }

◆ getOutputType()

ilCopyWorkspaceFilesToTempDirectoryJob::getOutputType ( )

Todo:: output should be file type

Returns: SingleType

Implements ILIAS\BackgroundTasks\Task.

Definition at line 54 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        return new SingleType(StringValue::class);
    }

◆ isStateless()

ilCopyWorkspaceFilesToTempDirectoryJob::isStateless ( )

Returns: bool returns true iff the job's output ONLY depends on the input. Stateless task results may be cached!

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 59 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        return true;
    }

◆ run()

ilCopyWorkspaceFilesToTempDirectoryJob::run	(	array	$input,
		Observer	$observer
	)

run the job

Parameters

Value	$input
Observer	$observer

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 69 of file class.ilCopyWorkspaceFilesToTempDirectoryJob.php.

    {
        $definition = $input[0];
 
        $this->logger->info('Called copy files job');
 
        $this->target_directory = $definition->getTempDir();
 
        // create temp directory
        $tmpdir = $this->createUniqueTempDirectory();
        $targetdir = $this->createTargetDirectory($tmpdir);
 
        // copy files from source to temp directory
        //$this->copyFiles($targetdir, $input[0]);
        $this->copyFiles($targetdir, $definition);
 
        // zip
 
        // return zip file name
        $this->logger->debug('Returning new tempdirectory: ' . $targetdir);
 
        $out = new StringValue();
        $out->setValue($targetdir);
        return $out;
    }