org.julp

Class AbstractDomainObject<T>

java.lang.Object

org.julp.AbstractDomainObject<T>

All Implemented Interfaces:

java.io.Serializable, DomainObject<T>

public abstract class AbstractDomainObject<T>
extends java.lang.Object
implements DomainObject<T>

Normally to make your object able to persist you need to extend this object If you can't or don't want to extend, just make your class implement org.julp.DomainObject interface and copy and paste members and methods from org.julp.AbstractDomainObject into your class. You don't need to copy toString() method. If you can't/don't want to extend then your classes will be enhanced by CGLIB/ASM

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	displayInternalMethods
protected java.util.Map<java.lang.String,java.lang.String>	displayValues
protected long	domainFactoryId
protected static java.lang.Object[]	EMPTY_ARG
protected boolean	enhanced
protected int	internalId
protected java.util.List<java.lang.String>	internalMethods Methods to skip while building toString()
protected boolean	loaded
protected boolean	loading
protected boolean	modified
protected DataHolder	originalValues
protected java.beans.PropertyChangeSupport	pcs
protected PersistentState	persistentState
protected java.lang.Object	uniqueId

Constructor Summary

Constructors

Constructor and Description
AbstractDomainObject()

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(java.beans.PropertyChangeListener listener)
boolean	create()
T	detach() See AbstractDomainObjectFactory.detach().
java.lang.Object	getDisplayValue(java.lang.String fieldName)
java.util.Map<java.lang.String,java.lang.String>	getDisplayValues()
long	getDomainFactoryId()
int	getInternalId() Getter for property internalId.
java.util.List<java.lang.String>	getInternalMethods()
java.lang.Object	getOriginalValue(java.lang.String fieldName)
DataHolder	getOriginalValues()
PersistentState	getPersistentState()
java.beans.PropertyChangeSupport	getPropertyChangeSupport()
<UID> UID	getUniqueId()
boolean	isDisplayInternalMethods()
boolean	isEnhanced()
boolean	isLoaded() Getter for property loaded.
boolean	isLoading() Indicator that this object in process of loading with values from database
boolean	isModified() Indicator that this object is modified.
boolean	load() Populate DomainObject with values from originalValues
protected java.lang.Object	readValue(java.lang.reflect.Method method)
void	reattach(T instance) Use case scenario using this method: 1.
boolean	remove()
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener)
void	reset() Make an object "brand-new", however live values intact
void	setDisplayInternalMethods(boolean displayInternalMethods)
void	setDisplayValue(java.lang.String field, java.lang.String displayValue) Display value for given field.
void	setDisplayValues(java.util.Map<java.lang.String,java.lang.String> displayValues)
void	setDomainFactoryId(long domainFactoryId)
void	setEnhanced(boolean enhanced)
void	setInternalId(int internalId) Every time DomainObjectFactory is loaded this object is assigned internalId which is valid only for the same DomainObjectFactory (see domainFactoryId) if DomainObject used with other DomainObjectFactory it gets new internalId when used with DomainObjectFactory.[setObject(...), load(), create(), store(), remove()]
void	setInternalMethods(java.util.List<java.lang.String> internalMethods)
void	setLoaded(boolean loaded) Setter for property loaded.
void	setLoading(boolean loading)
void	setModified(boolean modified)
void	setOriginalValue(java.lang.String fieldName, java.lang.Object value)
void	setOriginalValues(DataHolder originalValues)
void	setPersistentState(PersistentState persistentState)
<UID> void	setUniqueId(UID uid)
boolean	store() Just a mark for data modification, actual modification done in DomainObjectFactory and DataWriter normally this methods called from DomainObjectFactory.[create(DomainObject), store(DomainObject), remove(DomainObject)]
boolean	syncOriginal() Populate originalValues with values from DomainObject
java.lang.String	toString()
protected void	writeValue(java.lang.reflect.Method method, java.lang.Object[] value)

Methods inherited from class java.lang.Object

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

Field Detail

originalValues

protected DataHolder originalValues

internalId

protected int internalId

persistentState

protected PersistentState persistentState

loaded

protected boolean loaded

loading

protected boolean loading

modified

protected boolean modified

displayValues

protected java.util.Map<java.lang.String,java.lang.String> displayValues

EMPTY_ARG

protected static final java.lang.Object[] EMPTY_ARG

domainFactoryId

protected long domainFactoryId

pcs

protected java.beans.PropertyChangeSupport pcs

displayInternalMethods

protected boolean displayInternalMethods

enhanced

protected boolean enhanced

internalMethods

protected java.util.List<java.lang.String> internalMethods

Methods to skip while building toString()

uniqueId

protected java.lang.Object uniqueId

Constructor Detail

AbstractDomainObject

public AbstractDomainObject()

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

setOriginalValues

public void setOriginalValues(DataHolder originalValues)

Specified by:

setOriginalValues in interface DomainObject<T>

getOriginalValues

public DataHolder getOriginalValues()

Specified by:

getOriginalValues in interface DomainObject<T>

setOriginalValue

public void setOriginalValue(java.lang.String fieldName,
                             java.lang.Object value)

Specified by:

setOriginalValue in interface DomainObject<T>

getOriginalValue

public java.lang.Object getOriginalValue(java.lang.String fieldName)

Specified by:

getOriginalValue in interface DomainObject<T>

getPersistentState

public PersistentState getPersistentState()

Specified by:

getPersistentState in interface DomainObject<T>

setPersistentState

public void setPersistentState(PersistentState persistentState)

Specified by:

