ucar.unidata.data.text

Class FrontDataSource

java.lang.Object

ucar.unidata.collab.SharableImpl

ucar.unidata.data.DataSourceImpl

ucar.unidata.data.FilesDataSource

ucar.unidata.data.text.FrontDataSource

All Implemented Interfaces:

Sharable, DataSource, DataSourceFactory, XmlPersistable

public class FrontDataSource
extends FilesDataSource

A class for handling text (and HTML) classes

Author:

IDV development team

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_TIMEWINDOW Property to show the time selection window

Fields inherited from class ucar.unidata.data.FilesDataSource

adapters, oldSourceFromBundles, sources

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
FrontDataSource() Default bean constructor; does nothing.
FrontDataSource(DataSourceDescriptor descriptor, java.util.List files, java.util.Hashtable properties) Create a new FrontDataSource
FrontDataSource(DataSourceDescriptor descriptor, java.lang.String filename, java.util.Hashtable properties) Create a new FrontDataSource

Method Summary

Modifier and Type	Method and Description
boolean	applyProperties() Apply the properties
boolean	canSaveDataToLocalDisk() Is this data source capable of saving its data to local disk
protected void	doMakeDataChoices() Make the data choices associated with this source
protected java.lang.String	getDataFileExtension(java.lang.String file) Get the file extension for saving to local disk
protected java.lang.String	getDataFilePrefix(java.lang.String file) get the prefix to use when saving to local disk
protected visad.Data	getDataInner(DataChoice dataChoice, DataCategory category, DataSelection dataSelection, java.util.Hashtable requestProperties) Actually get the data identified by the given DataChoce.
protected java.util.List	getInputStreams(java.util.List processedSources) Get the list of input streams used to make data local
void	getPropertiesComponents(java.util.List comps) Add to the properties component list
double	getTimeWindow() Get the TimeWindow property.
static void	main(java.lang.String[] args) test main
protected java.lang.String	processDataFilename(java.lang.String filename, int index) Process the file name to get a file that we can use to write to local disk
void	setTimeWindow(double value) Set the TimeWindow property.

Methods inherited from class ucar.unidata.data.FilesDataSource

doRemove, equals, getDataPaths, getFilePath, getFullDescription, getLocationsForPolling, getPartialDescription, getSource, getSources, haveSources, initAfterCreation, initAfterUnpersistence, initWithPollingInfo, isFileBased, newFilesFromPolling, propertiesChanged, reloadData, reloadData, saveDataToLocalDisk, setNewFiles, setSource, setSources, sourcesChanged, updateState

Methods inherited from class ucar.unidata.data.DataSourceImpl

addActions, addDataChangeListener, addDataChoice, addPropertiesTabs, addReloadTab, applyFieldMask, beginWritingDataToLocalDisk, canAddCurrentName, canCacheDataToDisk, canChangeData, canDoAllLevels, canDoFieldMask, canDoGeoSelection, canDoGeoSelectionMap, canDoGeoSelectionStride, canPoll, canShowParameter, checkForInitAfterUnPersistence, clearCachedData, clearFileCache, clearTimes, convertSourceFile, convertToFilesIfDirectory, createAutoDisplay, createCacheKey, createElement, decrOutstandingGetDataCalls, doDirectory, doMakeDateTimes, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSubsetPropertiesComponent, endWritingDataToLocalDisk, expandIfNeeded, findDataChoice, findDataChoices, flushCache, getAbsoluteDateTimes, getActions, getAlias, getAllDateTimes, getAllDateTimes, getAllLevels, getAllLevels, getAllTimesForTimeDriver, getCache, getCache, getCacheClearDelay, getCacheDataToDisk, getCompositeDataChoices, getData, getData, getDataCachePath, getDataChangeListeners, getDataChoices, getDataContext, getDataInner, getDataIsEditable, getDataPrefix, getDataSelection, getDataSelectionComponents, getDataSource, getDateTimes, getDateTimeSelection, getDefaultSave, getDescription, getDescriptor, getErrorMessage, getEverChangedName, getExtraGeoSelectionComponent, getExtraTimesComponent, getFileFilterForPolling, getid, getIdv, getInError, getLocalDirectory, getLocationForPolling, getMostRecentFiles, getName, getNameForDataSource, getNeedToShowErrorToUser, getNextId, getOutstandingGetDataCalls, getPassword, getPathsThatCanBeRelative, getPollingInfo, getProperties, 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, initDataChoice, initDataSelectionComponents, initFromXml, isPolling, loadFieldMask, loadFieldMask, loadLatestFile, logException, logException, makeDerivedDataChoices, makeSaveLocalActions, newFileFromPolling, notifyDataChange, putCache, putCache, reloadProperties, removeCache, removeDataChangeListener, removeDataChoice, removeProperty, replaceDataChoice, resetTmpState, saveDataToLocalDisk, saveDataToLocalDisk, selectTimesFromList, setAlias, setAskToUpdate, setCacheClearDelay, setCacheDataToDisk, setDataEditableStrings, setDataIsEditable, setDataIsRelative, setDataRelativeStrings, setDataSelection, setDateTimeSelection, setDefaultSave, setDescription, setDescriptor, setDirectory, setEverChangedName, setInError, setInError, setInError, setName, setObjectProperties, setObjectProperty, setPassword, setPollingInfo, setPollLocation, setProperties, setProperty, setProperty, setRelativePaths, setTemplateName, setTmpPaths, setUserName, shouldCache, shouldCache, showPasswordDialog, showPropertiesDialog, showPropertiesDialog, showPropertiesDialog, showWaitDialog, tick, toString, toStringTruncated, updateDetailsText, 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_TIMEWINDOW

