com.iizix.prop

Interface ICustomDataProvider

All Known Subinterfaces:

IUIAction, IUIAnimatedSingleIndexedSelectionComp, IUIBooleanSelectionComp, IUICellSelectionComp, IUICheck2Component, IUICheckComponent, IUIComp, IUIContainer, IUIDateTimeComponent, IUIDateValueComponent, IUIDoubleRangeValueComponent, IUIDoubleValueComponent, IUIHint, IUIIndexedSelectionComp, IUINullableValueComponent, IUIRadioComponent, IUISelectionComp, IUISingleIndexedSelectionComp, IUITimeValueComponent, IUITriStateSelectionComp, IUIValueComponent, IVSComponent, IVSMessageComponent

All Known Implementing Classes:

AbstractContentUIContainer, AbstractUIAction, MapMarkerProp, MapMarkers, MLGroup, MList, MLItemProp, MUIHeading, MUIPicker, MUIPickerSlot, MUISimpleDialog, MUISwitch, MUITabBar, UIAbstractListChoice, UIAccordion, UIButton, UICalendar, UIChart, UICheckBox, UICheckedMenuItem, UIComboBox, UIComp, UIContainer, UIContextMenu, UIDateTime, UIDialog, UIEmpty, UIGauge, UIImage, UILabel, UIMap, UIMedia, UIMenu, UIMenuBar, UIMenuItem, UIMenuSeparator, UIOutput, UIPanel, UIPanelBase, UIPanelPart, UIPanelPartCnr, UIProgress, UIRadioButton, UIRadioMenuItem, UISlider, UISpinner, UISwapContainer, UITabContainer, UITable, UITableColumn, UIText, UITextArea, UITitlePane, VirtualSpace, VSAction, VSColumnHeader, VSComponent, VSField, VSGroup, VSRow, VSTable

public interface ICustomDataProvider

Interface providing a storage mechanism of custom values on various objects and properties over the system. The custom data is not processed by the framework in any way, it merely keeps track of it. Cloned objects or properties do not clone the data.

The methods in this interface are thread safe, EXCEPT the deprecated forbiddenGetCustomDataMap(boolean) method that SHOULD NOT BE CALLED.

Author:

Christopher Mindus

Method Summary

Modifier and Type	Method and Description
Map<String,Object>	forbiddenGetCustomDataMap(boolean doCreate) Deprecated.
default <T> T	getCustomData(String name, Class<T> valueClass) Gets a custom data value with the specified name and a specific valueClass.
default Object	putCustomData(String name, Object value) Puts a custom data value with the specified name.
default Object	putCustomDataIfAbsent(String name, Object value) Puts a custom data value with the specified name if an existing entry is not present.

Method Detail

forbiddenGetCustomDataMap

@Deprecated
Map<String,Object> forbiddenGetCustomDataMap(boolean doCreate)

Deprecated.

Gets or creates the provider map. This method is not intended to be called by user code, it is used by the system.

Do not call this method!

Parameters:

doCreate - Creates the map if required.

Returns:

The map or newly created map, null if not created.

Note: the map returned is NOT synchronized thus not thread safe. It is up to the caller to synchronize on it to ensure thread safety.

putCustomData

default Object putCustomData(String name,
                             Object value)

Puts a custom data value with the specified name. This property can overwrite any existing value. If this is the case, that value is returned.

Parameters:

name - The name of the custom data to ut.

value - The value to set, null to clear the named custom data value, and return any cleared existing value.

Returns:

Any existing overwritten value, null for no previous value.

putCustomDataIfAbsent

default Object putCustomDataIfAbsent(String name,
                                     Object value)

Puts a custom data value with the specified name if an existing entry is not present. If an existing value is present, that value is returned and nothing is put.

Parameters:

name - The name of the custom data to put.

value - The value to set, null to clear the named custom data value, and return any cleared existing value.

Returns:

Any existing value, null for no previous value indicating that the value was put successfully.

getCustomData

default <T> T getCustomData(String name,
                            Class<T> valueClass)

Gets a custom data value with the specified name and a specific valueClass. If an existing value is present of the matching class, that value is returned, otherwise null is returned.

Parameters:

name - The name of the custom data to retrieve.

valueClass - The value class requested upon return.

Returns:

The retrieved value if existing and of the matching valueClass, or null if the value was not found by that name, or if the valueClass did not match the existing value in the custom data.