Class CustomMapEditor
- All Implemented Interfaces:
PropertyEditor
-
Constructor Summary
ConstructorDescriptionCustomMapEditor
(Class<? extends Map> mapType) Create a new CustomMapEditor for the given target type, keeping an incomingnull
as-is.CustomMapEditor
(Class<? extends Map> mapType, boolean nullAsEmptyMap) Create a new CustomMapEditor for the given target type. -
Method Summary
Modifier and TypeMethodDescriptionprotected boolean
Return whether to always create a new Map, even if the type of the passed-in Map already matches.protected Object
convertKey
(Object key) Hook to convert each encountered Map key.protected Object
convertValue
(Object value) Hook to convert each encountered Map value.Create a Map of the given type, with the given initial capacity (if supported by the Map type).This implementation returnsnull
to indicate that there is no appropriate text representation.void
Convert the given text value to a Map with a single element.void
Convert the given value to a Map of the target type.Methods inherited from class java.beans.PropertyEditorSupport
addPropertyChangeListener, firePropertyChange, getCustomEditor, getJavaInitializationString, getSource, getTags, getValue, isPaintable, paintValue, removePropertyChangeListener, setSource, supportsCustomEditor
-
Constructor Details
-
CustomMapEditor
Create a new CustomMapEditor for the given target type, keeping an incomingnull
as-is.- Parameters:
mapType
- the target type, which needs to be a sub-interface of Map or a concrete Map class- See Also:
-
CustomMapEditor
Create a new CustomMapEditor for the given target type.If the incoming value is of the given type, it will be used as-is. If it is a different Map type or an array, it will be converted to a default implementation of the given Map type. If the value is anything else, a target Map with that single value will be created.
The default Map implementations are: TreeMap for SortedMap, and LinkedHashMap for Map.
- Parameters:
mapType
- the target type, which needs to be a sub-interface of Map or a concrete Map classnullAsEmptyMap
- ap whether to convert an incomingnull
value to an empty Map (of the appropriate type)- See Also:
-
-
Method Details
-
setAsText
Convert the given text value to a Map with a single element.- Specified by:
setAsText
in interfacePropertyEditor
- Overrides:
setAsText
in classPropertyEditorSupport
- Throws:
IllegalArgumentException
-
setValue
Convert the given value to a Map of the target type.- Specified by:
setValue
in interfacePropertyEditor
- Overrides:
setValue
in classPropertyEditorSupport
-
createMap
Create a Map of the given type, with the given initial capacity (if supported by the Map type).- Parameters:
mapType
- a sub-interface of MapinitialCapacity
- the initial capacity- Returns:
- the new Map instance
-
alwaysCreateNewMap
protected boolean alwaysCreateNewMap()Return whether to always create a new Map, even if the type of the passed-in Map already matches.Default is "false"; can be overridden to enforce creation of a new Map, for example to convert elements in any case.
-
convertKey
Hook to convert each encountered Map key. The default implementation simply returns the passed-in key as-is.Can be overridden to perform conversion of certain keys, for example from String to Integer.
Only called if actually creating a new Map! This is by default not the case if the type of the passed-in Map already matches. Override
alwaysCreateNewMap()
to enforce creating a new Map in every case.- Parameters:
key
- the source key- Returns:
- the key to be used in the target Map
- See Also:
-
convertValue
Hook to convert each encountered Map value. The default implementation simply returns the passed-in value as-is.Can be overridden to perform conversion of certain values, for example from String to Integer.
Only called if actually creating a new Map! This is by default not the case if the type of the passed-in Map already matches. Override
alwaysCreateNewMap()
to enforce creating a new Map in every case.- Parameters:
value
- the source value- Returns:
- the value to be used in the target Map
- See Also:
-
getAsText
This implementation returnsnull
to indicate that there is no appropriate text representation.- Specified by:
getAsText
in interfacePropertyEditor
- Overrides:
getAsText
in classPropertyEditorSupport
-