com.viaoa.object

Class OAObjectDelegate

java.lang.Object

com.viaoa.object.OAObjectDelegate

public class OAObjectDelegate
extends Object

This is the central Delegate class that performs services for OAObjects. The other Delegate classes are specialized for specific tasks. This Delegate is used for multi-specific and misc functionality. The Delegates are designed so that the OAObject class can be light weight and have various functionalities built in.

Author:

vincevia

Field Summary

Fields

Modifier and Type	Field and Description
protected static boolean	bFinalizeSave Flag to know if finalized objects should be automatically saved.
static Boolean	FALSE
protected static AtomicInteger	guidCounter global counter used for local objects.
protected static AtomicInteger	localGuidCounter global counter used for local objects.
static Boolean	TRUE
static String	WORD_AutoAdd
static String	WORD_Changed
static String	WORD_Deleted
static String	WORD_New

Constructor Summary

Constructors

Constructor and Description
OAObjectDelegate()

Method Summary

Modifier and Type	Method and Description
protected static void	assignGuid(OAObject obj)
protected static void	dontFinalize(OAObject obj) Used when there is a duplicate object created, so that it will not be finalized Called by OAObjectCacheDelegate.add(OAObject, ...) when an object already exists.
static void	finalizeObject(OAObject oaObj) Removes object from HubController and calls super.finalize().
protected static Object[]	find(OAObject base, String propertyPath, Object findValue, boolean bFindAll)
static boolean	getAutoAdd(OAObject oaObj)
static boolean	getChanged(OAObject oaObj, int changedRule) Returns true if this object is new or any changes have been made to this object or any objects in Links that are TYPE=MANY and CASCADE=true that match the relationshipType parameter.
static boolean	getChanged(OAObject oaObj, int iCascadeRule, OACascade cascade)
static int	getGuid(OAObject obj)
static int	getNextFiftyGuids()
static int	getNextGuid() Gets the next GUID for the current computer.
protected static void	initialize(OAObject oaObj) Called by OAObject constructor to assign guid and initialize new OAObject.
protected static void	initialize(OAObject oaObj, OAObjectInfo oi, boolean bInitializeNulls, boolean bInitializeWithDS, boolean bAddToCache, boolean bInitializeWithCS, boolean bSetChangedToFalse)
static void	reassignGuid(OAObject obj, OAObjectKey origKey) This is used by RemoteSyncImpl on the server, when it has to reload a GCd object from DS.
static void	recurse(OAObject oaObj, OACallback callback) Used to recursively get all reference objects below this one.
static void	recurse(OAObject oaObj, OACallback callback, OACascade cascade) see #recurse(OACallback)
protected static void	rehash(OAObject oaObj, OAObjectKey oldKey) Central method that is used when the object property Key is changed (OAObjectKey) and needs to be rehashed in all Hashtables that it could exist in.
static void	setAsNewObject(OAObject oaObj)
static void	setAsNewObject(OAObject oaObj, int guid)
static void	setAutoAdd(OAObject oaObj, boolean bEnabled) Used to determine if an object should be added to a reference/master hub when one of it's OAObject properties is set.
static void	setNew(OAObject oaObj, boolean b) Flag to know if object is new and has not been saved.
static void	setNextGuid(int x)
protected static void	updateGuid(int guid) Used when "reading" serialized objects.

Methods inherited from class java.lang.Object

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

Field Detail

WORD_New

public static final String WORD_New

See Also:

Constant Field Values

WORD_Changed

public static final String WORD_Changed

See Also:

Constant Field Values

WORD_Deleted

public static final String WORD_Deleted

See Also:

Constant Field Values

WORD_AutoAdd

public static final String WORD_AutoAdd

See Also:

Constant Field Values

TRUE

public static final Boolean TRUE

FALSE

public static final Boolean FALSE

guidCounter

protected static AtomicInteger guidCounter

global counter used for local objects. Value is positive

localGuidCounter

