com.sun.javafx.fxml

Class BeanAdapter

java.lang.Object

java.util.AbstractMap<String,Object>

com.sun.javafx.fxml.BeanAdapter

All Implemented Interfaces:

Map<String,Object>

public class BeanAdapter
extends AbstractMap<String,Object>

Exposes Java Bean properties of an object via the Map interface. A call to Map.get(Object) invokes the getter for the corresponding property, and a call to Map.put(Object, Object) invokes the property's setter. Appending a "Property" suffix to the key returns the corresponding property model.

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static String	GET_PREFIX
static String	IS_PREFIX
static String	PROPERTY_SUFFIX
static String	SET_PREFIX
static String	VALUE_OF_METHOD_NAME

Constructor Summary

Constructors

Constructor and Description
BeanAdapter(Object bean) Creates a new Bean adapter.

Method Summary

Modifier and Type	Method and Description
static <T> T	coerce(Object value, Class<? extends T> type) Coerces a value to a given type.
boolean	containsKey(Object key) Verifies the existence of a property.
Set<Map.Entry<String,Object>>	entrySet()
boolean	equals(Object object)
Object	get(Object key) Invokes the getter method for the given property.
static <T> T	get(Object target, Class<?> sourceType, String key) Invokes the static getter method for the given property.
Object	getBean() Returns the Bean object this adapter wraps.
static Object	getConstantValue(Class<?> type, String name) Returns the value of a named constant.
static Type	getGenericListItemType(Type listType) Determines the type of a list item.
static Type	getGenericMapValueType(Type mapType) Determines the type of a map value.
static Type	getGenericType(Class<?> sourceType, String key, Class<?> targetType) Returns the generic type of a static property.
Type	getGenericType(String key) Returns the generic type of a property.
static Class<?>	getListItemType(Type listType) Determines the type of a list item.
static Class<?>	getMapValueType(Type mapType) Determines the type of a map value.
<T> ObservableValue<T>	getPropertyModel(String key) Returns the property model for the given property.
static Class<?>	getType(Class<?> sourceType, String key, Class<?> targetType) Returns the type of a static property.
Class<?>	getType(String key) Returns the type of a property.
int	hashCode()
static boolean	isDefined(Class<?> sourceType, String key, Class<?> targetType) Tests the existence of a static property.
boolean	isReadOnly(String key) Tests the mutability of a property.
static void	put(Object target, Class<?> sourceType, String key, Object value) Invokes a static setter method for the given property.
Object	put(String key, Object value) Invokes a setter method for the given property.

Methods inherited from class java.util.AbstractMap

clear, clone, containsValue, isEmpty, keySet, putAll, remove, size, toString, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Field Detail

GET_PREFIX

public static final String GET_PREFIX

See Also:

Constant Field Values

IS_PREFIX

public static final String IS_PREFIX

See Also:

Constant Field Values

SET_PREFIX

public static final String SET_PREFIX

See Also:

Constant Field Values

PROPERTY_SUFFIX

public static final String PROPERTY_SUFFIX

See Also:

Constant Field Values

VALUE_OF_METHOD_NAME

public static final String VALUE_OF_METHOD_NAME

See Also:

Constant Field Values

Constructor Detail

BeanAdapter

public BeanAdapter(Object bean)

Creates a new Bean adapter.

Parameters:

bean - The Bean object to wrap.

Method Detail

getBean

public Object getBean()

Returns the Bean object this adapter wraps.

Returns:

The Bean object, or null if no Bean has been set.

get

public Object get(Object key)

Invokes the getter method for the given property.

Specified by:

get in interface Map<String,Object>

Overrides:

get in class AbstractMap<String,Object>

Parameters:

key - The property name.

Returns:

The value returned by the method, or null if no such method exists.

put

public Object put(String key,
                  Object value)

Invokes a setter method for the given property. The coerce(Object, Class) method is used as needed to attempt to convert a given value to the property type, as defined by the return value of the getter method.

Specified by:

put in interface Map<String,Object>

Overrides:

