gov.nasa.worldwind.avlist
Interface AVList

All Known Subinterfaces:

DrawContext, ElevationModel, Globe, InputHandler, Layer, Model, NetworkStatus, OrbitView, RetrievalService, Retriever, SceneController, Tessellator, View, WorldWindow, WorldWindowGLDrawable, WWObject

All Known Implementing Classes:

AbstractLayer, AbstractSceneController, AbstractView, AnaglyphSceneController, AnnotationLayer, AVListImpl, AWTInputHandler, BasicElevationModel, BasicModel, BasicNetworkStatus, BasicOrbitView, BasicRetrievalService, BasicSceneController, BasicTiledImageLayer, BMNGOneImage, BMNGSurfaceLayer, BMNGWMSLayer, Clementine30Layer, Clementine40BaseLayer, Clementine40Layer, CompassLayer, CountryBoundariesLayer, CrosshairLayer, DrawContextImpl, Earth, EarthElevationModel, EarthFlat, EarthNASAPlaceNameLayer, EllipsoidalGlobe, FlatGlobe, FlatOrbitView, FogLayer, HTTPRetriever, IconLayer, LandsatI3, LandsatI3WMSLayer, LayerList, LevelSet, LicenseAgreement, LineBuilder, Mars, MarsElevationModel, MDIMLayer, MGRSGraticuleLayer, MOCColorizedBaseLayer, MOCColorizedLayer, MOCLayer, MolaColorASULayer, MolaColoredJPLLayer, Moon, MoonElevationModel, NAIPCalifornia, NAIPCaliforniaWMS, NASAEarthObservatory, NASAWFSPlaceNameLayer, NOSALicenseAgreement, OpenStreetMapLayer, Pedestal, PickedObject, PlaceNameLayer, RectangularTessellator, RenderableLayer, RPFTiledImageLayer, ScalebarLayer, ShadedElevationLayer, SkyColorLayer, SkyGradientLayer, StarsLayer, SurfaceImageLayer, TerrainProfileLayer, THEMISColorLayer, THEMISLayer, ThreadedTaskService, TiledImageLayer, TrackLayer, TrackMarkerLayer, TrackPipesLayer, URLRetriever, UserFacingIcon, USGSDigitalOrtho, USGSTopographicMaps, USGSTopoHighRes, USGSTopoLowRes, USGSTopoMedRes, USGSUrbanAreaOrtho, UTMGraticuleLayer, WMSTiledImageLayer, WorldMapLayer, WorldWindowGLAutoDrawable, WorldWindowGLCanvas, WorldWindowGLJPanel, WorldWindowImpl, WWObjectImpl

public interface AVList

An interface for managing an attribute-value pair collection.

Method Summary

void	addPropertyChangeListener(java.beans.PropertyChangeListener listener) Adds the specified all-property property change listener that will be called for all list changes.
void	addPropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener) Adds a property change listener for the specified key.
AVList	clearList()
AVList	copy() Returns a shallow copy of this AVList instance: the keys and values themselves are not cloned.
void	firePropertyChange(java.beans.PropertyChangeEvent propertyChangeEvent) Calls all registered property change listeners with the specified property change event.
void	firePropertyChange(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue) Calls all property change listeners associated with the specified key.
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	getEntries()
java.lang.String	getStringValue(java.lang.String key) Returns the value for a specified key.
java.lang.Object	getValue(java.lang.String key) Returns the value for a specified key.
java.util.Collection<java.lang.Object>	getValues()
boolean	hasKey(java.lang.String key) Indicates whether a key is in the collection.
void	removeKey(java.lang.String key) Removes a specified key from the collection if the key exists, otherwise returns without affecting the collection.
void	removePropertyChangeListener(java.beans.PropertyChangeListener listener) Removes the specified all-property property change listener.
void	removePropertyChangeListener(java.lang.String propertyName, java.beans.PropertyChangeListener listener) Removes a property change listener associated with the specified key.
void	setValue(java.lang.String key, java.lang.Object value) Adds a key/value pair to the list.
void	setValues(AVList avList)

