TYPO3\CMS\Core\Resource\Processing\TaskInterface Interface Reference

Inheritance diagram for TYPO3\CMS\Core\Resource\Processing\TaskInterface:

Public Member Functions
	__construct (Resource\ProcessedFile $targetFile, array $configuration)
	getName ()
	getType ()
	getTargetFile ()
	getSourceFile ()
	getConfiguration ()
	getConfigurationChecksum ()
	getTargetFileName ()
	getTargetFileExtension ()
	fileNeedsProcessing ()
	isExecuted ()
	setExecuted ($successful)
	isSuccessful ()

Detailed Description

A task is a unit of work that can be performed by a file processor. This may include multiple steps in any order, details depend on the configuration of the task and the tools the processor uses.

Each task has a type and a name. The type describes the category of the task, like "image" and "video". If your task is generic or applies to multiple types of files, use "general".

A task also already has to know the target file it should be executed on, so there is no "abstract" task that just specifies the steps to be executed without a concrete file. However, new tasks can easily be created from an existing task object.

Definition at line 30 of file TaskInterface.php.

Constructor & Destructor Documentation

__construct()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::__construct	(	Resource\ProcessedFile	$targetFile,
		array	$configuration
	)

Parameters

\TYPO3\CMS\Core\Resource\ProcessedFile	$targetFile
array	$configuration

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Member Function Documentation

fileNeedsProcessing()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::fileNeedsProcessing

(

)

Returns TRUE if the file has to be processed at all, such as e.g. the original file does.

Note: This does not indicate if the concrete ProcessedFile attached to this task has to be (re)processed. This check is done in ProcessedFile::isOutdated().

Todo:

isOutdated()/needsReprocessing()?

Returns

bool

Implemented in TYPO3\CMS\Core\Resource\Processing\ImagePreviewTask, and TYPO3\CMS\Core\Resource\Processing\ImageCropScaleMaskTask.

getConfiguration()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getConfiguration

(

)

Returns the configuration for this task.

Returns

array

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper\process().

getConfigurationChecksum()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getConfigurationChecksum

(

)

Returns the configuration checksum of this task.

Returns

string

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\checkForExistingTargetFile(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().

getName()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getName

(

)

Returns the name of this task.

Returns

string

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\canProcessTask(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().

getSourceFile()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getSourceFile

(

)

Returns the original file this task is based on.

Returns

Resource

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper\__construct(), TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\checkForExistingTargetFile(), TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper\getFilenameForImageCropScaleMask(), TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper\process(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().

getTargetFile()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getTargetFile

(

)

Returns the processed file this task is executed on.

Returns

Resource

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper\__construct(), TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\checkForExistingTargetFile(), TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper\getFilenameForImageCropScaleMask(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().

getTargetFileExtension()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getTargetFileExtension

(

)

Gets the file extension the processed file should have in the filesystem.

Returns

string

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask, and TYPO3\CMS\Core\Resource\Processing\AbstractGraphicalTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalCropScaleMaskHelper\__construct(), and TYPO3\CMS\Core\Resource\Processing\LocalPreviewHelper\getTemporaryFilePath().

getTargetFileName()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getTargetFileName

(

)

Returns the name the processed file should have in the filesystem.

Returns

string

Implemented in TYPO3\CMS\Core\Resource\Processing\ImagePreviewTask, and TYPO3\CMS\Core\Resource\Processing\ImageCropScaleMaskTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\checkForExistingTargetFile(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().

getType()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::getType

(

)

Returns the type of this task.

Returns

string

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\canProcessTask(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().

isExecuted()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::isExecuted

(

)

Returns TRUE if this task has been executed, no matter if the execution was successful.

Returns

bool

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

isSuccessful()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::isSuccessful

(

)

Returns TRUE if this task has been successfully executed. Only call this method if the task has been processed at all.

Returns

bool

Exceptions

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

setExecuted()

TYPO3\CMS\Core\Resource\Processing\TaskInterface::setExecuted

(

$successful

)

Mark this task as executed. This is used by the Processors in order to transfer the state of this task to the file processing service.

Parameters

bool

$successful

Set this to FALSE if executing the task failed

Returns

void

Implemented in TYPO3\CMS\Core\Resource\Processing\AbstractTask.

Referenced by TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\checkForExistingTargetFile(), and TYPO3\CMS\Core\Resource\Processing\LocalImageProcessor\processTask().