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.BeanPropertyPath, Instance.PropertyChangeEvent, Instance.PropertyChangeListener

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Collection<java.lang.ref.WeakReference<Instance.PropertyChangeListener>>	__propertyChangeListeners
protected static int	PROPERTY_CHANGE_LISTENERS_INITIAL_CAPACITY

Constructor Summary

Constructors

Constructor and Description
AbstractInstance()

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(Instance.PropertyChangeListener listener) Add listener to track attributes changes.
java.lang.String	getInstanceName() Deprecated. Use MetadataTools.getInstanceName(com.haulmont.chile.core.model.Instance) instead.
protected MethodsCache	getMethodsCache()
protected RelatedPropertiesCache	getRelatedPropertiesCache()
protected java.util.Collection<java.lang.String>	getRelatedReadOnlyProperties(java.lang.String propertyName)
<T> T	getValue(java.lang.String name) Get an attribute value.
<T> T	getValueEx(Instance.BeanPropertyPath propertyPath) Get an attribute value.
<T> T	getValueEx(java.lang.String name) Get an attribute value.
protected void	propertyChanged(java.lang.String s, java.lang.Object prev, java.lang.Object curr)
void	removeAllListeners() Remove all Instance.PropertyChangeListeners.
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(Instance.BeanPropertyPath propertyPath, java.lang.Object value) Set an attribute value.
void	setValueEx(java.lang.String name, java.lang.Object value) Set an attribute value.

Methods inherited from class java.lang.Object

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

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

getMetaClass

Field Detail

PROPERTY_CHANGE_LISTENERS_INITIAL_CAPACITY

protected static final int PROPERTY_CHANGE_LISTENERS_INITIAL_CAPACITY

See Also:

Constant Field Values

__propertyChangeListeners

protected transient java.util.Collection<java.lang.ref.WeakReference<Instance.PropertyChangeListener>> __propertyChangeListeners

Constructor Detail

AbstractInstance

public AbstractInstance()

Method Detail

propertyChanged

protected void propertyChanged(java.lang.String s,
                               java.lang.Object prev,
                               java.lang.Object curr)

getInstanceName

@Deprecated
public java.lang.String getInstanceName()

Deprecated. Use MetadataTools.getInstanceName(com.haulmont.chile.core.model.Instance) instead.

Specified by:

getInstanceName in interface Instance

Returns:

Instance name as defined by NamePattern or toString().

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

getMethodsCache

protected MethodsCache getMethodsCache()

getRelatedReadOnlyProperties

protected java.util.Collection<java.lang.String> getRelatedReadOnlyProperties(java.lang.String propertyName)

getRelatedPropertiesCache

protected RelatedPropertiesCache getRelatedPropertiesCache()

setValue

public void setValue(java.lang.String name,
                     @Nullable
                     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.

getValueEx

@Nullable
public <T> T getValueEx(Instance.BeanPropertyPath propertyPath)

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:

propertyPath - 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.
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

setValueEx

public void setValueEx(Instance.BeanPropertyPath propertyPath,
                       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.
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:

propertyPath - path to an attribute

value - attribute value