Package overit.geocallapp.wfm.core.bl.crewshell.composition.draft.task

Class BTCrewShellTechnicianUpdate

java.lang.Object

overit.geocall.bl.BusinessTask<CrewShellTechnicianUpdateEvent>

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

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

overit.geocallapp.wfm.core.bl.crewshell.composition.draft.task.BTCrewShellTechnicianUpdate

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(CrewShellTechnicianUpdateEvent.class)
public class BTCrewShellTechnicianUpdate
extends ValidPermissionBusinessTask<CrewShellTechnicianUpdateEvent>

Business task in order to update a BOCrewShellDraftComposition object.
When the CrewShellTechnicianUpdateEvent event is launched the BT notices the call and updates the BOCrewShellDraftComposition object basing on the event's input.

Since:

16.0

See Also:

• Serialized Form

GCApi:

task

Field Summary

Fields

Modifier and Type	Field	Description
protected BOCache<BOOperationCenter>	operationCenterBOCache

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

LOG

Constructor Summary

Constructors

Constructor	Description
BTCrewShellTechnicianUpdate()

Method Summary

Modifier and Type	Method	Description
protected void	alignCrewShellComposition(Long crewShellID, Date day, PoolKit pk)	Aligns the composition of a BOCrewShell object (i.e., crew shell) for the selected Date day (i.e., composition day) if its composition changes.
protected void	execute(CrewShellTechnicianUpdateEvent event, PoolKit poolKit)	Executes the actual business logic after validation has passed.
protected List<String>	getNotUpdatableFields()	Retrieves the list of the not editable fields of a BOCrewShellDraftComposition object.
protected void	handleForemanToFalseTransition(BOCrewShellDraftComposition currentTechnician, PoolKit poolKit)	Handles the transition of the foreman field from true to false for the BOCrewShellDraftComposition object to be updated.
protected void	handleForemanToTrueTransition(BOCrewShellDraftComposition currentTechnician, PoolKit poolKit)	Handles the transition of the foreman field from false to true for the BOCrewShellDraftComposition object to be updated.
protected void	initCache()	Initializes the BOCache objects for each business object.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected void	updateForemanTransition(BOCrewShellDraftComposition currentTechnician, boolean newForemanValue, PoolKit poolKit)	Updates the transition of the foreman field for the BOCrewShellDraftComposition object to be updated.

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

Field Details

operationCenterBOCache

protected BOCache<BOOperationCenter> operationCenterBOCache

Constructor Details

BTCrewShellTechnicianUpdate

public BTCrewShellTechnicianUpdate()

Method Details

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

execute

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

Description copied from class: ValidExecutionBusinessTask

Executes the actual business logic after validation has passed.

Specified by:

execute in class ValidExecutionBusinessTask<CrewShellTechnicianUpdateEvent>

Parameters:

event - the input event to process

poolKit - the PoolKit

Throws:

DAException - if a data access error occurs during execution

DAValidateException - if validation fails during execution

handleForemanToFalseTransition

protected void handleForemanToFalseTransition(BOCrewShellDraftComposition currentTechnician,
 PoolKit poolKit)
                                       throws DAValidateException,
DAException

Handles the transition of the foreman field from true to false for the BOCrewShellDraftComposition object to be updated. It updates the BOCrewShellDraftComposition object's foreman status from true to false and performs any necessary operations related to this transition; more precisely, it searches for other BOCrewShellDraftComposition objects in the same BOCrewShell object and determines the BOCrewShellDraftComposition having the smallest id as the new foreman.

Parameters:

currentTechnician - the current BOCrewShellDraftComposition object for whom the foreman field is transitioning

poolKit - the PoolKit poolkit

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

handleForemanToTrueTransition

protected void handleForemanToTrueTransition(BOCrewShellDraftComposition currentTechnician,
 PoolKit poolKit)
                                      throws DAValidateException,
DAException

Handles the transition of the foreman field from false to true for the BOCrewShellDraftComposition object to be updated. It updates the BOCrewShellDraftComposition object's foreman status from false to true and performs any necessary operations related to this transition; more precisely, it searches for the current BOCrewShellDraftComposition foreman and determines the BOCrewShellDraftComposition object to be updated as the new foreman of the BOCrewShell object.

Parameters:

currentTechnician - the current BOCrewShellDraftComposition object for whom the foreman field is transitioning

poolKit - the PoolKit poolkit

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

updateForemanTransition

protected void updateForemanTransition(BOCrewShellDraftComposition currentTechnician,
 boolean newForemanValue,
 PoolKit poolKit)
                                throws DAValidateException,
DAException

Updates the transition of the foreman field for the BOCrewShellDraftComposition object to be updated. It manages the transition of the foreman field for the BOCrewShellDraftComposition object to be updated, which can either change from true to false or from false to true. It searches for other BOCrewShellDraftComposition objects within the same BOCrewShell object and determines the new foreman based on certain logical conditions based on the id.

Parameters:

currentTechnician - the current BOCrewShellDraftComposition object for whom the foreman field is transitioning

newForemanValue - the new value for the foreman field (i.e., true or false)

poolKit - the PoolKit poolkit

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

getNotUpdatableFields

protected List<String> getNotUpdatableFields()

Retrieves the list of the not editable fields of a BOCrewShellDraftComposition object.

Returns:

notUpdatableFields the list of the not editable fields.

alignCrewShellComposition

protected void alignCrewShellComposition(Long crewShellID,
 Date day,
 PoolKit pk)
                                  throws DAException,
DAValidateException

Aligns the composition of a BOCrewShell object (i.e., crew shell) for the selected Date day (i.e., composition day) if its composition changes.

Parameters:

crewShellID - the crew shell's ID

day - the composition date

pk - the PoolKit poolkit

Throws:

DAValidateException - if there is a data validation exception

DAException - if a generic Exception object is thrown

initCache

protected void initCache()

Initializes the BOCache objects for each business object.