thredds.client.catalog.tools

Class DataFactory

java.lang.Object

thredds.client.catalog.tools.DataFactory

public class DataFactory
extends Object

DataFactory for THREDDS client catalogs

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DataFactory.Result Deprecated. FeatureDatasets will move to legacy in ver7, this class will become private.

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROTOCOL
static String	SCHEME

Constructor Summary

Constructors

Constructor and Description
DataFactory()

Method Summary

Modifier and Type	Method and Description
Access	chooseDatasetAccess(List<Access> accessList) Find the "best" access in case theres more than one, based on what the CDM knows how to open and use.
NetcdfDataset	openDataset(Access access, boolean acquire, CancelTask task, Formatter log) Try to open Access as a NetcdfDataset.
NetcdfDataset	openDataset(Dataset Dataset, boolean acquire, CancelTask task, Formatter log) Try to open as a NetcdfDataset.
NetcdfDataset	openDataset(String location, boolean acquire, CancelTask task, Formatter log) Open a NetcdfDataset from a URL location string.
DataFactory.Result	openFeatureDataset(Access access, CancelTask task) Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.
DataFactory.Result	openFeatureDataset(Dataset Dataset, CancelTask task) Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.
DataFactory.Result	openFeatureDataset(FeatureType wantFeatureType, Dataset ds, CancelTask task, DataFactory.Result result) Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.
DataFactory.Result	openFeatureDataset(FeatureType wantFeatureType, String urlString, CancelTask task) Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.
DataFactory.Result	openFeatureDataset(String urlString, CancelTask task) Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.
static void	setDebugFlags(DebugFlags debugFlag)
static void	setPreferAccess(ServiceType... prefer)
static void	setPreferCdm(boolean prefer)

Methods inherited from class java.lang.Object

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

Field Detail

PROTOCOL

public static final String PROTOCOL

See Also:

Constant Field Values

SCHEME

public static final String SCHEME

See Also:

Constant Field Values

Constructor Detail

DataFactory

public DataFactory()

Method Detail

setPreferCdm

public static void setPreferCdm(boolean prefer)

setPreferAccess

public static void setPreferAccess(ServiceType... prefer)

setDebugFlags

public static void setDebugFlags(DebugFlags debugFlag)

openFeatureDataset

@Deprecated
public DataFactory.Result openFeatureDataset(String urlString,
                                                          CancelTask task)
                                                   throws IOException

Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.

Open a FeatureDataset from a URL location string. Example URLS:

• http://localhost:8080/test/addeStationDataset.xml#surfaceHourly
• thredds:http://localhost:8080/test/addeStationDataset.xml#surfaceHourly
• thredds://localhost:8080/test/addeStationDataset.xml#surfaceHourly
• thredds:file:c:/test/data/catalog/addeStationDataset.xml#AddeSurfaceData (absolute file)
• thredds:resolve:resolveURL

Parameters:

urlString - [thredds:]catalog.xml#datasetId

task - may be null

Returns:

ThreddsDataFactory.Result check fatalError for validity

Throws:

IOException - on read error

openFeatureDataset

@Deprecated
public DataFactory.Result openFeatureDataset(FeatureType wantFeatureType,
                                                          String urlString,
                                                          CancelTask task)
                                                   throws IOException

Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.

Open a FeatureDataset from a URL location string, and a desired type (may by NONE or null).

Parameters:

wantFeatureType - desired feature type, may be NONE or null

urlString - [thredds:]catalog.xml#datasetId

task - may be null

Returns:

ThreddsDataFactory.Result check fatalError for validity

Throws:

IOException - on read error

openFeatureDataset

@Deprecated
 @Nonnull
public DataFactory.Result openFeatureDataset(Dataset Dataset,
                                                                     CancelTask task)
                                                              throws IOException

Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.

Open a FeatureDataset from an Dataset object, deciding on which Access to use.

Parameters:

Dataset - use this to figure out what type, how to open, etc

task - allow user to cancel; may be null

Returns:

ThreddsDataFactory.Result check fatalError for validity

Throws:

IOException - on read error

openFeatureDataset

@Deprecated
 @Nonnull
public DataFactory.Result openFeatureDataset(FeatureType wantFeatureType,
                                                                     Dataset ds,
                                                                     CancelTask task,
                                                                     DataFactory.Result result)
                                                              throws IOException

Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.

Throws:

IOException

openFeatureDataset

@Deprecated
public DataFactory.Result openFeatureDataset(Access access,
                                                          CancelTask task)
                                                   throws IOException

Deprecated. FeatureDatasets will move to legacy in ver7, this method will not be available here.

Open a FeatureDataset from an Access object.

Parameters:

access - use this Access.

task - may be null

Returns:

ThreddsDataFactory.Result check fatalError for validity

Throws:

IOException - on read error

openDataset

public NetcdfDataset openDataset(String location,
                                 boolean acquire,
                                 CancelTask task,
                                 Formatter log)
                          throws IOException

Open a NetcdfDataset from a URL location string. Example URLS:

• http://localhost:8080/test/addeStationDataset.xml#surfaceHourly
• thredds:http://localhost:8080/test/addeStationDataset.xml#surfaceHourly
• thredds://localhost:8080/test/addeStationDataset.xml#surfaceHourly
• thredds:file:c:/dev/netcdf-java-2.2/test/data/catalog/addeStationDataset.xml#AddeSurfaceData (absolute file)
• thredds:resolve:resolveURL

Parameters:

location - catalog.xml#datasetId, may optionally start with "thredds:"

task - may be null

log - error messages gp here, may be null

acquire - if true, aquire the dataset, else open it

Returns:

NetcdfDataset

Throws:

IOException - on read error

openDataset

public NetcdfDataset openDataset(Dataset Dataset,
                                 boolean acquire,
                                 CancelTask task,
                                 Formatter log)
                          throws IOException

Try to open as a NetcdfDataset.

Parameters:

Dataset - open this

acquire - if true, aquire the dataset, else open it

task - may be null

log - error message, may be null

Returns:

NetcdfDataset or null if failure

Throws:

IOException - on read error

openDataset

public NetcdfDataset openDataset(Access access,
                                 boolean acquire,
                                 CancelTask task,
                                 Formatter log)
                          throws IOException

Try to open Access as a NetcdfDataset.

Parameters:

access - open this Access

acquire - if true, aquire the dataset, else open it

task - may be null

log - error message, may be null

Returns:

NetcdfDataset or null if failure

Throws:

IOException - on read error

chooseDatasetAccess

public Access chooseDatasetAccess(List<Access> accessList)

Find the "best" access in case theres more than one, based on what the CDM knows how to open and use.

Parameters:

accessList - choose from this list.

Returns:

best access method.