com.haulmont.cuba.core.app.events

Class AttributeChanges

java.lang.Object

com.haulmont.cuba.core.app.events.AttributeChanges

public class AttributeChanges
extends java.lang.Object

An object describing changes in entity attributes.

See Also:

EntityChangedEvent.getChanges()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AttributeChanges.Change INTERNAL.

Constructor Summary

Constructors

Constructor and Description
AttributeChanges(java.util.Set<AttributeChanges.Change> changes, java.util.Map<java.lang.String,AttributeChanges> embeddedChanges) INTERNAL.

Method Summary

Modifier and Type	Method and Description
java.util.Set<java.lang.String>	getAttributes() Returns names of changed attributes for the root entity and all its embedded entities (if any).
<E extends Entity<K>,K> java.util.Collection<Id<E,K>>	getOldCollection(java.lang.String attributeName, java.lang.Class<E> entityClass) Type-safe method of getting the old value of a collection attribute.
<E extends Entity<K>,K> Id<E,K>	getOldReferenceId(java.lang.String attributeName) Type-safe method of getting the old value of a reference attribute.
<T> T	getOldValue(java.lang.String attributeName) Returns old value of a changed attribute with the given name.
java.util.Set<java.lang.String>	getOwnAttributes() Returns names of changed attributes for the root entity.
boolean	isChanged(java.lang.String attributeName) Returns true if an attribute with the given name is changed.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AttributeChanges

public AttributeChanges(java.util.Set<AttributeChanges.Change> changes,
                        java.util.Map<java.lang.String,AttributeChanges> embeddedChanges)

INTERNAL.

Method Detail

getOwnAttributes

public java.util.Set<java.lang.String> getOwnAttributes()

Returns names of changed attributes for the root entity.

getAttributes

public java.util.Set<java.lang.String> getAttributes()

Returns names of changed attributes for the root entity and all its embedded entities (if any). Embedded attributes are represented by dot-separated paths.

isChanged

public boolean isChanged(java.lang.String attributeName)

Returns true if an attribute with the given name is changed. If the attribute is not changed or does not exist at all, returns false.

getOldValue

@Nullable
public <T> T getOldValue(java.lang.String attributeName)

Returns old value of a changed attribute with the given name. Old value can be null. If the attribute is not changed or does not exist at all, returns null.

If the attribute is a reference to an entity, its old value is of type Id. If the attribute is a collection of references, its old value is a collection of Ids.

getOldReferenceId

@Nullable
public <E extends Entity<K>,K> Id<E,K> getOldReferenceId(java.lang.String attributeName)

Type-safe method of getting the old value of a reference attribute.

Parameters:

attributeName - reference attribute name

Returns:

Id of the referenced object

getOldCollection

public <E extends Entity<K>,K> java.util.Collection<Id<E,K>> getOldCollection(java.lang.String attributeName,
                                                                              java.lang.Class<E> entityClass)

Type-safe method of getting the old value of a collection attribute.

Usage example:

 Collection<Id<OrderLine, UUID>> orderLines = event.getChanges().getOldCollection("orderLines", OrderLine.class);
 for (Id<OrderLine, UUID> orderLineId : orderLines) {
     OrderLine orderLine = dataManager.load(orderLineId).one();
     // ...
 }
 

Parameters:

attributeName - collection attribute name

entityClass - class of the attribute

Returns:

collection of Ids

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object