ucar.nc2.util.cache

Interface FileCacheable

All Known Subinterfaces:

FeatureDataset, FeatureDatasetPoint, RadialDatasetSweep, StationRadialDataset, StationRadialDataset

All Known Implementing Classes:

CdmRemote, CFnetCDF2Dataset, Dorade2Dataset, FeatureDatasetImpl, GridDataset, HTTPRandomAccessFile, InMemoryRandomAccessFile, LevelII2Dataset, Netcdf2Dataset, NetcdfDataset, NetcdfFile, NetcdfFileWriteable, Nids2Dataset, PointDatasetImpl, PointDatasetRemote, RadialDatasetSweepAdapter, RandomAccessFile, UF2Dataset

public interface FileCacheable

Interface for files that can be stored in FileCache.

Since:

Jun 2, 2008

Author:

caron

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close the FileCacheable, release all resources.
String	getLocation() The location of the FileCacheable.
void	setFileCache(FileCache fileCache) If the FileCache is set, the FileCacheable object must store it and call FileCache.release() on FileCacheable.close():
boolean	sync() Sync() is called when the FileCacheable is found in the cache, before returning the object to the application.

Method Detail

getLocation

String getLocation()

The location of the FileCacheable.

Returns:

location

close

void close()
           throws IOException

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

Throws:

IOException - on io error

sync

boolean sync()
             throws 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 may ignore this call.

Returns:

true if FileCacheable was changed

Throws:

IOException - on i/o error.

setFileCache

void setFileCache(FileCache fileCache)

If the FileCache is set, the FileCacheable object must store it and call FileCache.release() on FileCacheable.close():

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

Parameters:

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