ucar.nc2.grib

Class GribIndex

java.lang.Object

ucar.nc2.grib.GribIndex

Direct Known Subclasses:

Grib1Index, Grib2Index

public abstract class GribIndex
extends java.lang.Object

Abstract superclass for Grib1Index and Grib2Index. Handles gbx9 index for grib.

Static methods for creating gbx9 indices for a single file.

Since:

9/5/11

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debug
static java.lang.String	GBX9_IDX

Constructor Summary

Constructors

Constructor and Description
GribIndex()

Method Summary

Modifier and Type	Method and Description
static CollectionManager.ChangeChecker	getChangeChecker()
abstract int	getNRecords() The number of records in the index.
abstract boolean	makeIndex(java.lang.String location, RandomAccessFile dataRaf) Make the gbx9 index file.
static GribIndex	open(boolean isGrib1, MFile mfile)
abstract boolean	readIndex(java.lang.String location, long dataModified, CollectionUpdateType force) Read the gbx9 index file.
static GribIndex	readOrCreateIndexFromSingleFile(boolean isGrib1, MFile mfile, CollectionUpdateType force, org.slf4j.Logger logger) Create a gbx9 index from a single grib1 or grib2 file.

Methods inherited from class java.lang.Object

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

Field Detail

GBX9_IDX

public static final java.lang.String GBX9_IDX

See Also:

Constant Field Values

debug

public static final boolean debug

See Also:

Constant Field Values

Constructor Detail

GribIndex

public GribIndex()

Method Detail

getChangeChecker

public static CollectionManager.ChangeChecker getChangeChecker()

open

public static GribIndex open(boolean isGrib1,
                             MFile mfile)
                      throws java.io.IOException

Throws:

java.io.IOException

readOrCreateIndexFromSingleFile

public static GribIndex readOrCreateIndexFromSingleFile(boolean isGrib1,
                                                        MFile mfile,
                                                        CollectionUpdateType force,
                                                        org.slf4j.Logger logger)
                                                 throws java.io.IOException

Create a gbx9 index from a single grib1 or grib2 file. Use the existing index if it already exists.

Parameters:

isGrib1 - true if grib1

mfile - the grib file

force - force writing index

Returns:

the resulting GribIndex

Throws:

java.io.IOException - on io error

readIndex

public abstract boolean readIndex(java.lang.String location,
                                  long dataModified,
                                  CollectionUpdateType force)
                           throws java.io.IOException

Read the gbx9 index file.

Parameters:

location - location of the data file

dataModified - last modified date of the data file

force - rewrite? always, test, nocheck, never

Returns:

true if index was successfully read, false if index must be (re)created

Throws:

java.io.IOException - on io error

makeIndex

public abstract boolean makeIndex(java.lang.String location,
                                  RandomAccessFile dataRaf)
                           throws java.io.IOException

Make the gbx9 index file.

Parameters:

location - location of the data file

dataRaf - already opened data raf (leave open); if null, makeIndex opens and closes)

Returns:

true

Throws:

java.io.IOException - on io error

getNRecords

public abstract int getNRecords()

The number of records in the index.

Returns:

The number of records in the index.