ucar.nc2.util.cache
Interface FileCacheable

All Known Subinterfaces:

FeatureDataset, FeatureDatasetPoint, RadialDatasetSweep, StationRadialDataset, StationRadialDataset

All Known Implementing Classes:

AreaServiceProvider.MakeNetcdfFile, DODSNetcdfFile, Dorade2Dataset, FeatureDatasetImpl, FileCacheRaf.Raf, GempakGridServiceProvider.MakeNetcdfFile, GempakSurfaceIOSP.MakeNetcdfFile, GridDataset, LevelII2Dataset, NcStreamRemote, Netcdf2Dataset, NetcdfDataset, NetcdfFile, NetcdfFileWriteable, Nids2Dataset, PointDatasetImpl, PointDatasetRemote, RadialDatasetSweepAdapter, UF2Dataset

public interface FileCacheable

Interface for files that are cacheable.

Since:

Jun 2, 2008

Author:

caron

Method Summary

void	close() Close the FileCacheable, release all resources.
java.lang.String	getLocation() The location of the FileCacheable, used only for debug and log messages.
void	setFileCache(FileCache fileCache) FileCacheable must store the FileCache and call it on close():
boolean	sync() Sync() is called when the FileCacheable is found in the cache, before returning the object to the application.

Method Detail

getLocation

java.lang.String getLocation()

The location of the FileCacheable, used only for debug and log messages.

Returns:

location

close

void close()
           throws java.io.IOException

Close the FileCacheable, release all resources. Also must honor contract with setFileCache().

Throws:

java.io.IOException

sync

boolean sync()
             throws java.io.IOException

Sync() is called when the FileCacheable is found in the cache, before returning the object to the application. FileCacheable has an opportunity to freshen itself. FileCacheable mag ignore this call.

Returns:

true if FileCacheable was changed

Throws:

java.io.IOException - on i/o error.

setFileCache

void setFileCache(FileCache fileCache)

FileCacheable must store the FileCache and call it on close():

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

Parameters:

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