Package overit.geocallapp.wfm.accounts.bl.meter.task

Class BTMeterInsert

java.lang.Object

overit.geocall.bl.BusinessTask<MeterInsertEvent>

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

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

overit.geocallapp.wfm.accounts.bl.meter.task.BTMeterInsert

All Implemented Interfaces:

Serializable, Tool, ValidExecution

@Event(MeterInsertEvent.class)
public class BTMeterInsert
extends ValidPermissionBusinessTask<MeterInsertEvent>

Business task in order to insert a BOMeter.
When the MeterInsertEvent is launched the BT notices the call and inserts the BOMeter basing on the event's input.
Permission:

• AccountPermissions.ACCOUNT_VIEW

Error Code:

• Codes.PROPERTY_REQUIRED
• Codes.FIELDS_LENGTH
• Codes.MeterConverter.WRONG_METER_PRODUCTION_YEAR
• Codes.Meter.SERIAL_NUMBER_NOT_UNIQUE

Since:

16.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
BTMeterInsert()

Method Summary

Modifier and Type	Method	Description
protected void	execute(MeterInsertEvent event, PoolKit poolKit)	Inserts the given BOMeter and writes the newly generated id into the event journal..
protected Long	getNextMeterIndex(Long address, PoolKit poolKit)	Calculates the next available meter index for a given address.
boolean	isValidExecution()	Determines whether the current state is valid for execution.
protected void	validate(BOMeter meter, PoolKit poolKit)	Validates the input before the insertion.
protected void	validateModel(BOMeter meter)

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

BTMeterInsert

public BTMeterInsert()

Method Details

execute

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

Inserts the given BOMeter and writes the newly generated id into the event journal..

Specified by:

execute in class ValidExecutionBusinessTask<MeterInsertEvent>

Parameters:

event - the MeterInsertEvent

poolKit - the PoolKit

Throws:

DAException - the DA exception

DAValidateException - the DA validate exception

validate

protected void validate(BOMeter meter,
 PoolKit poolKit)
                 throws DAValidateException,
DAException

Validates the input before the insertion.

Parameters:

meter - the current BOMeter

poolKit - the PoolKit

Throws:

DAValidateException - the DA validate exception

DAException - the DA exception

getNextMeterIndex

protected Long getNextMeterIndex(Long address,
 PoolKit poolKit)
                          throws DAException,
DAValidateException

Calculates the next available meter index for a given address. This method searches for all meters associated with the specified address, finds the maximum index value among them, and returns the next available index (maximum + 1). If no meters exist or none have an index, returns 1.

Parameters:

address - the address ID to search meters for

poolKit - the PoolKit for database operations

Returns:

the next available meter index (max existing index + 1)

Throws:

DAException - if a data access error occurs

DAValidateException - if validation fails

validateModel

protected void validateModel(BOMeter meter)
                      throws DAValidateException

Throws:

DAValidateException

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