com.viaoa.object

Class OAObjectPropertyDelegate

java.lang.Object

com.viaoa.object.OAObjectPropertyDelegate

public class OAObjectPropertyDelegate
extends Object

Manages OAObject.properties, which are used to store references (OAObjects, Hubs, OAObjectKey) and misc values. Stores as name/value in a flat object array, where even positions are property names and odd positions are the value, which can be null. This uses a flat array to make it as efficient as possible for the oaObject with as little overhead as possible.

Constructor Summary

Constructors

Constructor and Description
OAObjectPropertyDelegate()

Method Summary

Modifier and Type	Method and Description
static boolean	attemptPropertyLock(OAObject oaObj, String name)
static void	clearProperties(OAObject oaObj)
static Object	getProperty(OAObject oaObj, String name)
static Object	getProperty(OAObject oaObj, String name, boolean bReturnNotExist, boolean bConvertWeakRef)
static String[]	getPropertyNames(OAObject oaObj)
static boolean	isPropertyLoaded(OAObject oaObj, String name)
static boolean	isPropertyLocked(OAObject oaObj, String name)
static boolean	isReferenceNull(OAObject oaObj, String name) check to see if property does or will exist (if it is oaObjKey).
static void	releasePropertyLock(OAObject oaObj, String name)
static void	removeProperty(OAObject oaObj, String name, boolean bFirePropertyChange)
static boolean	removePropertyIfNull(OAObject oaObj, String name, boolean bFirePropertyChange)
static void	setProperty(OAObject oaObj, String name, Object value)
static Object	setPropertyCAS(OAObject oaObj, String name, Object newValue, Object matchValue)
static Object	setPropertyCAS(OAObject oaObj, String name, Object newValue, Object matchValue, boolean bMustNotExist, boolean bReturnNotExist) Compare and swap a property.
static void	setPropertyHubIfNotSet(OAObject oaObj, String name, Object value)
static boolean	setPropertyLock(OAObject oaObj, String name)
static boolean	setPropertyWeakRef(OAObject oaObj, String name, boolean bToWeakRef, Object value)
static void	setReferenceable(OAObject obj, boolean bReferenceable) Used on server, this will make sure that a Hub does not get GCd on the Server.
static void	unsafeSetProperty(OAObject oaObj, String name, Object value)

Methods inherited from class java.lang.Object

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

Constructor Detail

OAObjectPropertyDelegate

public OAObjectPropertyDelegate()

Method Detail

isPropertyLoaded

public static boolean isPropertyLoaded(OAObject oaObj,
                                       String name)

Returns:

true if prop is loaded, and does not need to be loaded from datasource, or from server (if this is client)

isReferenceNull

public static boolean isReferenceNull(OAObject oaObj,
                                      String name)

check to see if property does or will exist (if it is oaObjKey).

Returns:

getPropertyNames

public static String[] getPropertyNames(OAObject oaObj)

unsafeSetProperty

public static void unsafeSetProperty(OAObject oaObj,
                                     String name,
                                     Object value)

removeProperty

public static void removeProperty(OAObject oaObj,
                                  String name,
                                  boolean bFirePropertyChange)

removePropertyIfNull

public static boolean removePropertyIfNull(OAObject oaObj,
                                           String name,
                                           boolean bFirePropertyChange)

setProperty

public static void setProperty(OAObject oaObj,
                               String name,
                               Object value)

setPropertyHubIfNotSet

public static void setPropertyHubIfNotSet(OAObject oaObj,
                                          String name,
                                          Object value)

setPropertyCAS

public static Object setPropertyCAS(OAObject oaObj,
                                    String name,
                                    Object newValue,
                                    Object matchValue)

setPropertyCAS

public static Object setPropertyCAS(OAObject oaObj,
                                    String name,
                                    Object newValue,
                                    Object matchValue,
                                    boolean bMustNotExist,
                                    boolean bReturnNotExist)

Compare and swap a property.

Parameters:

name - property name, not case sensitive

newValue - new value to set, if matchValue matches current setting

matchValue - value that it must currently be set to

bMustNotExist - only update if there is not a current value

bReturnNotExist - if true, then return OANotExist.instance if value does not match and the current value does not exist.

Returns:

value that is stored. If the matchValue is not the same as current, then the current value will be returned, else the newValue will be returned.

getProperty

public static Object getProperty(OAObject oaObj,
                                 String name)

getProperty

public static Object getProperty(OAObject oaObj,
                                 String name,
                                 boolean bReturnNotExist,
                                 boolean bConvertWeakRef)

Parameters:

oaObj -

name - name to find, not case sensitive

bReturnNotExist - if true and the property name does not exist or it's value has not been loaded, then OANotExist.instance

bConvertWeakRef - if true and the value is a WeakReference, then it's value will be checked and returned. is returned.

setPropertyLock

public static boolean setPropertyLock(OAObject oaObj,
                                      String name)

attemptPropertyLock

public static boolean attemptPropertyLock(OAObject oaObj,
                                          String name)

releasePropertyLock

public static void releasePropertyLock(OAObject oaObj,
                                       String name)

isPropertyLocked

public static boolean isPropertyLocked(OAObject oaObj,
                                       String name)

setPropertyWeakRef

public static boolean setPropertyWeakRef(OAObject oaObj,
                                         String name,
                                         boolean bToWeakRef,
                                         Object value)

setReferenceable

public static void setReferenceable(OAObject obj,
                                    boolean bReferenceable)

Used on server, this will make sure that a Hub does not get GCd on the Server. This is needed when a hub has a masterObject that has a cacheSize set, which means that it can be GCd. This will recursively set any parent/master objects. This is called by Hub.add, Hub.remove, Hub.firepropchange(), Hub.saveAll.

Parameters:

bReferenceable - true to make sure that it has a hard ref, otherwise a weakRef will be used

clearProperties

public static void clearProperties(OAObject oaObj)