Method Detail

addPropertyChangeListener

void addPropertyChangeListener(java.beans.PropertyChangeListener listener)

Adds the specified all-property property change listener that will be called for all list changes.

Parameters:

listener - the listener to call.

Throws:

java.lang.IllegalArgumentException - if listener is null

See Also:

PropertyChangeSupport

addPropertyChangeListener

void addPropertyChangeListener(java.lang.String propertyName,
                               java.beans.PropertyChangeListener listener)

Adds a property change listener for the specified key.

Parameters:

propertyName - the key to associate the listener with.

listener - the listener to associate with the key.

Throws:

java.lang.IllegalArgumentException - if either propertyName or listener is null

See Also:

PropertyChangeSupport

clearList

AVList clearList()

copy

AVList copy()

Returns a shallow copy of this AVList instance: the keys and values themselves are not cloned.

Returns:

a shallow copy of this AVList.

firePropertyChange

void firePropertyChange(java.beans.PropertyChangeEvent propertyChangeEvent)

Calls all registered property change listeners with the specified property change event.

Parameters:

propertyChangeEvent - the event

Throws:

java.lang.IllegalArgumentException - if propertyChangeEvent is null

See Also:

PropertyChangeSupport

firePropertyChange

void firePropertyChange(java.lang.String propertyName,
                        java.lang.Object oldValue,
                        java.lang.Object newValue)

Calls all property change listeners associated with the specified key. No listeners are called if odValue and newValue are equal and non-null.

Parameters:

propertyName - the key

oldValue - the value associated with the key before the even causing the firing.

newValue - the new value associated with the key.

Throws:

java.lang.IllegalArgumentException - if propertyName is null

See Also:

PropertyChangeSupport

getEntries

java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> getEntries()

getStringValue

java.lang.String getStringValue(java.lang.String key)

Returns the value for a specified key. The value must be a String.

Parameters:

key - the attribute name. May not be null.

Returns:

the attribute value if one exists in the collection, otherwise null.

Throws:

java.lang.NullPointerException - if key is null.

WWRuntimeException - if the value in the collection is not a String type.

getValue

java.lang.Object getValue(java.lang.String key)

Returns the value for a specified key.

Parameters:

key - the attribute name. May not be null.

Returns:

the attribute value if one exists in the collection, otherwise null.

Throws:

java.lang.NullPointerException - if key is null.

getValues

java.util.Collection<java.lang.Object> getValues()

hasKey

boolean hasKey(java.lang.String key)

Indicates whether a key is in the collection.

Parameters:

key - the attribute name. May not be null.

Returns:

true if the key exists in the collection, otherwise false.

Throws:

java.lang.NullPointerException - if key is null.

removeKey

void removeKey(java.lang.String key)

Removes a specified key from the collection if the key exists, otherwise returns without affecting the collection.

Parameters:

key - the attribute name. May not be null.

Throws:

java.lang.NullPointerException - if key is null.

removePropertyChangeListener

void removePropertyChangeListener(java.beans.PropertyChangeListener listener)

Removes the specified all-property property change listener.

Parameters:

listener - the listener to remove.

Throws:

java.lang.IllegalArgumentException - if listener is null

See Also:

PropertyChangeSupport

removePropertyChangeListener

void removePropertyChangeListener(java.lang.String propertyName,
                                  java.beans.PropertyChangeListener listener)

Removes a property change listener associated with the specified key.

Parameters:

propertyName - the key associated with the change listener.

listener - the listener to remove.

Throws:

java.lang.IllegalArgumentException - if either propertyName or listener is null

See Also:

PropertyChangeSupport

setValue

void setValue(java.lang.String key,
              java.lang.Object value)

Adds a key/value pair to the list. Replaces an existing key/value pair if the list already contains the key.

Parameters:

key - the attribute name. May not be null.

value - the attribute value. May be null, in which case any existing value for the key is removed from the collection.

Throws:

java.lang.NullPointerException - if key is null.

setValues

void setValues(AVList avList)