ucar.nc2.grib.collection

Class GribCollectionImmutable

java.lang.Object

ucar.nc2.grib.collection.GribCollectionImmutable

All Implemented Interfaces:

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

Direct Known Subclasses:

Grib1Collection, Grib2Collection, PartitionCollectionImmutable

@Immutable
public abstract class GribCollectionImmutable
extends java.lang.Object
implements java.io.Closeable, FileCacheable

An Immutable GribCollection, corresponds to one index (ncx) file. The index file has already been read; it is opened and the closed when a variable is first accessed to read in the record array (sa).

Since:

11/10/2014

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	GribCollectionImmutable.Dataset
class	GribCollectionImmutable.GroupGC
static class	GribCollectionImmutable.Info
static class	GribCollectionImmutable.Record
static class	GribCollectionImmutable.Type
class	GribCollectionImmutable.VariableIndex

Field Summary

Fields

Modifier and Type	Field and Description
protected FeatureCollectionConfig	config
static int	countGC
protected GribTables	cust
protected java.util.List<GribCollectionImmutable.Dataset>	datasets
protected java.io.File	directory
protected java.util.Map<java.lang.Integer,MFile>	fileMap
protected java.util.List<GribHorizCoordSystem>	horizCS
protected java.lang.String	indexFilename
protected GribCollectionImmutable.Info	info
boolean	isGrib1
protected CoordinateRuntime	masterRuntime
protected java.lang.String	name
protected FileCacheIF	objCache

Method Summary

Modifier and Type	Method and Description
protected abstract void	addGlobalAttributes(java.util.List<Attribute> result)
void	close() Close the FileCacheable, release all resources.
MFile	findMFileByName(java.lang.String filename)
int	getBackProcessId()
int	getCenter()
RandomAccessFile	getDataRaf(int fileno)
GribCollectionImmutable.Dataset	getDataset(int idx)
GribCollectionImmutable.Dataset	getDatasetByTypeName(java.lang.String name)
GribCollectionImmutable.Dataset	getDatasetCanonical()
java.util.List<GribCollectionImmutable.Dataset>	getDatasets()
java.io.File	getDirectory()
java.lang.String	getFilename(int fileno)
java.util.Collection<MFile>	getFiles()
java.lang.String	getFirstFilename()
int	getGenProcessId()
int	getGenProcessType()
java.util.List<Attribute>	getGlobalAttributes()
abstract GridDataset	getGridDataset(GribCollectionImmutable.Dataset ds, GribCollectionImmutable.GroupGC group, java.lang.String filename, FeatureCollectionConfig gribConfig, java.util.Formatter errlog, org.slf4j.Logger logger)
long	getIndexFileSize()
long	getLastModified() Returns the time that the underlying file(s) were last modified.
int	getLocal()
java.lang.String	getLocation() The location of the FileCacheable.
int	getMaster()
CoordinateRuntime	getMasterRuntime()
java.lang.String	getName()
abstract NetcdfDataset	getNetcdfDataset(GribCollectionImmutable.Dataset ds, GribCollectionImmutable.GroupGC group, java.lang.String filename, FeatureCollectionConfig gribConfig, java.util.Formatter errlog, org.slf4j.Logger logger)
int	getSubcenter()
int	getVersion()
protected GribCollectionImmutable.VariableIndex	makeVariableIndex(GribCollectionImmutable.GroupGC group, GribCollectionMutable.VariableIndex mutableVar)
void	reacquire()
void	release()
void	setFileCache(FileCacheIF fileCache) If the FileCache is not null, FileCacheable.close() must call FileCache.release()
void	showIndex(java.util.Formatter f)
void	showIndexFile(java.util.Formatter f)
void	showStatus(java.util.Formatter f)
void	showStatusSummary(java.util.Formatter f, java.lang.String type)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

countGC

public static int countGC

name

protected final java.lang.String name

directory

protected final java.io.File directory

config

protected final FeatureCollectionConfig config

isGrib1

public final boolean isGrib1

info

protected final GribCollectionImmutable.Info info

