com.virtuosotechnologies.lib.container
Interface RequestablePropertySet

All Superinterfaces:

PropertySet

All Known Subinterfaces:

DatabaseController, PaneController

public interface RequestablePropertySet

extends PropertySet

A PropertySet with request-semantics mutation methods. The semantics of these methods is that they are requests, but there is no guarantee of their actual effect. They may result in the requested change being done, they may result in a completely different change being done, or they may have no result at all. Clients should install listeners on the PropertySet to determine what, if any, effect these mutation methods actually have.

This interface itself does not specify thread-safety semantics. The particular implementation or use in a larger interface should specify this. For example, standalone PropertySets may be fully synchronized and thread-safe. PropertySets related to AWT or Swing objects may require that all interaction be done on the AWT event thread.

Method Summary

void	requestPutValue(ConstrainedKey key, Object value) Request a change to a property value.
void	requestResetValue(ConstrainedKey key) Request a property be set to the default, or to null if there is no default.

Methods inherited from interface com.virtuosotechnologies.lib.container.PropertySet

addPropertySetListener, getDefaultValue, getValue, removePropertySetListener

Method Detail

requestPutValue

public void requestPutValue(ConstrainedKey key,
                            Object value)

Request a change to a property value. There is no guarantee of what change, if any, will actually be made.

Parameters:

key - key object for the property.

value - new value for the property.

requestResetValue

public void requestResetValue(ConstrainedKey key)

Request a property be set to the default, or to null if there is no default. There is no guarantee of what change, if any, will actually be made.

Parameters:

key - key object for the property