ucar.unidata.data

Class CacheDataSource

java.lang.Object

ucar.unidata.collab.SharableImpl

ucar.unidata.data.DataSourceImpl

ucar.unidata.data.CacheDataSource

All Implemented Interfaces:

Sharable, DataSource, DataSourceFactory, XmlPersistable

public class CacheDataSource
extends DataSourceImpl

Used to cache a data choice and its data

Version:

$Revision: 1.12 $

Author:

IDV development team

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CacheDataSource.DataChoiceHolder Class DataChoiceHolder holds a data chocie and a unique id and a name

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_DATA data property
static java.lang.String	PROP_DATACHOICE datachoice property

Fields inherited from class ucar.unidata.data.DataSourceImpl

changeDataPathsCbx, dataCacheKey, dataChoices, geoSelectionPanel, haveBeenUnPersisted, okToContinue, PARAM_SHOW_HIDE, PARAM_SHOW_NO, PARAM_SHOW_YES

Fields inherited from interface ucar.unidata.data.DataSource

DATAPATH_DATE_FORMAT, DATAPATH_DATE_PATTERN, MOST_RECENT, ordinalNames, PROP_AUTOCREATEDISPLAY, PROP_BASEDIRECTORY, PROP_CACHEABLE, PROP_DATACHOICENAME, PROP_DISPLAYPROPERTIES, PROP_DOCUMENTLINKS, PROP_FILEPATTERN, PROP_GEOLOCATION, PROP_ICON, PROP_NAME, PROP_POLLINFO, PROP_RESOLVERURL, PROP_SERVICE_HTTP, PROP_SUBPROPERTIES, PROP_TIMELABELS, PROP_TIMESTRIDE, PROP_TITLE

Constructor Summary

Constructors

Constructor and Description
CacheDataSource() Default bean constructor; does nothing
CacheDataSource(DataSourceDescriptor descriptor, java.lang.String name, java.util.Hashtable properties) Create a CacheDataSource

Method Summary

Modifier and Type	Method and Description
protected void	addActions(java.util.List actions) add menu actions
void	addDataChoice(DataChoice dataChoice, java.lang.String name, visad.Data data) Add a data choice into the list with the given name.
void	addDataChoice(DataChoice dataChoice, java.lang.String name, visad.Data data, DataSelection dataSelection) add the data choice
void	clearCachedData() clear the cache
java.lang.Object	getCache(java.lang.Object key) Get an Object from the cache.
java.util.List	getDataChoices() Get the DataChoices.
protected visad.Data	getDataInner(DataChoice dataChoice, DataCategory category, DataSelection dataSelection, java.util.Hashtable requestProperties) Actually get the data identified by the given DataChoce.
java.util.List	getHolders() Get the Holders property.
void	putCache(java.lang.Object key, java.lang.Object value) Put the cache
void	removeCache(java.lang.Object key) Remove an Object from the cache.
void	setHolders(java.util.List value) Set the Holders property.
void	writeIser() write out the iser file

Methods inherited from class ucar.unidata.data.DataSourceImpl

addDataChangeListener, addDataChoice, addPropertiesTabs, addReloadTab, applyFieldMask, applyProperties, beginWritingDataToLocalDisk, canAddCurrentName, canCacheDataToDisk, canChangeData, canDoAllLevels, canDoFieldMask, canDoGeoSelection, canDoGeoSelectionMap, canDoGeoSelectionStride, canPoll, canSaveDataToLocalDisk, canShowParameter, checkForInitAfterUnPersistence, clearFileCache, clearTimes, convertSourceFile, convertToFilesIfDirectory, createAutoDisplay, createCacheKey, createElement, decrOutstandingGetDataCalls, doDirectory, doMakeDataChoices, doMakeDateTimes, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSubsetPropertiesComponent, doRemove, endWritingDataToLocalDisk, equals, expandIfNeeded, findDataChoice, findDataChoices, flushCache, getAbsoluteDateTimes, getActions, getAlias, getAllDateTimes, getAllDateTimes, getAllLevels, getAllLevels, getAllTimesForTimeDriver, getCache, getCacheClearDelay, getCacheDataToDisk, getCompositeDataChoices, getData, getData, getDataCachePath, getDataChangeListeners, getDataContext, getDataInner, getDataIsEditable, getDataPaths, getDataPrefix, getDataSelection, getDataSelectionComponents, getDataSource, getDateTimes, getDateTimeSelection, getDefaultSave, getDescription, getDescriptor, getErrorMessage, getEverChangedName, getExtraGeoSelectionComponent, getExtraTimesComponent, getFileFilterForPolling, getFullDescription, getid, getIdv, getInError, getLocalDirectory, getLocationForPolling, getLocationsForPolling, getMostRecentFiles, getName, getNameForDataSource, getNeedToShowErrorToUser, getNextId, getOutstandingGetDataCalls, getPartialDescription, getPassword, getPathsThatCanBeRelative, getPollingInfo, getProperties, getPropertiesComponents, getPropertiesHeader, getProperty, getProperty, getProperty, getProperty, getProperty, getProperty, getProperty, getRelativePaths, getSampleDataProjection, getSaveDataFileLabel, getSelectedDateTimes, getSelectedDateTimes, getTimesFromDataSelection, getTmpPaths, getTypeName, getUserName, handlePropertiesAction, hasPollingInfo, holdsDateTimes, holdsIndices, identifiedBy, identifiedByName, incrOutstandingGetDataCalls, initAfter, initAfterCreation, initAfterUnpersistence, initDataChoice, initDataSelectionComponents, initFromXml, isPolling, loadFieldMask, loadFieldMask, loadLatestFile, logException, logException, makeDerivedDataChoices, makeSaveLocalActions, newFileFromPolling, newFilesFromPolling, notifyDataChange, propertiesChanged, putCache, reloadData, reloadData, reloadProperties, removeDataChangeListener, removeDataChoice, removeProperty, replaceDataChoice, resetTmpState, saveDataToLocalDisk, saveDataToLocalDisk, saveDataToLocalDisk, selectTimesFromList, setAlias, setAskToUpdate, setCacheClearDelay, setCacheDataToDisk, setDataEditableStrings, setDataIsEditable, setDataIsRelative, setDataRelativeStrings, setDataSelection, setDateTimeSelection, setDefaultSave, setDescription, setDescriptor, setDirectory, setEverChangedName, setInError, setInError, setInError, setName, setNewFiles, setObjectProperties, setObjectProperty, setPassword, setPollingInfo, setPollLocation, setProperties, setProperty, setProperty, setRelativePaths, setTemplateName, setTmpPaths, setUserName, shouldCache, shouldCache, showPasswordDialog, showPropertiesDialog, showPropertiesDialog, showPropertiesDialog, showWaitDialog, tick, toString, toStringTruncated, updateDetailsText, updateState, writeFieldMaskFile, writeFieldMaskFile