protected static AtomicInteger localGuidCounter

global counter used for local objects. Value is negative

bFinalizeSave

protected static boolean bFinalizeSave

Flag to know if finalized objects should be automatically saved. Default is false.

Constructor Detail

OAObjectDelegate

public OAObjectDelegate()

Method Detail

initialize

protected static void initialize(OAObject oaObj)

Called by OAObject constructor to assign guid and initialize new OAObject. If OAObjectFlagDelegate.isLoading() == false then initialize(...) will be called using the values from getOAObjectInfo()

initialize

protected static void initialize(OAObject oaObj,
                                 OAObjectInfo oi,
                                 boolean bInitializeNulls,
                                 boolean bInitializeWithDS,
                                 boolean bAddToCache,
                                 boolean bInitializeWithCS,
                                 boolean bSetChangedToFalse)

Parameters:

oaObj -

oi - if null, then the correct oi will be retrieved.

bInitializeNulls - set all primitive properties to null

bInitializeWithDS - will call OAObjectDSDelegateinitialize()

bAddToCache - if true then call OAObjectCacheDelegate.add()

bInitializeWithCS - if true, then call OAObjectCSDelegate.initialize().

setNew

public static void setNew(OAObject oaObj,
                          boolean b)

Flag to know if object is new and has not been saved.

assignGuid

protected static void assignGuid(OAObject obj)

setAsNewObject

public static void setAsNewObject(OAObject oaObj)

setAsNewObject

public static void setAsNewObject(OAObject oaObj,
                                  int guid)

reassignGuid

public static void reassignGuid(OAObject obj,
                                OAObjectKey origKey)

This is used by RemoteSyncImpl on the server, when it has to reload a GCd object from DS. This happens when a client makes a change and the server does not have the object in memory.

Parameters:

obj - newly loaded object from DS

origKey -

getNextGuid

public static int getNextGuid()

Gets the next GUID for the current computer. also called by OAObjectServerImpl.java

getNextFiftyGuids

public static int getNextFiftyGuids()

setNextGuid

public static void setNextGuid(int x)

dontFinalize

protected static void dontFinalize(OAObject obj)

Used when there is a duplicate object created, so that it will not be finalized Called by OAObjectCacheDelegate.add(OAObject, ...) when an object already exists.

updateGuid

protected static void updateGuid(int guid)

Used when "reading" serialized objects.

finalizeObject

public static void finalizeObject(OAObject oaObj)

Removes object from HubController and calls super.finalize().

getChanged

public static boolean getChanged(OAObject oaObj,
                                 int changedRule)

Returns true if this object is new or any changes have been made to this object or any objects in Links that are TYPE=MANY and CASCADE=true that match the relationshipType parameter.

getChanged

public static boolean getChanged(OAObject oaObj,
                                 int iCascadeRule,
                                 OACascade cascade)

recurse

public static void recurse(OAObject oaObj,
                           OACallback callback)

Used to recursively get all reference objects below this one. All objects will only be visited once.

recurse

public static void recurse(OAObject oaObj,
                           OACallback callback,
                           OACascade cascade)

see #recurse(OACallback)

find

protected static Object[] find(OAObject base,
                               String propertyPath,
                               Object findValue,
                               boolean bFindAll)

rehash

protected static void rehash(OAObject oaObj,
                             OAObjectKey oldKey)

Central method that is used when the object property Key is changed (OAObjectKey) and needs to be rehashed in all Hashtables that it could exist in.

Parameters:

oaObj -

oldKey -

getGuid

public static int getGuid(OAObject obj)

setAutoAdd

public static void setAutoAdd(OAObject oaObj,
                              boolean bEnabled)

Used to determine if an object should be added to a reference/master hub when one of it's OAObject properties is set. If false, then the object will not be added to masterHubs until this is called with "true" or when oaObj is saved.

Parameters:

oaObj -

bEnabled - (default is true)

getAutoAdd

public static boolean getAutoAdd(OAObject oaObj)