setPersistentState in interface DomainObject<T>

getInternalId

public int getInternalId()

Getter for property internalId.

Specified by:

getInternalId in interface DomainObject<T>

Returns:

Value of property internalId.

setInternalId

public void setInternalId(int internalId)

Every time DomainObjectFactory is loaded this object is assigned internalId which is valid only for the same DomainObjectFactory (see domainFactoryId) if DomainObject used with other DomainObjectFactory it gets new internalId when used with DomainObjectFactory.[setObject(...), load(), create(), store(), remove()]

Specified by:

setInternalId in interface DomainObject<T>

store

public boolean store()

Just a mark for data modification, actual modification done in DomainObjectFactory and DataWriter normally this methods called from DomainObjectFactory.[create(DomainObject), store(DomainObject), remove(DomainObject)]

Specified by:

store in interface DomainObject<T>

remove

public boolean remove()

Specified by:

remove in interface DomainObject<T>

create

public boolean create()

Specified by:

create in interface DomainObject<T>

syncOriginal

public boolean syncOriginal()

Populate originalValues with values from DomainObject

Specified by:

syncOriginal in interface DomainObject<T>

load

public boolean load()

Populate DomainObject with values from originalValues

Specified by:

load in interface DomainObject<T>

isLoaded

public boolean isLoaded()

Getter for property loaded.

Specified by:

isLoaded in interface DomainObject<T>

Returns:

Value of property loaded.

setLoaded

public void setLoaded(boolean loaded)

Setter for property loaded.

Specified by:

setLoaded in interface DomainObject<T>

Parameters:

loaded - New value of property loaded.

isLoading

public boolean isLoading()

Indicator that this object in process of loading with values from database

Specified by:

isLoading in interface DomainObject<T>

setLoading

public void setLoading(boolean loading)

Specified by:

setLoading in interface DomainObject<T>

isModified

public boolean isModified()

Indicator that this object is modified. You have to call it yourself unless your objects enhanced by CGLIB/ASM

Specified by:

isModified in interface DomainObject<T>

setModified

public void setModified(boolean modified)

Specified by:

setModified in interface DomainObject<T>

setDisplayValue

public void setDisplayValue(java.lang.String field,
                            java.lang.String displayValue)

Display value for given field. Example: field value is "123" but display must be "XYZ"

Specified by:

setDisplayValue in interface DomainObject<T>

getDisplayValue

public java.lang.Object getDisplayValue(java.lang.String fieldName)

Specified by:

getDisplayValue in interface DomainObject<T>

setDomainFactoryId

public void setDomainFactoryId(long domainFactoryId)

Specified by:

setDomainFactoryId in interface DomainObject<T>

getDomainFactoryId

public long getDomainFactoryId()

Specified by:

getDomainFactoryId in interface DomainObject<T>

writeValue

protected void writeValue(java.lang.reflect.Method method,
                          java.lang.Object[] value)
                   throws java.lang.Throwable

Throws:

java.lang.Throwable

readValue

protected java.lang.Object readValue(java.lang.reflect.Method method)
                              throws java.lang.Throwable

Throws:

java.lang.Throwable

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Specified by:

addPropertyChangeListener in interface DomainObject<T>

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

Specified by:

removePropertyChangeListener in interface DomainObject<T>

getPropertyChangeSupport

public java.beans.PropertyChangeSupport getPropertyChangeSupport()

Specified by:

getPropertyChangeSupport in interface DomainObject<T>

reset

public void reset()

Make an object "brand-new", however live values intact

Specified by:

reset in interface DomainObject<T>

getDisplayValues

public java.util.Map<java.lang.String,java.lang.String> getDisplayValues()

Specified by:

getDisplayValues in interface DomainObject<T>

setDisplayValues

public void setDisplayValues(java.util.Map<java.lang.String,java.lang.String> displayValues)

Specified by:

setDisplayValues in interface DomainObject<T>

isDisplayInternalMethods

public boolean isDisplayInternalMethods()

Specified by:

isDisplayInternalMethods in interface DomainObject<T>

setDisplayInternalMethods

public void setDisplayInternalMethods(boolean displayInternalMethods)

Specified by:

setDisplayInternalMethods in interface DomainObject<T>

getInternalMethods

public java.util.List<java.lang.String> getInternalMethods()

Specified by:

getInternalMethods in interface DomainObject<T>

setInternalMethods

public void setInternalMethods(java.util.List<java.lang.String> internalMethods)

Specified by:

setInternalMethods in interface DomainObject<T>

reattach

public void reattach(T instance)

Use case scenario using this method: 1. Detach instance 2. Send it to another JVM 3. Modify instance there 5. Send it back 8. Re-attach and call DomainObjectFactory.writeData() 9. UPDATE statement will be generated/executed The instance is in CGLibInstantiator.DomainObjectInterceptor.

Specified by:

reattach in interface DomainObject<T>

detach

public T detach()

See AbstractDomainObjectFactory.detach(). The instance is in CGLibInstantiator.DomainObjectInterceptor and this is just a placeholder

Specified by:

detach in interface DomainObject<T>

getUniqueId

public <UID> UID getUniqueId()

Specified by:

getUniqueId in interface DomainObject<T>

setUniqueId

public <UID> void setUniqueId(UID uid)

Specified by:

setUniqueId in interface DomainObject<T>

setEnhanced

public void setEnhanced(boolean enhanced)

Specified by:

setEnhanced in interface DomainObject<T>

isEnhanced

public boolean isEnhanced()

Specified by:

isEnhanced in interface DomainObject<T>