Package overit.geocallapp.wfm.gpstracking.rc1.position.task

Class BTGPSTimedPositionSearch

java.lang.Object

overit.geocall.bl.BusinessTask<TimedGPSPositionSearchEvent>

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

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

overit.geocallapp.wfm.gpstracking.rc1.position.task.BTGPSTimedPositionSearch

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(TimedGPSPositionSearchEvent.class)
public class BTGPSTimedPositionSearch
extends ValidPermissionBusinessTask<TimedGPSPositionSearchEvent>

Business task for searching timed GPS positions.
The task retrieves timed GPS position data for a specific resource by calling an external REST service if the endpoint was correctly configured in the company properties (see PropertiesGPSTracking.GPSTimedPosition.getGPSTimedPositionEndpoint()).

Since:

22.0

See Also:

• Serialized Form

GCApi:

task

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	CONFIG_NAME

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

LOG

Constructor Summary

Constructors

Constructor	Description
BTGPSTimedPositionSearch()

Method Summary

Modifier and Type	Method	Description
protected void	execute(TimedGPSPositionSearchEvent event, PoolKit poolKit)	Executes the timed GPS position search operation.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected PageResponse<TimedGPSPosition>	loadGPSTimedPositions(TimedGPSPositionSearchFilter filter)	Loads timed GPS positions from an external REST service, if configured.
protected Map<String,Object>	prepareFilters(TimedGPSPositionSearchFilter filter)	Prepares the filters for the timed GPS position search.

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

CONFIG_NAME

protected static final String CONFIG_NAME

See Also:

• Constant Field Values

Constructor Details

BTGPSTimedPositionSearch

public BTGPSTimedPositionSearch()

Method Details

execute

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

Executes the timed GPS position search operation. This method retrieves timed GPS position data for a specific resource by calling an external REST service.

Specified by:

execute in class ValidExecutionBusinessTask<TimedGPSPositionSearchEvent>

Parameters:

event - The TimedGPSPositionSearchEvent containing the search filter

poolKit - The PoolKit providing access to the data layer

Throws:

DAException - If a data access error occurs during the operation

DAValidateException - If validation of the data fails

loadGPSTimedPositions

protected PageResponse<TimedGPSPosition> loadGPSTimedPositions(TimedGPSPositionSearchFilter filter)
                                                        throws DAValidateException

Loads timed GPS positions from an external REST service, if configured. This method retrieves timed GPS position data for a specific resource by calling an external REST service, if the endpoint was correctly configured in the company properties.

Parameters:

filter - The TimedGPSPositionSearchFilter containing the search filter

Returns:

A PageResponse containing the retrieved timed GPS positions

Throws:

DAValidateException - If validation of the data fails

prepareFilters

protected Map<String,Object> prepareFilters(TimedGPSPositionSearchFilter filter)

Prepares the filters for the timed GPS position search.

Parameters:

filter - The TimedGPSPositionSearchFilter containing the search filter

Returns:

A map containing the prepared filters

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