- 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
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description StringBinding
asString()
abstract ReadOnlyBooleanProperty
emptyProperty()
A boolean property that istrue
, if the map is empty.int
getSize()
The size of the mapBooleanBinding
isEqualTo(ObservableMap<?,?> other)
BooleanBinding
isNotEqualTo(ObservableMap<?,?> other)
BooleanBinding
isNotNull()
BooleanBinding
isNull()
static <K,V> MapExpression<K,V>
mapExpression(ObservableMapValue<K,V> value)
Returns aMapExpression
that wraps aObservableMapValue
.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.-
Methods declared in interface java.util.Map
clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods declared in interface javafx.beans.Observable
addListener, removeListener
-
Methods declared in interface javafx.collections.ObservableMap
addListener, removeListener
-
Methods declared in interface javafx.beans.value.ObservableObjectValue
get
-
Methods declared in interface javafx.beans.value.ObservableValue
addListener, getValue, 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:
Map.isEmpty()
-
-
Method Detail
-
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:
Map.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
-
-