datasets

protected final java.util.List<GribCollectionImmutable.Dataset> datasets

horizCS

protected final java.util.List<GribHorizCoordSystem> horizCS

masterRuntime

protected final CoordinateRuntime masterRuntime

fileMap

protected final java.util.Map<java.lang.Integer,MFile> fileMap

cust

protected final GribTables cust

indexFilename

protected final java.lang.String indexFilename

objCache

protected FileCacheIF objCache

Method Detail

makeVariableIndex

protected GribCollectionImmutable.VariableIndex makeVariableIndex(GribCollectionImmutable.GroupGC group,
                                                                  GribCollectionMutable.VariableIndex mutableVar)

getDatasets

public java.util.List<GribCollectionImmutable.Dataset> getDatasets()

getDataset

public GribCollectionImmutable.Dataset getDataset(int idx)

getDatasetByTypeName

public GribCollectionImmutable.Dataset getDatasetByTypeName(java.lang.String name)

getDatasetCanonical

public GribCollectionImmutable.Dataset getDatasetCanonical()

getName

public java.lang.String getName()

getDirectory

public java.io.File getDirectory()

getMasterRuntime

public CoordinateRuntime getMasterRuntime()

getVersion

public int getVersion()

getCenter

public int getCenter()

getSubcenter

public int getSubcenter()

getMaster

public int getMaster()

getLocal

public int getLocal()

getGenProcessType

public int getGenProcessType()

getGenProcessId

public int getGenProcessId()

getBackProcessId

public int getBackProcessId()

getGlobalAttributes

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

addGlobalAttributes

protected abstract void addGlobalAttributes(java.util.List<Attribute> result)

close

public void close()
           throws java.io.IOException

Description copied from interface: FileCacheable

Close the FileCacheable, release all resources. Must call cache.release(this) if cache is not null.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface FileCacheable

Throws:

java.io.IOException - on io error

release

public void release()
             throws java.io.IOException

Specified by:

release in interface FileCacheable

Throws:

java.io.IOException

reacquire

public void reacquire()
               throws java.io.IOException

Specified by:

reacquire in interface FileCacheable

Throws:

java.io.IOException

getLocation

public java.lang.String getLocation()

Description copied from interface: FileCacheable

The location of the FileCacheable. This must be sufficient for FileFactory.factory() to create the FileCacheable object

Specified by:

getLocation in interface FileCacheable

Returns:

location

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

public void setFileCache(FileCacheIF fileCache)

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.

showStatus

public void showStatus(java.util.Formatter f)

showStatusSummary

public void showStatusSummary(java.util.Formatter f,
                              java.lang.String type)

showIndexFile

public void showIndexFile(java.util.Formatter f)

showIndex

public void showIndex(java.util.Formatter f)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getIndexFileSize

public long getIndexFileSize()

getFilename

public java.lang.String getFilename(int fileno)

getFirstFilename

public java.lang.String getFirstFilename()

getFiles

public java.util.Collection<MFile> getFiles()

findMFileByName

public MFile findMFileByName(java.lang.String filename)

getDataRaf

public RandomAccessFile getDataRaf(int fileno)
                            throws java.io.IOException

Throws:

java.io.IOException

getNetcdfDataset

public abstract NetcdfDataset getNetcdfDataset(GribCollectionImmutable.Dataset ds,
                                               GribCollectionImmutable.GroupGC group,
                                               java.lang.String filename,
                                               FeatureCollectionConfig gribConfig,
                                               java.util.Formatter errlog,
                                               org.slf4j.Logger logger)
                                        throws java.io.IOException

Throws:

java.io.IOException

getGridDataset

public abstract GridDataset getGridDataset(GribCollectionImmutable.Dataset ds,
                                           GribCollectionImmutable.GroupGC group,
                                           java.lang.String filename,
                                           FeatureCollectionConfig gribConfig,
                                           java.util.Formatter errlog,
                                           org.slf4j.Logger logger)
                                    throws java.io.IOException

Throws:

java.io.IOException