ucar.nc2.ncml

Class Aggregation

java.lang.Object

ucar.nc2.ncml.Aggregation

All Implemented Interfaces:

AggregationIF

Direct Known Subclasses:

AggregationOuterDimension, AggregationTiled, AggregationUnion

Deprecated.

@Deprecated
public abstract class Aggregation
extends java.lang.Object
implements AggregationIF

Superclass for NcML Aggregation. An Aggregation acts as a ProxyReader for VariableDS. That, is it must implement:

 public Array read(Variable mainv);
 
 public Array read(Variable mainv, Section section);
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Aggregation.Dataset Deprecated. Encapsolates a NetcdfFile that is a component of the aggregation.
protected class	Aggregation.DatasetProxyReader Deprecated.
protected static class	Aggregation.Type Deprecated.
protected static class	Aggregation.TypicalDataset Deprecated.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	cacheDirty Deprecated.
protected MFileCollectionManager	datasetManager Deprecated.
protected java.util.List<Aggregation.Dataset>	datasets Deprecated.
protected java.lang.String	dateFormatMark Deprecated.
protected DateFormatter	dateFormatter Deprecated.
protected static boolean	debug Deprecated.
protected static boolean	debugConvert Deprecated.
protected static boolean	debugDateParse Deprecated.
protected static boolean	debugOpenFile Deprecated.
protected static boolean	debugProxy Deprecated.
protected static boolean	debugRead Deprecated.
protected static boolean	debugSyncDetail Deprecated.
protected java.lang.String	dimName Deprecated.
protected static DiskCache2	diskCache2 Deprecated.
protected static java.util.concurrent.Executor	executor Deprecated.
protected java.util.List<Aggregation.Dataset>	explicitDatasets Deprecated.
protected boolean	isDate Deprecated.
protected static org.slf4j.Logger	logger Deprecated.
protected NetcdfDataset	ncDataset Deprecated.
protected java.lang.Object	spiObject Deprecated.
protected Aggregation.Type	type Deprecated.
protected static Aggregation.TypicalDataset	typicalDatasetMode Deprecated.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Aggregation(NetcdfDataset ncd, java.lang.String dimName, Aggregation.Type type, java.lang.String recheckS) Deprecated. Create an Aggregation for the given NetcdfDataset.

Method Summary

Modifier and Type	Method and Description
void	addCollection(java.lang.String spec, java.lang.String olderThan) Deprecated.
void	addDataset(Aggregation.Dataset nested) Deprecated.
void	addDatasetScan(org.jdom2.Element crawlableDatasetElement, java.lang.String dirName, java.lang.String suffix, java.lang.String regexpPatternString, java.lang.String dateFormatMark, java.util.Set<NetcdfDataset.Enhance> enhanceMode, java.lang.String subdirs, java.lang.String olderThan) Deprecated. Add a dataset scan
void	addExplicitDataset(java.lang.String cacheName, java.lang.String location, java.lang.String id, java.lang.String ncoordS, java.lang.String coordValueS, java.lang.String sectionSpec, FileFactory reader) Deprecated. Add a nested dataset, specified by an explicit netcdf element.
protected abstract void	buildNetcdfDataset(CancelTask cancelTask) Deprecated. Call this to build the dataset objects in the NetcdfDataset
void	close() Deprecated.
protected Variable	findVariable(NetcdfFile ncfile, Variable mainV) Deprecated.
void	finish(CancelTask cancelTask) Deprecated.
java.util.List<Aggregation.Dataset>	getDatasets() Deprecated.
void	getDetailInfo(java.util.Formatter f) Deprecated.
java.lang.String	getDimensionName() Deprecated. Get dimension name to join on
java.lang.String	getFileTypeDescription() Deprecated.
java.lang.String	getFileTypeId() Deprecated.
long	getLastModified() Deprecated.
protected java.lang.String	getLocation() Deprecated.
Aggregation.Type	getType() Deprecated. Get type of aggregation
protected Aggregation.Dataset	getTypicalDataset() Deprecated. Open one of the nested datasets as a template for the aggregation dataset.
protected Aggregation.Dataset	makeDataset(MFile dset) Deprecated.
protected Aggregation.Dataset	makeDataset(java.lang.String cacheName, java.lang.String location, java.lang.String id, java.lang.String ncoordS, java.lang.String coordValueS, java.lang.String sectionSpec, java.util.EnumSet<NetcdfDataset.Enhance> enhance, FileFactory reader) Deprecated. Dataset factory, so subclasses can override
protected void	makeDatasets(CancelTask cancelTask) Deprecated. Make the list of Datasets, from explicit and scans.
protected void	persistRead() Deprecated. read info from the persistent XML file, if it exists; overridden in AggregationExisting
void	persistWrite() Deprecated. Allow information to be make persistent.
protected abstract void	rebuildDataset() Deprecated. Call this when rescan has found changed datasets
protected void	setDatasetAcquireProxy(Aggregation.Dataset typicalDataset, NetcdfDataset newds) Deprecated. All non-agg variables use a proxy to acquire the file before reading.
protected void	setDatasetAcquireProxy(Aggregation.DatasetProxyReader proxy, Group g) Deprecated.
static void	setExecutor(java.util.concurrent.Executor exec) Deprecated.
void	setModifications(org.jdom2.Element ncmlMods) Deprecated.
static void	setPersistenceCache(DiskCache2 dc) Deprecated.
static void	setTypicalDatasetMode(java.lang.String mode) Deprecated.
boolean	syncExtend() Deprecated. Check to see if its time to rescan directory, and if so, rescan and extend dataset if needed.

