com.haulmont.chile.core.model.impl

Class AbstractInstance

java.lang.Object

com.haulmont.chile.core.model.impl.AbstractInstance

All Implemented Interfaces:

Instance, java.io.Serializable

Direct Known Subclasses:

AbstractNotPersistentEntity, AbstractPermissionTarget, AttributeTarget, BaseGenericIdEntity, EmbeddableEntity, KeyValueEntity

public abstract class AbstractInstance
extends java.lang.Object
implements Instance

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.haulmont.chile.core.model.Instance

Instance.PropertyChangeEvent, Instance.PropertyChangeListener

Constructor Summary

Constructors

Constructor and Description
AbstractInstance()

Method Summary

Modifier and Type	Method and Description
void	addListener(ValueListener listener) Add listener to track attributes changes.
void	addPropertyChangeListener(Instance.PropertyChangeListener listener) Add listener to track attributes changes.
java.lang.String	getInstanceName()
<T> T	getValue(java.lang.String name) Get an attribute value.
<T> T	getValueEx(java.lang.String name) Get an attribute value.
void	removeAllListeners() Remove all Instance.PropertyChangeListeners.
void	removeListener(ValueListener listener) Remove listener.
void	removePropertyChangeListener(Instance.PropertyChangeListener listener) Remove listener.
void	setValue(java.lang.String name, java.lang.Object value) Set an attribute value.
void	setValue(java.lang.String name, java.lang.Object value, boolean checkEquals) Set value to property in instance For internal use only.
void	setValueEx(java.lang.String name, java.lang.Object value) Set an attribute value.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.haulmont.chile.core.model.Instance

getMetaClass

Constructor Detail

AbstractInstance

public AbstractInstance()

Method Detail

getInstanceName

public java.lang.String getInstanceName()

Specified by:

getInstanceName in interface Instance

Returns:

Instance name as defined by NamePattern or toString().

addListener

public void addListener(ValueListener listener)

Description copied from interface: Instance

Add listener to track attributes changes.

Specified by:

addListener in interface Instance

Parameters:

listener - listener

removeListener

public void removeListener(ValueListener listener)

Description copied from interface: Instance

Remove listener.

Specified by:

removeListener in interface Instance

Parameters:

listener - listener to remove

addPropertyChangeListener

public void addPropertyChangeListener(Instance.PropertyChangeListener listener)

Description copied from interface: Instance

Add listener to track attributes changes.

Specified by:

addPropertyChangeListener in interface Instance

Parameters:

listener - listener

removePropertyChangeListener

public void removePropertyChangeListener(Instance.PropertyChangeListener listener)

Description copied from interface: Instance

Remove listener.

Specified by:

removePropertyChangeListener in interface Instance

Parameters:

listener - listener to remove

removeAllListeners

public void removeAllListeners()

Description copied from interface: Instance

Remove all Instance.PropertyChangeListeners.

Specified by:

removeAllListeners in interface Instance

getValue

public <T> T getValue(java.lang.String name)

Description copied from interface: Instance

Get an attribute value.

Specified by:

getValue in interface Instance

Parameters:

name - attribute name according to JavaBeans notation

Returns:

attribute value

setValue

public void setValue(java.lang.String name,
                     java.lang.Object value)

Description copied from interface: Instance

Set an attribute value.
An implementor should first read a current value of the attribute, and then call an appropriate setter method only if the new value differs. This ensures triggering of Instance.PropertyChangeListeners only if the attribute was actually changed.

Specified by:

setValue in interface Instance

Parameters:

name - attribute name according to JavaBeans notation

value - attribute value

setValue

public void setValue(java.lang.String name,
                     java.lang.Object value,
                     boolean checkEquals)

Set value to property in instance For internal use only. Use setValue(String, Object)

Parameters:

name - property name

value - value

checkEquals - check equals for previous and new value. If flag is true and objects equals, then setter will not be invoked

getValueEx

public <T> T getValueEx(java.lang.String name)

Description copied from interface: Instance

Get an attribute value. Locates the attribute by the given path in object graph starting from this instance.
The path must consist of attribute names according to JavaBeans notation, separated by dots, e.g. car.driver.name.

Specified by:

getValueEx in interface Instance

Parameters:

name - path to an attribute

Returns:

attribute value. If any traversing attribute value is null or is not an Instance, this method stops here and returns this value.

setValueEx

public void setValueEx(java.lang.String name,
                       java.lang.Object value)

Description copied from interface: Instance

Set an attribute value. Locates the attribute by the given path in object graph starting from this instance.
The path must consist of attribute names according to JavaBeans notation, separated by dots, e.g. car.driver.name.
In the example above this method first gets value of car.driver attribute, and if it is not null and is an Instance, sets value of name attribute in it. If the value returned from getValueEx("car.driver") is null or is not an Instance, this method throws IllegalStateException.
An implementor should first read a current value of the attribute, and then call an appropriate setter method only if the new value differs. This ensures triggering of Instance.PropertyChangeListeners only if the attribute was actually changed.

Specified by:

setValueEx in interface Instance

Parameters:

name - path to an attribute

value - attribute value