ucar.nc2.ft

Class FeatureDatasetImpl

java.lang.Object

ucar.nc2.ft.FeatureDatasetImpl

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, FeatureDataset, FileCacheable

Direct Known Subclasses:

PointDatasetImpl

public abstract class FeatureDatasetImpl
extends java.lang.Object
implements FeatureDataset

Abstract superclass for implementations of FeatureDataset. Subclass must implement getFeatureClass(), and add specific functionality. Also set dataVariables

Since:

Sep 7, 2007

Field Summary

Fields

Modifier and Type	Field and Description
protected LatLonRect	boundingBox
protected java.util.List<VariableSimpleIF>	dataVariables
protected CalendarDateRange	dateRange
protected java.lang.String	desc
protected FileCacheIF	fileCache
protected java.lang.String	location
protected NetcdfDataset	netcdfDataset
protected java.util.Formatter	parseInfo
protected java.lang.String	title

Constructor Summary

Constructors

Modifier	Constructor and Description
	FeatureDatasetImpl() No-arg constuctor
protected	FeatureDatasetImpl(FeatureDatasetImpl from)
	FeatureDatasetImpl(NetcdfDataset netcdfDataset) Constructor when theres a NetcdfFile underneath
	FeatureDatasetImpl(java.lang.String title, java.lang.String description, java.lang.String location) Constructor when theres no NetcdfFile underneath.

Method Summary

Modifier and Type	Method and Description
AttributeContainer	attributes() Get the global attributes.
void	close() Close all resources associated with this dataset.
Attribute	findGlobalAttributeIgnoreCase(java.lang.String name) Deprecated. use attributes()
LatLonRect	getBoundingBox() The lat/lon boundingBox for the entire dataset.
CalendarDate	getCalendarDateEnd() Ending Calendar date for the entire dataset.
CalendarDateRange	getCalendarDateRange() Calendar Date range for the entire dataset.
CalendarDate	getCalendarDateStart() Starting Calendar date for the entire dataset.
VariableSimpleIF	getDataVariable(java.lang.String shortName) Get the named data Variable.
java.util.List<VariableSimpleIF>	getDataVariables() The data Variables available in this dataset.
java.lang.String	getDescription() Text information about this dataset.
void	getDetailInfo(java.util.Formatter sf) Show debug / underlying implementation details
java.util.List<Attribute>	getGlobalAttributes() Deprecated. use attributes()
java.lang.String	getImplementationName() Show who is implementing
long	getLastModified() Returns the time that the underlying file(s) were last modified.
java.lang.String	getLocation() The URI location of the dataset
NetcdfFile	getNetcdfFile() Return underlying NetcdfFile, or null if none.
java.lang.String	getTitle() Title of the dataset.
void	reacquire() Deprecated. do not use
void	release() Deprecated. do not use
void	setBoundingBox(LatLonRect boundingBox)
void	setDateRange(CalendarDateRange dateRange)
protected void	setDescription(java.lang.String desc)
void	setFileCache(FileCacheIF fileCache) Deprecated. do not use
protected void	setLocationURI(java.lang.String location)
protected void	setTitle(java.lang.String title)

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.nc2.ft.FeatureDataset

getFeatureType

Field Detail

netcdfDataset

protected NetcdfDataset netcdfDataset

title

protected java.lang.String title

desc

protected java.lang.String desc

location

protected java.lang.String location

dataVariables

protected java.util.List<VariableSimpleIF> dataVariables

parseInfo

protected java.util.Formatter parseInfo

dateRange

protected CalendarDateRange dateRange

boundingBox

protected LatLonRect boundingBox

fileCache

protected FileCacheIF fileCache

Constructor Detail

FeatureDatasetImpl

protected FeatureDatasetImpl(FeatureDatasetImpl from)

FeatureDatasetImpl

public FeatureDatasetImpl()

No-arg constuctor

FeatureDatasetImpl

public FeatureDatasetImpl(java.lang.String title,
                          java.lang.String description,
                          java.lang.String location)

Constructor when theres no NetcdfFile underneath.

Parameters:

title - title of the dataset.

description - description of the dataset.

location - URI of the dataset

FeatureDatasetImpl

public FeatureDatasetImpl(NetcdfDataset netcdfDataset)

Constructor when theres a NetcdfFile underneath

Parameters:

netcdfDataset - adapt this NetcdfDataset

Method Detail

setTitle

protected void setTitle(java.lang.String title)

setDescription

protected void setDescription(java.lang.String desc)

setLocationURI

protected void setLocationURI(java.lang.String location)

setDateRange

public void setDateRange(CalendarDateRange dateRange)

setBoundingBox

public void setBoundingBox(LatLonRect boundingBox)

getNetcdfFile

public NetcdfFile getNetcdfFile()

Description copied from interface: FeatureDataset

Return underlying NetcdfFile, or null if none.

Specified by:

getNetcdfFile in interface FeatureDataset

Returns:

the underlying NetcdfFile, or null if none.

getTitle

public java.lang.String getTitle()

Description copied from interface: FeatureDataset

Title of the dataset.

Specified by:

getTitle in interface FeatureDataset

Returns:

the title of the dataset, or null

getDescription

public java.lang.String getDescription()

Description copied from interface: FeatureDataset

