NASA World Wind

gov.nasa.worldwind
Interface Restorable

All Known Subinterfaces:
Annotation, Layer, OrbitView, View, WWIcon
All Known Implementing Classes:
AbstractAnnotation, AbstractLayer, AbstractView, AnnotationAttributes, AnnotationLayer, BasicOrbitView, BasicTiledImageLayer, BMNGOneImage, BMNGSurfaceLayer, BMNGWMSLayer, Clementine30Layer, Clementine40BaseLayer, Clementine40Layer, CompassLayer, CountryBoundariesLayer, CrosshairLayer, EarthNASAPlaceNameLayer, FlatOrbitView, FogLayer, GlobeAnnotation, IconLayer, LandsatI3, LandsatI3WMSLayer, MDIMLayer, MGRSGraticuleLayer, MOCColorizedBaseLayer, MOCColorizedLayer, MOCLayer, MolaColorASULayer, MolaColoredJPLLayer, NAIPCalifornia, NAIPCaliforniaWMS, NASAEarthObservatory, NASAWFSPlaceNameLayer, OpenStreetMapLayer, Pedestal, PlaceNameLayer, Polyline, RenderableLayer, RPFTiledImageLayer, SARAnnotation, ScalebarLayer, ScreenAnnotation, ShadedElevationLayer, SkyColorLayer, SkyGradientLayer, StarsLayer, SurfaceImageLayer, TerrainProfileLayer, THEMISColorLayer, THEMISLayer, TiledImageLayer, TrackLayer, TrackMarkerLayer, TrackPipesLayer, UserFacingIcon, USGSDigitalOrtho, USGSTopographicMaps, USGSTopoHighRes, USGSTopoLowRes, USGSTopoMedRes, USGSUrbanAreaOrtho, UTMGraticuleLayer, WMSTiledImageLayer, WorldMapLayer

public interface Restorable

Restorable is an interface for describing the current state of an object, and restoring an object?s state. Object state descriptions will be formatted as an XML document string. This allows the state description to be located in a file, reside in a database, or be passed over a network.

The exact structure of the XML document is the responsibility of the implementation. However, to encourage data sharing between similar implementations, each implementation of Restorable should design restoreState to accept and ignore unknown structures in state documents. Otherwise, implementations should clearly document how they will behave when encountering an unknown structure.

See the WorldWideWeb Consortium's (W3C) documentation on Extensible Markup Language (XML) 1.1 for information on XML.


Method Summary
 String getRestorableState()
          Returns an XML document string describing the object?s state.
 void restoreState(String stateInXml)
          Restores the object?s state to what is described in the specified XML document string.
 

Method Detail

getRestorableState

String getRestorableState()
Returns an XML document string describing the object?s state. This state can be restored later by calling restoreState and passing the XML document.

Returns:
an XML document string describing the object's state.

restoreState

void restoreState(String stateInXml)
Restores the object?s state to what is described in the specified XML document string.

Parameters:
stateInXml - an XML document string describing an object's state.

NASA World Wind