public static final java.lang.String PROP_TIMEWINDOW

Property to show the time selection window

See Also:

Constant Field Values

Constructor Detail

FrontDataSource

public FrontDataSource()

Default bean constructor; does nothing.

FrontDataSource

public FrontDataSource(DataSourceDescriptor descriptor,
                       java.lang.String filename,
                       java.util.Hashtable properties)

Create a new FrontDataSource

Parameters:

descriptor - descriptor for this DataSource

filename - name of the file (or URL)

properties - extra data source properties

FrontDataSource

public FrontDataSource(DataSourceDescriptor descriptor,
                       java.util.List files,
                       java.util.Hashtable properties)

Create a new FrontDataSource

Parameters:

descriptor - Descriptor for this DataSource

files - List of files or urls

properties - Extra data source properties

Method Detail

canSaveDataToLocalDisk

public boolean canSaveDataToLocalDisk()

Is this data source capable of saving its data to local disk

Specified by:

canSaveDataToLocalDisk in interface DataSource

Overrides:

canSaveDataToLocalDisk in class DataSourceImpl

Returns:

Can save to local disk

getDataFileExtension

protected java.lang.String getDataFileExtension(java.lang.String file)

Get the file extension for saving to local disk

Overrides:

getDataFileExtension in class FilesDataSource

Parameters:

file - The file

Returns:

its extension

getDataFilePrefix

protected java.lang.String getDataFilePrefix(java.lang.String file)

get the prefix to use when saving to local disk

Parameters:

file - file

Returns:

prefix

getPropertiesComponents

public void getPropertiesComponents(java.util.List comps)

Add to the properties component list

Overrides:

getPropertiesComponents in class DataSourceImpl

Parameters:

comps - List of components for the properties dialog

applyProperties

public boolean applyProperties()

Apply the properties

Overrides:

applyProperties in class DataSourceImpl

Returns:

successful

doMakeDataChoices

protected void doMakeDataChoices()

Make the data choices associated with this source

Overrides:

doMakeDataChoices in class DataSourceImpl

getDataInner

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

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 visad.Data object

Throws:

java.rmi.RemoteException - Java RMI problem p * @throws VisADException VisAD problem

visad.VisADException - VisAD problem

processDataFilename

protected java.lang.String processDataFilename(java.lang.String filename,
                                               int index)

Process the file name to get a file that we can use to write to local disk

Overrides:

processDataFilename in class FilesDataSource

Parameters:

filename - Filename

index - Which file it it. This can be used by derived classes to add more info to the file name

Returns:

The processed filename

getInputStreams

protected java.util.List getInputStreams(java.util.List processedSources)
                                  throws java.lang.Exception

Get the list of input streams used to make data local

Overrides:

getInputStreams in class FilesDataSource

Parameters:

processedSources - Source paths

Returns:

List of input streams

Throws:

java.lang.Exception - On badness

setTimeWindow

public void setTimeWindow(double value)

Set the TimeWindow property.

Parameters:

value - The new value for TimeWindow

getTimeWindow

public double getTimeWindow()

Get the TimeWindow property.

Returns:

The TimeWindow

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

test main

Parameters:

args - args

Throws:

java.lang.Exception - On badness