- java.lang.Object
-
- javafx.beans.binding.MapExpression<K,V>
-
- Type Parameters:
K
- the type of the key elementsV
- the type of the value elements
- All Implemented Interfaces:
Map<K,V>
,Observable
,ObservableMapValue<K,V>
,ObservableObjectValue<ObservableMap<K,V>>
,ObservableValue<ObservableMap<K,V>>
,ObservableMap<K,V>
- Direct Known Subclasses:
MapBinding
,ReadOnlyMapProperty
public abstract class MapExpression<K,V> extends Object implements ObservableMapValue<K,V>
MapExpression
is anObservableMapValue
plus additional convenience methods to generate bindings in a fluent style.A concrete sub-class of
MapExpression
has to implement the methodObservableObjectValue.get()
, which provides the actual value of this expression.If the wrapped list of a
MapExpression
isnull
, all methods implementing theMap
interface will behave as if they were applied to an immutable empty list.- Since:
- JavaFX 2.1
-
-
Property Summary
Properties Type Property Description abstract ReadOnlyBooleanProperty
empty
A boolean property that istrue
, if the map is empty.abstract ReadOnlyIntegerProperty
size
An integer property that represents the size of the map.
-
Constructor Summary
Constructors Constructor Description MapExpression()
-
Method Summary
Modifier and Type Method Description StringBinding
asString()
void
clear()
boolean
containsKey(Object obj)
boolean
containsValue(Object obj)
abstract ReadOnlyBooleanProperty
emptyProperty()
A boolean property that istrue
, if the map is empty.Set<Map.Entry<K,V>>
entrySet()
V
get(Object key)
int
getSize()
The size of the mapObservableMap<K,V>
getValue()
Returns the current value of thisObservableValue
boolean
isEmpty()
Gets the value of the property empty.BooleanBinding
isEqualTo(ObservableMap<?,?> other)
BooleanBinding
isNotEqualTo(ObservableMap<?,?> other)
BooleanBinding
isNotNull()
BooleanBinding
isNull()
Set<K>
keySet()
static <K,V>
MapExpression<K,V>mapExpression(ObservableMapValue<K,V> value)
Returns aMapExpression
that wraps aObservableMapValue
.V
put(K key, V value)
void
putAll(Map<? extends K,? extends V> elements)
V
remove(Object obj)
int
size()
abstract ReadOnlyIntegerProperty
sizeProperty()
An integer property that represents the size of the map.ObjectBinding<V>
valueAt(ObservableValue<K> key)
Creates a newObjectBinding
that contains the mapping of the specified key.ObjectBinding<V>
valueAt(K key)
Creates a newObjectBinding
that contains the mapping of the specified key.Collection<V>
values()
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll
-
Methods inherited from interface javafx.beans.Observable
addListener, removeListener
-
Methods inherited from interface javafx.collections.ObservableMap
addListener, removeListener
-
Methods inherited from interface javafx.beans.value.ObservableObjectValue
get
-
Methods inherited from interface javafx.beans.value.ObservableValue
addListener, removeListener
-
-
-
-
Property Detail
-
size
public abstract ReadOnlyIntegerProperty sizeProperty
An integer property that represents the size of the map.- See Also:
getSize()
-
empty
public abstract ReadOnlyBooleanProperty emptyProperty
A boolean property that istrue
, if the map is empty.- See Also:
isEmpty()
-
-
Method Detail
-
getValue
public ObservableMap<K,V> getValue()
Description copied from interface:ObservableValue
Returns the current value of thisObservableValue
- Specified by:
getValue
in interfaceObservableValue<K>
- Returns:
- The current value
-
mapExpression
public static <K,V> MapExpression<K,V> mapExpression(ObservableMapValue<K,V> value)
Returns aMapExpression
that wraps aObservableMapValue
. If theObservableMapValue
is already aMapExpression
, it will be returned. Otherwise a newMapBinding
is created that is bound to theObservableMapValue
.- Type Parameters:
K
- the type of the key elementsV
- the type of the value elements- Parameters:
value
- The sourceObservableMapValue
- Returns:
- A
MapExpression
that wraps theObservableMapValue
if necessary - Throws:
NullPointerException
- ifvalue
isnull
-
getSize
public int getSize()
The size of the map- Returns:
- the size
-
sizeProperty
public abstract ReadOnlyIntegerProperty sizeProperty()
An integer property that represents the size of the map.- See Also:
getSize()
-
emptyProperty
public abstract ReadOnlyBooleanProperty emptyProperty()
A boolean property that istrue
, if the map is empty.- See Also:
isEmpty()
-
valueAt
public ObjectBinding<V> valueAt(K key)
Creates a newObjectBinding
that contains the mapping of the specified key.- Parameters:
key
- the key of the mapping- Returns:
- the
ObjectBinding
-
valueAt
public ObjectBinding<V> valueAt(ObservableValue<K> key)
Creates a newObjectBinding
that contains the mapping of the specified key.- Parameters:
key
- the key of the mapping- Returns:
- the
ObjectBinding
- Throws:
NullPointerException
- ifkey
isnull
-
isEqualTo
public BooleanBinding isEqualTo(ObservableMap<?,?> other)
- Parameters:
other
- the otherObservableMap
- Returns:
- the new
BooleanBinding
- Throws:
NullPointerException
- ifother
isnull
-
isNotEqualTo
public BooleanBinding isNotEqualTo(ObservableMap<?,?> other)
- Parameters:
other
- the otherObservableMap
- Returns:
- the new
BooleanBinding
- Throws:
NullPointerException
- ifother
isnull
-
isNull
public BooleanBinding isNull()
- Returns:
- the new
BooleanBinding
-
isNotNull
public BooleanBinding isNotNull()
- Returns:
- the new
BooleanBinding
-
asString
public StringBinding asString()
Creates aStringBinding
that holds the value of theMapExpression
turned into aString
. If the value of thisMapExpression
changes, the value of theStringBinding
will be updated automatically.- Returns:
- the new
StringBinding
-
isEmpty
public boolean isEmpty()
Gets the value of the property empty.
-
containsKey
public boolean containsKey(Object obj)
- Specified by:
containsKey
in interfaceMap<K,V>
-
containsValue
public boolean containsValue(Object obj)
- Specified by:
containsValue
in interfaceMap<K,V>
-
-