put in class AbstractMap<String,Object>

Parameters:

key - The property name.

value - The new property value.

Returns:

Returns null, since returning the previous value would require an unnecessary call to the getter method.

Throws:

PropertyNotFoundException - If the given property does not exist or is read-only.

containsKey

public boolean containsKey(Object key)

Verifies the existence of a property.

Specified by:

containsKey in interface Map<String,Object>

Overrides:

containsKey in class AbstractMap<String,Object>

Parameters:

key - The property name.

Returns:

true if the property exists; false, otherwise.

entrySet

public Set<Map.Entry<String,Object>> entrySet()

Specified by:

entrySet in interface Map<String,Object>

Specified by:

entrySet in class AbstractMap<String,Object>

isReadOnly

public boolean isReadOnly(String key)

Tests the mutability of a property.

Parameters:

key - The property name.

Returns:

true if the property is read-only; false, otherwise.

getPropertyModel

public <T> ObservableValue<T> getPropertyModel(String key)

Returns the property model for the given property.

Parameters:

key - The property name.

Returns:

The named property model, or null if no such property exists.

getType

public Class<?> getType(String key)

Returns the type of a property.

Parameters:

key - The property name.

getGenericType

public Type getGenericType(String key)

Returns the generic type of a property.

Parameters:

key - The property name.

equals

public boolean equals(Object object)

Specified by:

equals in interface Map<String,Object>

Overrides:

equals in class AbstractMap<String,Object>

hashCode

public int hashCode()

Specified by:

hashCode in interface Map<String,Object>

Overrides:

hashCode in class AbstractMap<String,Object>

coerce

public static <T> T coerce(Object value,
                           Class<? extends T> type)

Coerces a value to a given type.

Parameters:

value -

type -

Returns:

The coerced value.

get

public static <T> T get(Object target,
                        Class<?> sourceType,
                        String key)

Invokes the static getter method for the given property.

Parameters:

target - The object to which the property is attached.

sourceType - The class that defines the property.

key - The property name.

Returns:

The value returned by the method, or null if no such method exists.

put

public static void put(Object target,
                       Class<?> sourceType,
                       String key,
                       Object value)

Invokes a static setter method for the given property. If the value is null or there is no explicit setter for a given type, the coerce(Object, Class) method is used to attempt to convert the value to the actual property type (defined by the return value of the getter method).

Parameters:

target - The object to which the property is or will be attached.

sourceType - The class that defines the property.

key - The property name.

value - The new property value.

Throws:

PropertyNotFoundException - If the given static property does not exist or is read-only.

isDefined

public static boolean isDefined(Class<?> sourceType,
                                String key,
                                Class<?> targetType)

Tests the existence of a static property.

Parameters:

sourceType - The class that defines the property.

key - The property name.

targetType - The type of the object to which the property applies.

Returns:

true if the property exists; false, otherwise.

getType

public static Class<?> getType(Class<?> sourceType,
                               String key,
                               Class<?> targetType)

Returns the type of a static property.

Parameters:

sourceType - The class that defines the property.

key - The property name.

targetType - The type of the object to which the property applies.

getGenericType

public static Type getGenericType(Class<?> sourceType,
                                  String key,
                                  Class<?> targetType)

Returns the generic type of a static property.

Parameters:

sourceType - The class that defines the property.

key - The property name.

targetType - The type of the object to which the property applies.

getListItemType

public static Class<?> getListItemType(Type listType)

Determines the type of a list item.

Parameters:

listType -

getMapValueType

public static Class<?> getMapValueType(Type mapType)

Determines the type of a map value.

Parameters:

mapType -

getGenericListItemType

public static Type getGenericListItemType(Type listType)

Determines the type of a list item.

Parameters:

listType -

getGenericMapValueType

public static Type getGenericMapValueType(Type mapType)

Determines the type of a map value.

Parameters:

mapType -

getConstantValue

public static Object getConstantValue(Class<?> type,
                                      String name)

Returns the value of a named constant.

Parameters:

type - The type that defines the constant.

name - The name of the constant.