Methods inherited from class java.lang.Object

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

Field Detail

typicalDatasetMode

protected static Aggregation.TypicalDataset typicalDatasetMode

Deprecated.

logger

protected static org.slf4j.Logger logger

Deprecated.

diskCache2

protected static DiskCache2 diskCache2

Deprecated.

executor

protected static java.util.concurrent.Executor executor

Deprecated.

debug

protected static boolean debug

Deprecated.

debugOpenFile

protected static boolean debugOpenFile

Deprecated.

debugSyncDetail

protected static boolean debugSyncDetail

Deprecated.

debugProxy

protected static boolean debugProxy

Deprecated.

debugRead

protected static boolean debugRead

Deprecated.

debugDateParse

protected static boolean debugDateParse

Deprecated.

debugConvert

protected static boolean debugConvert

Deprecated.

ncDataset

protected NetcdfDataset ncDataset

Deprecated.

type

protected Aggregation.Type type

Deprecated.

spiObject

protected java.lang.Object spiObject

Deprecated.

explicitDatasets

protected java.util.List<Aggregation.Dataset> explicitDatasets

Deprecated.

datasets

protected java.util.List<Aggregation.Dataset> datasets

Deprecated.

datasetManager

protected MFileCollectionManager datasetManager

Deprecated.

cacheDirty

protected boolean cacheDirty

Deprecated.

dimName

protected java.lang.String dimName

Deprecated.

dateFormatMark

protected java.lang.String dateFormatMark

Deprecated.

isDate

protected boolean isDate

Deprecated.

dateFormatter

protected DateFormatter dateFormatter

Deprecated.

Constructor Detail

Aggregation

protected Aggregation(NetcdfDataset ncd,
                      java.lang.String dimName,
                      Aggregation.Type type,
                      java.lang.String recheckS)

Deprecated.

Create an Aggregation for the given NetcdfDataset. The following addXXXX methods are called, then finish(), before the object is ready for use.

Parameters:

ncd - Aggregation belongs to this NetcdfDataset

dimName - the aggregation dimension name

type - the Aggregation.Type

recheckS - how often to check if files have changes

Method Detail

setPersistenceCache

public static void setPersistenceCache(DiskCache2 dc)

Deprecated.

setExecutor

public static void setExecutor(java.util.concurrent.Executor exec)

Deprecated.

setTypicalDatasetMode

public static void setTypicalDatasetMode(java.lang.String mode)

Deprecated.

addExplicitDataset

public void addExplicitDataset(java.lang.String cacheName,
                               java.lang.String location,
                               java.lang.String id,
                               java.lang.String ncoordS,
                               java.lang.String coordValueS,
                               java.lang.String sectionSpec,
                               FileFactory reader)

Deprecated.

Add a nested dataset, specified by an explicit netcdf element. enhance is handled by the reader, so its always false here.

Parameters:

cacheName - a unique name to use for caching

location - attribute "location" on the netcdf element

id - attribute "id" on the netcdf element

ncoordS - attribute "ncoords" on the netcdf element

coordValueS - attribute "coordValue" on the netcdf element

sectionSpec - attribute "section" on the netcdf element

reader - factory for reading this netcdf dataset

addDataset

public void addDataset(Aggregation.Dataset nested)

Deprecated.

addDatasetScan

public void addDatasetScan(org.jdom2.Element crawlableDatasetElement,
                           java.lang.String dirName,
                           java.lang.String suffix,
                           java.lang.String regexpPatternString,
                           java.lang.String dateFormatMark,
                           java.util.Set<NetcdfDataset.Enhance> enhanceMode,
                           java.lang.String subdirs,
                           java.lang.String olderThan)

Deprecated.

Add a dataset scan

Parameters:

crawlableDatasetElement - defines a CrawlableDataset, or null

dirName - scan this directory

suffix - filter on this suffix (may be null)

regexpPatternString - include if full name matches this regular expression (may be null)

dateFormatMark - create dates from the filename (may be null)

enhanceMode - how should files be enhanced

subdirs - equals "false" if should not descend into subdirectories

olderThan - files must be older than this time (now - lastModified >= olderThan); must be a time unit, may ne bull

