org.granite.client.tide.data.spi

Interface DataManager

All Known Implementing Classes:

AbstractDataManager, JavaBeanDataManager

public interface DataManager

SPI for integrating with different types of data objects (javabeans, javafx bindable beans, ...)

Author:

William DRAI

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DataManager.ChangeKind Kinds of changes for collections and maps
static interface	DataManager.TrackingHandler Callback interface for objects that need to be notified when modifications are made on managed entities
static class	DataManager.TrackingType Types of tracked events

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() Reset all currently tracked objects
void	copyProxyState(java.lang.Object target, java.lang.Object source) Copy the proxy state (fields __initialized__ and __detachedState__) from source to target
void	copyUid(java.lang.Object target, java.lang.Object source) Copy the uid field (annotated with Uid) from source to target
boolean	defineProxy(java.lang.Object target, java.lang.Object source) Define the target object as a proxy for the source entity
java.lang.String	getCacheKey(java.lang.Object entity) Return a unique key for the entity to be used in a local cache
java.lang.String	getDetachedState(java.lang.Object entity) Return the persistent detached state of an entity (private field name __detachedState__)
java.lang.Object	getId(java.lang.Object entity) Return the persistent id of an entity (field annotated with Id) ?
java.lang.String	getIdPropertyName(java.lang.Object entity) Name of the id field for the entity
java.lang.Object	getPropertyValue(java.lang.Object entity, java.lang.String name) Return the value of the property for the specified entity instance
java.util.Map<java.lang.String,java.lang.Object>	getPropertyValues(java.lang.Object entity, boolean excludeVersion, boolean includeReadOnly) Return a map of property values for the specified entity instance
java.util.Map<java.lang.String,java.lang.Object>	getPropertyValues(java.lang.Object entity, boolean excludeIdUid, boolean excludeVersion, boolean includeReadOnly) Return a map of property values for the specified entity instance
java.lang.String	getUid(java.lang.Object entity) Get the uid field (annotated with Uid) for the entity Note that the data manager implementation is allowed to generate a reasonable uid value from other fields if no uid field is present
java.lang.String	getUidPropertyName(java.lang.Object entity) Name of the uid field for the entity
java.lang.Object	getVersion(java.lang.Object entity) Return the version (field annotated with Version) for an entity
java.lang.String	getVersionPropertyName(java.lang.Object entity) Name of the version field for the entity
boolean	hasIdProperty(java.lang.Object entity) Has the entity an id field ?
boolean	hasProperty(java.lang.Object entity, java.lang.String name) Return the value of the property for the specified entity instance
boolean	hasVersionProperty(java.lang.Object entity) Has the entity a version field (annotated with Version) ?
void	initProxy(java.lang.Object dest, java.lang.Object id, boolean initialized, java.lang.String detachedState) Init state of a proxy object
boolean	isDeepDirtyEntity(java.lang.Object entity) Is the entity graph dirty (any object in the graph of this entity has been modified since last received from server) ?
boolean	isDirty() Is the data manager dirty (any managed entity instance has been modified since last received from server) ?
boolean	isDirtyEntity(java.lang.Object entity) Is the entity instance dirty (modified since last received from server) ?
boolean	isEntity(java.lang.Object object) Is the object an entity (i.e. annotated with Entity) ?
boolean	isInitialized(java.lang.Object entity) Is the entity initialized (field __initialized__ true) ?
boolean	isLazyProperty(java.lang.Object entity, java.lang.String name) Is the specified property lazy ?
<T> T	newInstance(java.lang.Object source, java.lang.Class<T> cast) Create an empty instance of the same class as the source
void	notifyDirtyChange(boolean oldDirty, boolean dirty) Notify listeners that the dirty state of this data manager has changed Called by dirty checking
void	notifyEntityDirtyChange(java.lang.Object entity, boolean oldDirtyEntity, boolean newDirtyEntity) Notify listeners that the dirty state of the specified has changed
void	setLazyProperty(java.lang.Object entity, java.lang.String name) Define a property as lazy
void	setPropertyValue(java.lang.Object entity, java.lang.String name, java.lang.Object value) Set the value of the property for the specified entity instance
void	setTrackingHandler(DataManager.TrackingHandler trackingHandler) Register a handler that will be notified when any managed entity is modified
void	startTracking(java.lang.Object previous, java.lang.Object parent) Start tracking for the specified object / parent
void	stopTracking(java.lang.Object previous, java.lang.Object parent) Stop tracking for the specified object / parent

