Module javafx.base

Package javafx.collections

Class MapChangeListener.Change<K,V>

java.lang.Object

javafx.collections.MapChangeListener.Change<K,V>

Type Parameters:

K - key type

V - value type

Enclosing interface:

MapChangeListener<K,V>

public abstract static class MapChangeListener.Change<K,V>
extends Object

An elementary change done to an ObservableMap. Change contains information about a put or remove operation. Note that put operation might remove an element if there was already a value associated with the same key. In this case wasAdded() and wasRemoved() will both return true.

Since:

JavaFX 2.0

Constructor Summary

Constructors

Constructor	Description
Change(ObservableMap<K,V> map)	Constructs a change associated with a map.

Method Summary

Modifier and Type	Method	Description
abstract K	getKey()	A key associated with the change.
ObservableMap<K,V>	getMap()	An observable map that is associated with the change.
abstract V	getValueAdded()	Get the new value of the key.
abstract V	getValueRemoved()	Get the old value of the key.
abstract boolean	wasAdded()	If this change is a result of add operation.
abstract boolean	wasRemoved()	If this change is a result of removal operation.

Methods declared in class java.lang.Object

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

Constructor Details

Change

public Change(ObservableMap<K,V> map)

Constructs a change associated with a map.

Parameters:

map - the source of the change

Method Details

getMap

public ObservableMap<K,V> getMap()

An observable map that is associated with the change.

Returns:

the source map

wasAdded

public abstract boolean wasAdded()

If this change is a result of add operation.

Returns:

true if a new value (or key-value) entry was added to the map

wasRemoved

public abstract boolean wasRemoved()

If this change is a result of removal operation. Note that an element might be removed even as a result of put operation.

Returns:

true if an old value (or key-value) entry was removed from the map

getKey

public abstract K getKey()

A key associated with the change. If the change is a remove change, the key no longer exist in a map. Otherwise, the key got set to a new value.

Returns:

the key that changed

getValueAdded

public abstract V getValueAdded()

Get the new value of the key. Return null if this is a removal.

Returns:

the value that is now associated with the key

getValueRemoved

public abstract V getValueRemoved()

Get the old value of the key. This is null if and only if the value was added to the key that was not previously in the map.

Returns:

the value previously associated with the key