Package com.aquima.interactions.framework.service.instance

Class InstanceUpdateService

java.lang.Object

com.aquima.interactions.framework.service.instance.InstanceServiceBase

com.aquima.interactions.framework.service.instance.InstanceUpdateService

All Implemented Interfaces:

ICacheableParametersObjectService<InstanceUpdateParameters>, IService

public class InstanceUpdateService
extends InstanceServiceBase
implements ICacheableParametersObjectService<InstanceUpdateParameters>

AQ_Instance_Update implementation.

It is responsible for the following:

Searches for one or more IEntityInstance of type InstanceServiceParameters.getEntityName();

• If InstanceUpdateParameters.getEntitySelector() is empty and the entity type is defined as singleton, tries to get the singleton instance. Throws a ServiceException if the definition is not found.
• If InstanceUpdateParameters.getEntitySelector() is empty and the entity type is not defined as singleton, tries to get the active instance of the specified type. Throws a ServiceException if not found.
• Otherwise evaluates InstanceUpdateParameters.getEntitySelector() as an expression an applies the algorithm for each returned instance.

• If InstanceUpdateParameters.shouldClearBeforeExecute() is true it will clear the instances for before settings the updated values.
• When the InstanceServiceParameters.getAttributeRelations() is empty it takes the InstanceServiceParameters.getAttributes() List and sets each attribute to the entity instance.
• When the InstanceServiceParameters.getAttributeRelations() is empty it takes the InstanceServiceParameters.getRelations() List and sets each relation to the entity instance.

Since:

9.6

Author:

Radu Batori

Field Summary

Fields

Modifier and Type	Field	Description
static final String	NAME

Constructor Summary

Constructors

Constructor	Description
InstanceUpdateService()

Method Summary

Modifier and Type	Method	Description
protected Logger	getLogger()
protected String	getName()
InstanceUpdateParameters	getParametersObject(IServiceContext context)	Parse the parameters into a cacheable object.
IServiceResult	handle(IServiceContext context)	The handle method of the service is allowed to make changes to the interfaces passed along with the IServiceContext.
IServiceResult	handle(IServiceContext context, InstanceUpdateParameters parameters)	The handle method of the service is allowed to make changes to the interfaces passed along with the IServiceContext.

Methods inherited from class com.aquima.interactions.framework.service.instance.InstanceServiceBase

getServiceNameLogPrefix, setAttributeRelations, setAttributes, setRelations

Methods inherited from class java.lang.Object

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

Field Details

NAME

public static final String NAME

See Also:

• Constant Field Values

Constructor Details

InstanceUpdateService

public InstanceUpdateService()

Method Details

handle

public IServiceResult handle(IServiceContext context)
                      throws Exception

Description copied from interface: IService

The handle method of the service is allowed to make changes to the interfaces passed along with the IServiceContext. This means the service context is changed accordingly.

Specified by:

handle in interface IService

Parameters:

context - the context in which the service is called and allowed to make changes.

Returns:

The result of this service, may be null.

Throws:

Exception - When an unexpected exception occurs and the portal should display a standard message.

handle

public IServiceResult handle(IServiceContext context,
 InstanceUpdateParameters parameters)

Description copied from interface: ICacheableParametersObjectService

The handle method of the service is allowed to make changes to the interfaces passed along with the IServiceContext. This means the service context is changed accordingly.

Specified by:

handle in interface ICacheableParametersObjectService<InstanceUpdateParameters>

Parameters:

context - the context in which the service is called and allowed to make changes.

parameters - cached object that contain parameters

Returns:

The result of this service, may be null.

getParametersObject

public InstanceUpdateParameters getParametersObject(IServiceContext context)

Description copied from interface: ICacheableParametersObjectService

Parse the parameters into a cacheable object. Do NOT parse expressions as these can change in other invocations of the handle

Specified by:

getParametersObject in interface ICacheableParametersObjectService<InstanceUpdateParameters>

Parameters:

context - the context in which the service is called and allowed to make changes.

Returns:

a cacheable object that is not null

getLogger

protected Logger getLogger()

Specified by:

getLogger in class InstanceServiceBase

Returns:

The Logger instance for the subclass.

getName

protected String getName()

Specified by:

getName in class InstanceServiceBase