Method Detail

isEntity

boolean isEntity(java.lang.Object object)

Is the object an entity (i.e. annotated with Entity) ?

Parameters:

object - object

Returns:

true if entity

getId

java.lang.Object getId(java.lang.Object entity)

Return the persistent id of an entity (field annotated with Id) ?

Parameters:

entity - object

Returns:

id if field found, error if no id field

hasIdProperty

boolean hasIdProperty(java.lang.Object entity)

Has the entity an id field ?

Parameters:

entity - object

Returns:

true if id field found

getIdPropertyName

java.lang.String getIdPropertyName(java.lang.Object entity)

Name of the id field for the entity

Parameters:

entity - object

Returns:

property name or null if not found

getDetachedState

java.lang.String getDetachedState(java.lang.Object entity)

Return the persistent detached state of an entity (private field name __detachedState__)

Parameters:

entity - object

Returns:

detached state if field found, error if field not found

initProxy

void initProxy(java.lang.Object dest,
             java.lang.Object id,
             boolean initialized,
             java.lang.String detachedState)

Init state of a proxy object

Parameters:

dest - proxy object

id - proxy id

initialized - is initialized

detachedState - detached state

defineProxy

boolean defineProxy(java.lang.Object target,
                  java.lang.Object source)

Define the target object as a proxy for the source entity

Parameters:

target - target object

source - source entity

Returns:

true if proxy was setup, false if source was not an entity or did not have any detached state

copyProxyState

void copyProxyState(java.lang.Object target,
                  java.lang.Object source)

Copy the proxy state (fields __initialized__ and __detachedState__) from source to target

Parameters:

target - target object

source - source entity

copyUid

void copyUid(java.lang.Object target,
           java.lang.Object source)

Copy the uid field (annotated with Uid) from source to target

Parameters:

target - target object

source - source entity

getVersion

java.lang.Object getVersion(java.lang.Object entity)

Return the version (field annotated with Version) for an entity

Parameters:

entity - entity

Returns:

version or error if no version field found

hasVersionProperty

boolean hasVersionProperty(java.lang.Object entity)

Has the entity a version field (annotated with Version) ?

Parameters:

entity - object

Returns:

true if version field found

getVersionPropertyName

java.lang.String getVersionPropertyName(java.lang.Object entity)

Name of the version field for the entity

Parameters:

entity - object

Returns:

property name or null if not found

getUid

java.lang.String getUid(java.lang.Object entity)

Get the uid field (annotated with Uid) for the entity Note that the data manager implementation is allowed to generate a reasonable uid value from other fields if no uid field is present

Parameters:

entity - object

Returns:

uid or error if uid could not be generated

getUidPropertyName

java.lang.String getUidPropertyName(java.lang.Object entity)

Name of the uid field for the entity

Parameters:

entity - object

Returns:

property name or null if not found

hasProperty

boolean hasProperty(java.lang.Object entity,
                  java.lang.String name)

Return the value of the property for the specified entity instance

Parameters:

entity - object instance

name - property name

Returns:

property exists

getPropertyValues

java.util.Map<java.lang.String,java.lang.Object> getPropertyValues(java.lang.Object entity,
                                                                 boolean excludeIdUid,
                                                                 boolean excludeVersion,
                                                                 boolean includeReadOnly)

Return a map of property values for the specified entity instance

Parameters:

entity - object instance

excludeIdUid - true to exclude id and uid fields from the map

excludeVersion - true to exclude version field from the map

