ucar.nc2.internal.ncml

Class NcmlReader

java.lang.Object

ucar.nc2.internal.ncml.NcmlReader

public class NcmlReader
extends Object

Read NcML and create NetcdfDataset.Builder, using builders and immutable objects.

This is an internal class, users should usually call NetcdfDatasets.openDataset(String)

Constructor Summary

Constructors

Constructor and Description
NcmlReader()

Method Summary

Modifier and Type	Method and Description
static Array<?>	readAttributeValues(org.jdom2.Element s) Parse the values element
static NetcdfDataset.Builder<?>	readNcml(Reader r, String ncmlLocation, CancelTask cancelTask) Read NcML doc from a Reader, and construct a NetcdfDataset.Builder.
static NetcdfDataset.Builder<?>	readNcml(String ncmlLocation, String referencedDatasetUri, CancelTask cancelTask) Read an NcML file from a URL location, and construct a NetcdfDataset.
static void	setDebugFlags(DebugFlags debugFlag)
static void	wrapNcml(NetcdfDataset.Builder<?> ncDataset, String ncmlLocation, CancelTask cancelTask) Use NCML to modify the dataset, getting NcML from a URL.
static void	wrapNcmlResource(NetcdfDataset.Builder<?> ncDataset, String ncmlResourceLocation, CancelTask cancelTask) Use NCML to modify a dataset, getting the NcML document as a resource stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

NcmlReader

public NcmlReader()

Method Detail

setDebugFlags

public static void setDebugFlags(DebugFlags debugFlag)

wrapNcml

public static void wrapNcml(NetcdfDataset.Builder<?> ncDataset,
                            String ncmlLocation,
                            CancelTask cancelTask)
                     throws IOException

Use NCML to modify the dataset, getting NcML from a URL. Used by CoordSysFactory.

Parameters:

ncDataset - modify this dataset

ncmlLocation - URL location of NcML

cancelTask - allow user to cancel task; may be null

Throws:

IOException - on read error

wrapNcmlResource

public static void wrapNcmlResource(NetcdfDataset.Builder<?> ncDataset,
                                    String ncmlResourceLocation,
                                    CancelTask cancelTask)
                             throws IOException

Use NCML to modify a dataset, getting the NcML document as a resource stream. Uses ClassLoader.getResourceAsStream(ncmlResourceLocation), so the NcML can be inside of a jar file, for example.

Parameters:

ncDataset - modify this dataset

ncmlResourceLocation - resource location of NcML

cancelTask - allow user to cancel task; may be null

Throws:

IOException - on read error

readNcml

public static NetcdfDataset.Builder<?> readNcml(Reader r,
                                                String ncmlLocation,
                                                CancelTask cancelTask)
                                         throws IOException

Read NcML doc from a Reader, and construct a NetcdfDataset.Builder. This is an internal method, users should use NetcdfDatasets.openNcmlDataset(Reader, String, CancelTask)

Parameters:

r - the Reader containing the NcML document

ncmlLocation - the URL location string of the NcML document, used to resolve reletive path of the referenced dataset, or may be just a unique name for caching purposes.

cancelTask - allow user to cancel the task; may be null

Returns:

the resulting NetcdfDataset.Builder

Throws:

IOException - on read error, or bad referencedDatasetUri URI

readNcml

public static NetcdfDataset.Builder<?> readNcml(String ncmlLocation,
                                                String referencedDatasetUri,
                                                CancelTask cancelTask)
                                         throws IOException

Read an NcML file from a URL location, and construct a NetcdfDataset.

Parameters:

ncmlLocation - the URL location string of the NcML document

referencedDatasetUri - if null (usual case) get this from NcML, otherwise use URI as the location of the referenced dataset.

cancelTask - allow user to cancel the task; may be null

Returns:

the resulting NetcdfDataset

Throws:

IOException - on read error, or bad referencedDatasetUri URI

readAttributeValues

public static Array<?> readAttributeValues(org.jdom2.Element s)
                                    throws IllegalArgumentException

Parse the values element

Parameters:

s - JDOM element to parse

Returns:

Array with parsed values

Throws:

IllegalArgumentException - if string values not parsable to specified data type