addCollection

public void addCollection(java.lang.String spec,
                          java.lang.String olderThan)

Deprecated.

setModifications

public void setModifications(org.jdom2.Element ncmlMods)

Deprecated.

getType

public Aggregation.Type getType()

Deprecated.

Get type of aggregation

Returns:

type of aggregation

getDimensionName

public java.lang.String getDimensionName()

Deprecated.

Get dimension name to join on

Returns:

dimension name or null if type union/tiled

getLocation

protected java.lang.String getLocation()

Deprecated.

close

public void close()
           throws java.io.IOException

Deprecated.

Specified by:

close in interface AggregationIF

Throws:

java.io.IOException

syncExtend

public boolean syncExtend()
                   throws java.io.IOException

Deprecated.

Check to see if its time to rescan directory, and if so, rescan and extend dataset if needed. Note that this just calls sync(), so structural metadata may be modified (!!)

Specified by:

syncExtend in interface AggregationIF

Returns:

true if directory was rescanned and dataset may have been updated

Throws:

java.io.IOException - on io error

getLastModified

public long getLastModified()

Deprecated.

Specified by:

getLastModified in interface AggregationIF

getFileTypeId

public java.lang.String getFileTypeId()

Deprecated.

Specified by:

getFileTypeId in interface AggregationIF

getFileTypeDescription

public java.lang.String getFileTypeDescription()

Deprecated.

Specified by:

getFileTypeDescription in interface AggregationIF

buildNetcdfDataset

protected abstract void buildNetcdfDataset(CancelTask cancelTask)
                                    throws java.io.IOException

Deprecated.

Call this to build the dataset objects in the NetcdfDataset

Parameters:

cancelTask - maybe cancel

Throws:

java.io.IOException - on read error

rebuildDataset

protected abstract void rebuildDataset()
                                throws java.io.IOException

Deprecated.

Call this when rescan has found changed datasets

Throws:

java.io.IOException - on read error

persistWrite

public void persistWrite()
                  throws java.io.IOException

Deprecated.

Allow information to be make persistent. Overridden in AggregationExisting

Specified by:

persistWrite in interface AggregationIF

Throws:

java.io.IOException - on error

persistRead

protected void persistRead()

Deprecated.

read info from the persistent XML file, if it exists; overridden in AggregationExisting

getDetailInfo

public void getDetailInfo(java.util.Formatter f)

Deprecated.

Specified by:

getDetailInfo in interface AggregationIF

finish

public void finish(CancelTask cancelTask)
            throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

getDatasets

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

Deprecated.

makeDatasets

protected void makeDatasets(CancelTask cancelTask)
                     throws java.io.IOException

Deprecated.

Make the list of Datasets, from explicit and scans.

Parameters:

cancelTask - user can cancel

Throws:

java.io.IOException - on i/o error

getTypicalDataset

protected Aggregation.Dataset getTypicalDataset()
                                         throws java.io.IOException

Deprecated.

Open one of the nested datasets as a template for the aggregation dataset.

Returns:

a typical Dataset

Throws:

java.io.IOException - if there are no datasets

makeDataset

protected Aggregation.Dataset makeDataset(java.lang.String cacheName,
                                          java.lang.String location,
                                          java.lang.String id,
                                          java.lang.String ncoordS,
                                          java.lang.String coordValueS,
                                          java.lang.String sectionSpec,
                                          java.util.EnumSet<NetcdfDataset.Enhance> enhance,
                                          FileFactory reader)

Deprecated.

Dataset factory, so subclasses can override

Parameters:

cacheName - a unique name to use for caching

location - attribute "location" on the netcdf element

id - attribute "id" on the netcdf element

ncoordS - attribute "ncoords" on the netcdf element

coordValueS - attribute "coordValue" on the netcdf element

sectionSpec - attribute "sectionSpec" on the netcdf element

enhance - open dataset in enhance mode NOT USED

reader - factory for reading this netcdf dataset

Returns:

a Aggregation.Dataset

makeDataset

protected Aggregation.Dataset makeDataset(MFile dset)

Deprecated.

setDatasetAcquireProxy

protected void setDatasetAcquireProxy(Aggregation.Dataset typicalDataset,
                                      NetcdfDataset newds)
                               throws java.io.IOException

Deprecated.

All non-agg variables use a proxy to acquire the file before reading. If the variable is caching, read data into cache now. If not caching, VariableEnhanced.setProxyReader() is called.

Parameters:

typicalDataset - read from a "typical dataset"

newds - containing dataset

Throws:

java.io.IOException - on i/o error

setDatasetAcquireProxy

protected void setDatasetAcquireProxy(Aggregation.DatasetProxyReader proxy,
                                      Group g)
                               throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

findVariable

protected Variable findVariable(NetcdfFile ncfile,
                                Variable mainV)

Deprecated.