com.ontimize.db

Class LocalEntityInvocationHandler

java.lang.Object

com.ontimize.db.LocalEntityInvocationHandler

All Implemented Interfaces:

DynamicMemoryEntity, Entity, InvocationHandler, Remote

public class LocalEntityInvocationHandler
extends Object
implements InvocationHandler, Entity, DynamicMemoryEntity

Field Summary

Fields

Modifier and Type	Field and Description
protected EntityResult	cacheData
protected Hashtable<String,Object>	entityMetadata
protected String	entityName
protected EntityReferenceLocator	locator

Constructor Summary

Constructors

Constructor and Description
LocalEntityInvocationHandler(EntityReferenceLocator locator, String entityName)

Method Summary

Methods

Modifier and Type	Method and Description
void	checkInsertKeys(Hashtable attributesValues) Checks if attributesValues contains a value for all columns defined in 'insert_keys' parameter.
void	clear()
EntityResult	delete(Hashtable keysValues, int sessionId) This method must implement a standard delete operation over the set of records defined by keysValues.
protected String	getAutonumerical()
protected List<String>	getGeneratedKeyList()
EntityResult	insert(Hashtable attributesValues, int sessionId) This method must implement a standard insert operation with the data contained in attributesValues parameter.
Object	invoke(Object proxy, Method method, Object[] args)
EntityResult	query(Hashtable keysValues, Vector attributes, int sessionId) This method must implement a standard query operation returning the set of data that matches the conditions specified by the keysValues parameter.
void	setValue(EntityResult data)
EntityResult	update(Hashtable attributesValues, Hashtable keysValues, int sessionId) This method must implement a standard update operation with the data specified in attributesValues over the set of records defined by keysValues.

Methods inherited from class java.lang.Object

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

Field Detail

entityName

protected String entityName

locator

protected EntityReferenceLocator locator

entityMetadata

protected Hashtable<String,Object> entityMetadata

cacheData

protected EntityResult cacheData

Constructor Detail

LocalEntityInvocationHandler

public LocalEntityInvocationHandler(EntityReferenceLocator locator,
                            String entityName)

Method Detail

invoke

public Object invoke(Object proxy,
            Method method,
            Object[] args)
              throws Throwable

Specified by:

invoke in interface InvocationHandler

Throws:

Throwable

insert

public EntityResult insert(Hashtable attributesValues,
                  int sessionId)
                    throws Exception

Description copied from interface: Entity

This method must implement a standard insert operation with the data contained in attributesValues parameter.

Specified by:

insert in interface Entity

Parameters:

attributesValues - a Hashtable specifying pairs of key-value corresponding to the attribute (or column of a table in a database) and the value that must be stored.

sessionId - a integer identifying the user or session that performs the action.

Returns:

a EntityResult. This result will have an error code if error has ocurred.

Throws:

Exception - if any exception occurs

update

public EntityResult update(Hashtable attributesValues,
                  Hashtable keysValues,
                  int sessionId)
                    throws Exception

Description copied from interface: Entity

This method must implement a standard update operation with the data specified in attributesValues over the set of records defined by keysValues. So, only the records that comply with the conditions specified by keysValues will be updated to the new values specified by attributesValues.

Specified by:

update in interface Entity

Parameters:

attributesValues - the data for updating the records to. The keys specify the attributes (or columns) and the values, the values for these columns.

keysValues - the conditions that the records to be updated must fulfill. The keys specify the attributes (or columns) and the values, the values for these columns.

sessionId - a integer identifying the user or session that performs the action.

Returns:

a EntityResult. This result will have an error code if error has occurred.

Throws:

Exception - if any exception occurs

query

public EntityResult query(Hashtable keysValues,
                 Vector attributes,
                 int sessionId)
                   throws Exception

Description copied from interface: Entity

This method must implement a standard query operation returning the set of data that matches the conditions specified by the keysValues parameter. The attributes defines which attributes (or columns if data is obtained from a database) must be recovered, and keysValues specifies which set of records must be recovered.

Specified by:

query in interface Entity

Parameters:

keysValues - a Hashtable specifying conditions that must comply the set of records returned. Cannot be null.

attributes - a list of columns or attributes that must be recovered for each record returned. Cannot be null. If empty, all attributes should be returned.

sessionId - a integer identifying the user or session that performs the action.

Returns:

a EntityResult with the resulting set of data. This result can be empty if no results exist, and if an error has ocurred this will be indicated in the result.

Throws:

Exception - if any exception occurs

checkInsertKeys

public void checkInsertKeys(Hashtable attributesValues)
                     throws Exception

Checks if attributesValues contains a value for all columns defined in 'insert_keys' parameter.

Parameters:

attributesValues -

Throws:

Exception - if any of the columns defined in 'insert_keys' is not found as key in attributesValues

getAutonumerical

protected String getAutonumerical()

getGeneratedKeyList

protected List<String> getGeneratedKeyList()

delete

public EntityResult delete(Hashtable keysValues,
                  int sessionId)
                    throws Exception

Description copied from interface: Entity

This method must implement a standard delete operation over the set of records defined by keysValues. So, only the records that comply with the conditions specified by keysValues will be deleted.

Specified by:

delete in interface Entity

Parameters:

keysValues - the conditions that the records to be deleted must fulfill. The keys specify the attributes (or columns) and the values, the values for these columns.

sessionId - a integer identifying the user or session that performs the action.

Returns:

a EntityResult. This result will have an error code if error has occurred.

Throws:

Exception - if any exception occurs

setValue

public void setValue(EntityResult data)

Specified by:

setValue in interface DynamicMemoryEntity

clear

public void clear()

Specified by:

clear in interface DynamicMemoryEntity