Methods inherited from class ucar.unidata.collab.SharableImpl

applySharableProperties, doShare, doShare, doShareExternal, doShareInternal, getReceiveShareTime, getSharablePropertiesComponent, getShareGroup, getSharing, getUniqueId, initSharable, receiveShareData, removeSharable, setReceiveShareTime, setShareGroup, setSharing, setUniqueId, showSharableDialog

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ucar.unidata.data.DataSource

getUniqueId

Field Detail

PROP_DATACHOICE

public static final java.lang.String PROP_DATACHOICE

datachoice property

See Also:

Constant Field Values

PROP_DATA

public static final java.lang.String PROP_DATA

data property

See Also:

Constant Field Values

Constructor Detail

CacheDataSource

public CacheDataSource()

Default bean constructor; does nothing

CacheDataSource

public CacheDataSource(DataSourceDescriptor descriptor,
                       java.lang.String name,
                       java.util.Hashtable properties)

Create a CacheDataSource

Parameters:

descriptor - the datasource descriptor

name - my name

properties - my properties

Method Detail

addActions

protected void addActions(java.util.List actions)

add menu actions

Overrides:

addActions in class DataSourceImpl

Parameters:

actions - list of actions

writeIser

public void writeIser()

write out the iser file

addDataChoice

public void addDataChoice(DataChoice dataChoice,
                          java.lang.String name,
                          visad.Data data)

Add a data choice into the list with the given name. If data is non-null then cache it

Parameters:

dataChoice - The datachoice

name - The name

data - The data to cache

addDataChoice

public void addDataChoice(DataChoice dataChoice,
                          java.lang.String name,
                          visad.Data data,
                          DataSelection dataSelection)

add the data choice

Parameters:

dataChoice - data choice

name - name

data - the data

dataSelection - data selection

clearCachedData

public void clearCachedData()

clear the cache

Specified by:

clearCachedData in interface DataSource

Overrides:

clearCachedData in class DataSourceImpl

putCache

public void putCache(java.lang.Object key,
                     java.lang.Object value)

Put the cache

Overrides:

putCache in class DataSourceImpl

Parameters:

key - key

value - value

getCache

public java.lang.Object getCache(java.lang.Object key)

Get an Object from the cache.

Overrides:

getCache in class DataSourceImpl

Parameters:

key - key for the object

Returns:

the key value, or null

removeCache

public void removeCache(java.lang.Object key)

Remove an Object from the cache.

Overrides:

removeCache in class DataSourceImpl

Parameters:

key - key for the object

getDataInner

protected visad.Data getDataInner(DataChoice dataChoice,
                                  DataCategory category,
                                  DataSelection dataSelection,
                                  java.util.Hashtable requestProperties)
                           throws visad.VisADException,
                                  java.rmi.RemoteException

Description copied from class: DataSourceImpl

Actually get the data identified by the given DataChoce. The default is to call the getDataInner that does not take the requestProperties. This allows other, non unidata.data DataSource-s (that follow the old API) to work.

Overrides:

getDataInner in class DataSourceImpl

Parameters:

dataChoice - The data choice that identifies the requested data.

category - The data category of the request.

dataSelection - Identifies any subsetting of the data.

requestProperties - Hashtable that holds any detailed request properties.

Returns:

The data

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getDataChoices

public java.util.List getDataChoices()

Get the DataChoices.

Specified by:

getDataChoices in interface DataSource

Overrides:

getDataChoices in class DataSourceImpl

Returns:

List of DataChoices.

setHolders

public void setHolders(java.util.List value)

Set the Holders property.

Parameters:

value - The new value for Holders

getHolders

public java.util.List getHolders()

Get the Holders property.

Returns:

The Holders