Text information about this dataset.

Specified by:

getDescription in interface FeatureDataset

Returns:

any text information about this dataset, or null.

getLocation

public java.lang.String getLocation()

Description copied from interface: FeatureDataset

The URI location of the dataset

Specified by:

getLocation in interface FeatureDataset

Specified by:

getLocation in interface FileCacheable

Returns:

the URI location of the dataset, or null

attributes

public AttributeContainer attributes()

Description copied from interface: FeatureDataset

Get the global attributes.

Specified by:

attributes in interface FeatureDataset

getGlobalAttributes

@Deprecated
public java.util.List<Attribute> getGlobalAttributes()

Deprecated. use attributes()

Description copied from interface: FeatureDataset

List of global attributes.

Specified by:

getGlobalAttributes in interface FeatureDataset

Returns:

List of type ucar.nc2.Attribute, may be empty but not null

findGlobalAttributeIgnoreCase

@Deprecated
public Attribute findGlobalAttributeIgnoreCase(java.lang.String name)

Deprecated. use attributes()

Description copied from interface: FeatureDataset

Return the global attribute with the given name, ignoring case.

Specified by:

findGlobalAttributeIgnoreCase in interface FeatureDataset

Parameters:

name - attribute name

Returns:

the global attribute, or null

getDetailInfo

public void getDetailInfo(java.util.Formatter sf)

Description copied from interface: FeatureDataset

Show debug / underlying implementation details

Specified by:

getDetailInfo in interface FeatureDataset

Parameters:

sf - append info here

getCalendarDateRange

public CalendarDateRange getCalendarDateRange()

Description copied from interface: FeatureDataset

Calendar Date range for the entire dataset.

Specified by:

getCalendarDateRange in interface FeatureDataset

Returns:

the date range for the entire dataset, or null if unknown

getCalendarDateStart

public CalendarDate getCalendarDateStart()

Description copied from interface: FeatureDataset

Starting Calendar date for the entire dataset.

Specified by:

getCalendarDateStart in interface FeatureDataset

Returns:

the starting date for the entire dataset, or null if unknown

getCalendarDateEnd

public CalendarDate getCalendarDateEnd()

Description copied from interface: FeatureDataset

Ending Calendar date for the entire dataset.

Specified by:

getCalendarDateEnd in interface FeatureDataset

Returns:

the ending date for the entire dataset, or null if unknown

getBoundingBox

public LatLonRect getBoundingBox()

Description copied from interface: FeatureDataset

The lat/lon boundingBox for the entire dataset.

Specified by:

getBoundingBox in interface FeatureDataset

Returns:

the lat/lon boundingBox for the entire dataset, or null if unknown.

getDataVariables

public java.util.List<VariableSimpleIF> getDataVariables()

Description copied from interface: FeatureDataset

The data Variables available in this dataset. Should just be data variables others might be searching for, not metadata or coordinate system variables, etc. The shapes of the VariableSimpleIF do not necessarily match the StructureData member.

Specified by:

getDataVariables in interface FeatureDataset

Returns:

List of subclass of VariableSimpleIF, may be empty but not null

getDataVariable

public VariableSimpleIF getDataVariable(java.lang.String shortName)

Description copied from interface: FeatureDataset

Get the named data Variable.

Specified by:

getDataVariable in interface FeatureDataset

Parameters:

shortName - of data Variable.

Returns:

VariableSimpleIF or null if not found

getImplementationName

public java.lang.String getImplementationName()

Description copied from interface: FeatureDataset

Show who is implementing

Specified by:

getImplementationName in interface FeatureDataset

Returns:

name of implementor

close

public void close()
           throws java.io.IOException

Description copied from interface: FeatureDataset

Close all resources associated with this dataset.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface FeatureDataset

Specified by:

close in interface FileCacheable

Throws:

java.io.IOException - on io error

release

@Deprecated
public void release()
                         throws java.io.IOException

Deprecated. do not use

Description copied from interface: FileCacheable

Release any system resources like file handles. Optional, implement only if you are able to reacquire. Used when object is made inactive in cache.

Specified by:

release in interface FileCacheable

Throws:

java.io.IOException

reacquire

@Deprecated
public void reacquire()
                           throws java.io.IOException

Deprecated. do not use

Description copied from interface: FileCacheable

Reacquire any resources like file handles Used when reactivating in cache.

Specified by:

reacquire in interface FileCacheable

Throws:

java.io.IOException

getLastModified

public long getLastModified()

Description copied from interface: FileCacheable

Returns the time that the underlying file(s) were last modified. If they've changed since they were stored in the cache, they will be closed and reopened with FileFactory.

Specified by:

getLastModified in interface FileCacheable

Returns:

a long value representing the time the file(s) were last modified or 0L if the last-modified time couldn't be determined for any reason.

setFileCache

@Deprecated
public void setFileCache(FileCacheIF fileCache)

Deprecated. do not use

Description copied from interface: FileCacheable

If the FileCache is not null, FileCacheable.close() must call FileCache.release()

 public synchronized void close() throws java.io.IOException {
   if (cache != null) {
     if (cache.release(this))
       return;
   }
 
   reallyClose();
 }
 

Specified by:

setFileCache in interface FileCacheable

Parameters:

fileCache - must store this, use it on close as above.