Package overit.geocallapp.docshare.documents.bl.sharedresource.file.task

Class BTFileConfirm

java.lang.Object

overit.geocall.bl.BusinessTask<FileConfirmEvent>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask<FileConfirmEvent>

overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask<FileConfirmEvent>

overit.geocallapp.docshare.documents.bl.sharedresource.file.task.BTFileConfirm

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(FileConfirmEvent.class)
public class BTFileConfirm
extends ValidPermissionBusinessTask<FileConfirmEvent>

Business task that confirms the upload of a file.
When a FileConfirmEvent is launched, this task:

• Retrieves all versions of the file
• Verifies that the new version is not older than the currently active one
• Completes the file data (name, extension, size) from the uploaded file
• Activates the new version by calling the FileActivateEvent

Error codes:

• Codes.SharedResource.ALREADY_ACTIVE_VERSION
• Codes.WebResource.WR_NOT_FOUND

Since:

14.0

See Also:

• Serialized Form

GCApi:

task

Field Summary

Fields inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask

LOG

Constructor Summary

Constructors

Constructor	Description
BTFileConfirm()

Method Summary

Modifier and Type	Method	Description
protected void	activateVersion(BOFile lastVersion, PoolKit poolKit)	Activates the given BOFile version by calling the FileActivateEvent.
protected void	completeData(BOFile file, PoolKit poolKit)	Completes the data of the given BOFile before the activation.
protected void	execute(FileConfirmEvent event, PoolKit poolKit)	Validates and activates the latest version of a BOFile.
protected List<BOFile>	getSortedFileVersions(String uuid, PoolKit poolKit)	Returns all the versions of the BOFile with the given uuid, sorted from the last version on.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected void	validate(String uuid, PoolKit poolKit)	Validates the given FileConfirmEvent.

Methods inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidPermissionBusinessTask

checkValidExecution, getException, throwExceptionIfInvalid

Methods inherited from class overit.geocallapp.utilities.core.bl.common.validexecution.ValidExecutionBusinessTask

body, getEvent

Methods inherited from class overit.geocall.bl.BusinessTask

start, start, startAlone, startInBackground

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

BTFileConfirm

public BTFileConfirm()

Method Details

execute

protected void execute(FileConfirmEvent event,
 PoolKit poolKit)
                throws DAException,
DAValidateException

Validates and activates the latest version of a BOFile. This method:

• Validates the input UUID
• Retrieves the latest versions of the file and checks if it can be activated
• Completes the file metadata (name, extension, size)
• Activates the new version

Specified by:

execute in class ValidExecutionBusinessTask<FileConfirmEvent>

Parameters:

event - the FileConfirmEvent containing the file's UUID

poolKit - the PoolKit for database operations

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

validate

protected void validate(String uuid,
 PoolKit poolKit)
                 throws DAValidateException,
DAException

Validates the given FileConfirmEvent.

Parameters:

uuid - the FileConfirmEvent

poolKit - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

getSortedFileVersions

protected List<BOFile> getSortedFileVersions(String uuid,
 PoolKit poolKit)
                                      throws DAValidateException,
DAException

Returns all the versions of the BOFile with the given uuid, sorted from the last version on.

Parameters:

uuid - the uuid of the BOFile

Returns:

a sorted list of BOFile versions

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

completeData

protected void completeData(BOFile file,
 PoolKit poolKit)
                     throws DAValidateException,
DAException

Completes the data of the given BOFile before the activation.

Parameters:

file - the current BOFile

poolKit - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

activateVersion

protected void activateVersion(BOFile lastVersion,
 PoolKit poolKit)
                        throws DAValidateException,
DAException

Activates the given BOFile version by calling the FileActivateEvent.

Parameters:

lastVersion - the BOFile version to activate

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

isValidExecution

public boolean isValidExecution()

Description copied from interface: ValidExecution

Determines whether the current state is valid for execution.

Returns:

true if execution is valid, false otherwise