ucar.unidata.data.gis

Class ShapeFileDataSource

java.lang.Object

ucar.unidata.collab.SharableImpl

ucar.unidata.data.DataSourceImpl

ucar.unidata.data.FilesDataSource

ucar.unidata.data.gis.ShapeFileDataSource

All Implemented Interfaces:

Sharable, DataSource, DataSourceFactory, XmlPersistable

public class ShapeFileDataSource
extends FilesDataSource

DataSource for Shapefiles.

Version:

$Revision: 1.28 $ $Date: 2007/04/16 20:34:52 $

Author:

IDV development team

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_DBFILE Property id for the dbfile

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
ShapeFileDataSource() Dummy constructor so this object can get unpersisted.
ShapeFileDataSource(DataSourceDescriptor descriptor, java.lang.String source, java.util.Hashtable properties) Create a ShapeFileDataSource from the specification given.

Method Summary

Modifier and Type	Method and Description
boolean	applyProperties() _more_
boolean	canDoGeoSelection() _more_
protected boolean	canDoGeoSelectionStride() _more_
boolean	canSaveDataToLocalDisk() Is this data source capable of saving its data to local disk
protected void	doMakeDataChoices() Create the data choices associated with this source.
protected java.util.List	doMakeDateTimes() Create a list of times for this data source.
protected javax.swing.JComponent	doMakeGeoSubsetPropertiesComponent() _more_
double	getCoarseness() Get the Coarseness property.
protected visad.Data	getDataInner(DataChoice dataChoice, DataCategory category, DataSelection dataSelection, java.util.Hashtable requestProperties) Actually get the data identified by the given DataChoce.
void	initAfterUnpersistence() Initialize if being unpersisted.
static visad.Data	readMap(java.lang.String filename) _more_
void	reloadData() _more_
void	setCoarseness(double value) Set the Coarseness property.
protected boolean	shouldCache(visad.Data data) See if this DataSource should cache or not

Methods inherited from class ucar.unidata.data.FilesDataSource

doRemove, equals, getDataFileExtension, getDataPaths, getFilePath, getFullDescription, getInputStreams, getLocationsForPolling, getPartialDescription, getSource, getSources, haveSources, initAfterCreation, initWithPollingInfo, isFileBased, newFilesFromPolling, processDataFilename, propertiesChanged, 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, canDoGeoSelectionMap, canPoll, canShowParameter, checkForInitAfterUnPersistence, clearCachedData, clearFileCache, clearTimes, convertSourceFile, convertToFilesIfDirectory, createAutoDisplay, createCacheKey, createElement, decrOutstandingGetDataCalls, doDirectory, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, doMakeGeoSelectionPanel, 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, 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, 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, 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_DBFILE

public static final java.lang.String PROP_DBFILE

Property id for the dbfile

See Also:

Constant Field Values

Constructor Detail

ShapeFileDataSource

public ShapeFileDataSource()

Dummy constructor so this object can get unpersisted.

ShapeFileDataSource

public ShapeFileDataSource(DataSourceDescriptor descriptor,
                           java.lang.String source,
                           java.util.Hashtable properties)
                    throws visad.VisADException

Create a ShapeFileDataSource from the specification given.

Parameters:

descriptor - descriptor for the data source

source - of file file name (or directory)

properties - extra properties

Throws:

visad.VisADException - some problem occurred creating data

Method Detail

reloadData

public void reloadData()

_more_

Specified by:

reloadData in interface DataSource

Overrides:

reloadData in class FilesDataSource

canDoGeoSelection

public boolean canDoGeoSelection()

_more_

Specified by:

canDoGeoSelection in interface DataSource

Overrides:

canDoGeoSelection in class DataSourceImpl

Returns:

_more_

canDoGeoSelectionStride

protected boolean canDoGeoSelectionStride()

_more_

Overrides:

canDoGeoSelectionStride in class DataSourceImpl

Returns:

_more_

doMakeGeoSubsetPropertiesComponent

protected javax.swing.JComponent doMakeGeoSubsetPropertiesComponent()

_more_

Overrides:

doMakeGeoSubsetPropertiesComponent in class DataSourceImpl

Returns:

_more_

applyProperties

public boolean applyProperties()

_more_

Overrides:

applyProperties in class DataSourceImpl

Returns:

_more_

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

initAfterUnpersistence

public void initAfterUnpersistence()

Initialize if being unpersisted.

Specified by:

initAfterUnpersistence in interface DataSource

Overrides:

initAfterUnpersistence in class FilesDataSource

doMakeDataChoices

protected void doMakeDataChoices()

Create 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

visad.VisADException - VisAD problem

readMap

public static visad.Data readMap(java.lang.String filename)
                          throws java.lang.Exception

_more_

Parameters:

filename - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

shouldCache

protected boolean shouldCache(visad.Data data)

See if this DataSource should cache or not

Overrides:

shouldCache in class DataSourceImpl

Parameters:

data - Data to cache

Returns:

false

doMakeDateTimes

protected java.util.List doMakeDateTimes()

Create a list of times for this data source. Since shapefiles don't have any times, return an empty List.

Overrides:

doMakeDateTimes in class DataSourceImpl

Returns:

an empty List

setCoarseness

public void setCoarseness(double value)

Set the Coarseness property.

Parameters:

value - The new value for Coarseness

getCoarseness

public double getCoarseness()

Get the Coarseness property.

Returns:

The Coarseness