ucar.nc2.ft
Class FeatureDatasetFactoryManager

java.lang.Object
  ucar.nc2.ft.FeatureDatasetFactoryManager

public class FeatureDatasetFactoryManager
extends java.lang.Object

Manager of factories for FeatureDatasets. This supercedes ucar.nc2.dt.TypedDatasetFactory

all point fetures are going throuh PointDatasetStandardFactory, which uses TableAna;yzer to deal with specific datasets.

Since:

Mar 19, 2008

Author:

caron

Constructor Summary

FeatureDatasetFactoryManager()

Method Summary

static boolean	featureTypeOk(FeatureType want, FeatureType facType) Determine if factory type matches wanted feature type.
static FeatureDataset	open(FeatureType datatype, java.lang.String location, CancelTask task, java.util.Formatter errlog) Open a dataset as a FeatureDataset.
static void	registerFactory(FeatureType datatype, java.lang.Class c) Register a class that implements a FeatureDatasetFactory.
static void	registerFactory(FeatureType datatype, java.lang.String className) Register a class that implements a FeatureDatasetFactory.
static FeatureDataset	wrap(FeatureType featureType, NetcdfDataset ncd, CancelTask task, java.util.Formatter errlog) Wrap a NetcdfDataset as a FeatureDataset.

Methods inherited from class java.lang.Object

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

Constructor Detail

FeatureDatasetFactoryManager

public FeatureDatasetFactoryManager()

Method Detail

registerFactory

public static void registerFactory(FeatureType datatype,
                                   java.lang.String className)
                            throws java.lang.ClassNotFoundException

Register a class that implements a FeatureDatasetFactory.

Parameters:

className - name of class that implements FeatureDatasetFactory.

datatype - scientific data type

Throws:

java.lang.ClassNotFoundException - if loading error

registerFactory

public static void registerFactory(FeatureType datatype,
                                   java.lang.Class c)

Register a class that implements a FeatureDatasetFactory.

Parameters:

datatype - scientific data type

c - class that implements FeatureDatasetFactory.

open

public static FeatureDataset open(FeatureType datatype,
                                  java.lang.String location,
                                  CancelTask task,
                                  java.util.Formatter errlog)
                           throws java.io.IOException

Open a dataset as a FeatureDataset.

Parameters:

datatype - open this kind of FeatureDataset; may be null, which means search all factories. If datatype is not null, only return correct FeatureDataset (eg PointFeatureDataset for DataType.POINT).

location - URL or file location of the dataset

task - user may cancel

errlog - place errors here, may not be null

Returns:

a subclass of FeatureDataset, or null if no factory was found

Throws:

java.io.IOException - on io error

wrap

public static FeatureDataset wrap(FeatureType featureType,
                                  NetcdfDataset ncd,
                                  CancelTask task,
                                  java.util.Formatter errlog)
                           throws java.io.IOException

Wrap a NetcdfDataset as a FeatureDataset.

Parameters:

featureType - open this kind of FeatureDataset; may be null, which means search all factories. If datatype is not null, only return FeatureDataset with objects of that type

ncd - the NetcdfDataset to wrap as a FeatureDataset

task - user may cancel

errlog - place errors here, may not be null

Returns:

a subclass of FeatureDataset, or null if no factory was found

Throws:

java.io.IOException - on io error

featureTypeOk

public static boolean featureTypeOk(FeatureType want,
                                    FeatureType facType)

Determine if factory type matches wanted feature type.

Parameters:

want - looking for this FeatureType

facType - factory is of this type

Returns:

true if match