includeReadOnly - true to include readonly fields in the map

Returns:

a map of values keyed by property names

getPropertyValues

java.util.Map<java.lang.String,java.lang.Object> getPropertyValues(java.lang.Object entity,
                                                                 boolean excludeVersion,
                                                                 boolean includeReadOnly)

Return a map of property values for the specified entity instance

Parameters:

entity - object instance

excludeVersion - true to exclude version field from the map

includeReadOnly - true to include readonly fields in the map

Returns:

a map of values keyed by property names

getPropertyValue

java.lang.Object getPropertyValue(java.lang.Object entity,
                                java.lang.String name)

Return the value of the property for the specified entity instance

Parameters:

entity - object instance

name - property name

Returns:

property value

setPropertyValue

void setPropertyValue(java.lang.Object entity,
                    java.lang.String name,
                    java.lang.Object value)

Set the value of the property for the specified entity instance

Parameters:

entity - object instance

name - property name

value - property value

isLazyProperty

boolean isLazyProperty(java.lang.Object entity,
                     java.lang.String name)

Is the specified property lazy ? A property is considered lazy if it is annotated with Lazy or if the server has returned an initialized value

Parameters:

entity - entity instance

name - property name

Returns:

true if property defined as lazy

setLazyProperty

void setLazyProperty(java.lang.Object entity,
                   java.lang.String name)

Define a property as lazy

Parameters:

entity - entity instance

name - property name

getCacheKey

java.lang.String getCacheKey(java.lang.Object entity)

Return a unique key for the entity to be used in a local cache

Parameters:

entity - entity instance

Returns:

unique key

isInitialized

boolean isInitialized(java.lang.Object entity)

Is the entity initialized (field __initialized__ true) ?

Parameters:

entity - entity instance

Returns:

true if initialized

isDirty

boolean isDirty()

Is the data manager dirty (any managed entity instance has been modified since last received from server) ?

Returns:

true if modified

isDirtyEntity

boolean isDirtyEntity(java.lang.Object entity)

Is the entity instance dirty (modified since last received from server) ?

Returns:

true if modified

isDeepDirtyEntity

boolean isDeepDirtyEntity(java.lang.Object entity)

Is the entity graph dirty (any object in the graph of this entity has been modified since last received from server) ?

Returns:

true if modified

newInstance

<T> T newInstance(java.lang.Object source,
                java.lang.Class<T> cast)
              throws java.lang.IllegalAccessException,
                     java.lang.InstantiationException

Create an empty instance of the same class as the source

Type Parameters:

T - expected type

Parameters:

source - source object

cast - expected type

Returns:

new empty instance

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException

setTrackingHandler

void setTrackingHandler(DataManager.TrackingHandler trackingHandler)

Register a handler that will be notified when any managed entity is modified

Parameters:

trackingHandler - tracking handler

startTracking

void startTracking(java.lang.Object previous,
                 java.lang.Object parent)

Start tracking for the specified object / parent

Parameters:

previous - previously existing object in the entity manager cache (null if no existing object)

parent - parent object for collections

stopTracking

void stopTracking(java.lang.Object previous,
                java.lang.Object parent)

Stop tracking for the specified object / parent

Parameters:

previous - previously existing object in the entity manager cache (null if no existing object)

parent - parent object for collections

clear

void clear()

Reset all currently tracked objects

notifyDirtyChange

void notifyDirtyChange(boolean oldDirty,
                     boolean dirty)

Notify listeners that the dirty state of this data manager has changed Called by dirty checking

Parameters:

oldDirty - old value

dirty - new value

See Also:

DirtyCheckContext

notifyEntityDirtyChange

void notifyEntityDirtyChange(java.lang.Object entity,
                           boolean oldDirtyEntity,
                           boolean newDirtyEntity)

Notify listeners that the dirty state of the specified has changed

Parameters:

entity - entity instance

oldDirtyEntity - old value

newDirtyEntity - new value

See Also:

DirtyCheckContext