ucar.nc2.dods

Class DODSNetcdfFile

java.lang.Object

ucar.nc2.NetcdfFile

ucar.nc2.dods.DODSNetcdfFile

All Implemented Interfaces:

FileCacheable

public class DODSNetcdfFile
extends NetcdfFile

Access to DODS datasets through the Netcdf API.

Author:

caron

See Also:

NetcdfFile

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debugAttributes
static boolean	debugCached
static boolean	debugCE
static boolean	debugCharArray
static boolean	debugConstruct
static boolean	debugConvertData
static boolean	debugDataResult
static boolean	debugOpenResult
static boolean	debugOpenTime
static boolean	debugPreload
static boolean	debugServerCall
static boolean	debugTime
static boolean	showNCfile

Fields inherited from class ucar.nc2.NetcdfFile

cache, cacheName, debugCompress, debugSPI, dimensions, gattributes, id, IOSP_MESSAGE_ADD_RECORD_STRUCTURE, IOSP_MESSAGE_CONVERT_RECORD_STRUCTURE, IOSP_MESSAGE_RANDOM_ACCESS_FILE, IOSP_MESSAGE_REMOVE_RECORD_STRUCTURE, location, reservedCdl, reservedFullName, reservedSectionSpec, rootGroup, showRequest, spi, title, variables

Constructor Summary

Constructors

Constructor and Description
DODSNetcdfFile(String datasetURL) Open a DODS file.
DODSNetcdfFile(String datasetURL, CancelTask cancelTask) Open a DODS file, allow user control over preloading string arrays and making structure data available through netcdf API.

Method Summary

Methods

Modifier and Type	Method and Description
static String	canonicalURL(String urlName) Create the canonical form of the URL.
void	close()
static int	convertToDODSType(DataType dataType, boolean isUnsigned) Get the DODS data class corresponding to the Netcdf data type.
static DataType	convertToNCType(BaseType dtype) Get the Netcdf data type corresponding to the DODS BaseType class.
static DataType	convertToNCType(int dodsDataType) Get the Netcdf data type corresponding to the DODS data type.
void	getDetailInfo(Formatter f)
static String	getDODSConstraintName(Variable var) Return a variable name suitable for use in a DAP constraint expression.
String	getFileTypeDescription()
String	getFileTypeId()
static boolean	isUnsigned(BaseType dtype) Get whether this is an unsigned type.
static boolean	isUnsigned(int dodsDataType) Get whether this is an unsigned type.
static void	main(String[] arg)
protected int[]	makeShape(DArray dodsArray)
List<Array>	readArrays(List<Variable> preloadVariables) Make a single call to the DODS Server to read all the named variable's data in one client/server roundtrip.
protected Array	readData(Variable v, Section section)
Array	readSection(String variableSection)
long	readToByteChannel(Variable v, Section section, WritableByteChannel channel)
Array	readWithCE(Variable v, String CE)
protected void	reGroup() Go thru the variables/structure-variables and their attributes and move to the proper groups.
protected void	reGroupVariable(Group rootgroup, DODSVariable dodsv) Deprecated.
protected void	reGroupVariableAttributes(Group rootgroup, Variable v)
static void	setAllowCompression(boolean b) Set whether to allow messages to be compressed.
static void	setAllowDeflate(boolean b) Deprecated. use setAllowCompression
static void	setAllowSessions(boolean b) Set whether to allow sessions by allowing cookies.
static void	setCoordinateVariablePreloadSize(int size) If preloading, set maximum size of coordinate variables to be preloaded.
static void	setDebugFlags(DebugFlags debugFlag) Debugging flags.
static void	setPreload(boolean b) Set whether small variables are preloaded; only turn off for debugging.

Methods inherited from class ucar.nc2.NetcdfFile

addAttribute, addDimension, addGroup, addStringVariable, addVariable, addVariable, addVariableAttribute, canOpen, empty, findAttribute, findAttValueIgnoreCase, findDimension, findGlobalAttribute, findGlobalAttributeIgnoreCase, findGroup, findVariable, findVariable, findVariableByAttribute, finish, getCacheName, getDetailInfo, getDimensions, getFileTypeVersion, getGlobalAttributes, getId, getIosp, getLastModified, getLocation, getRootGroup, getStructureIterator, getTitle, getUnlimitedDimension, getVariables, hasUnlimitedDimension, iospRegistered, makeFullName, makeFullName, makeFullNameSectionSpec, makeFullNameWithString, makeNameUnescaped, makeRecordStructure, makeRootGroup, makeValidCDLName, makeValidCdmObjectName, makeValidPathName, makeValidSectionSpecName, open, open, open, open, open, openInMemory, openInMemory, openInMemory, openInMemory, read, readAttributeDouble, readAttributeInteger, readToOutputStream, registerIOProvider, registerIOProvider, registerIOProvider, removeDimension, removeRecordStructure, removeVariable, sendIospMessage, setCacheName, setFileCache, setId, setImmutable, setLocation, setProperty, setTitle, showCached, showProxies, syncExtend, toString, toStringDebug, toStringEnd, toStringStart, toStringStart, writeCDL, writeCDL, writeCDL, writeNcML, writeNcML

Methods inherited from class java.lang.Object

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

Field Detail

debugCE

public static boolean debugCE

debugServerCall

public static boolean debugServerCall

debugOpenResult

public static boolean debugOpenResult

debugDataResult

public static boolean debugDataResult

debugCharArray

public static boolean debugCharArray

debugConvertData

public static boolean debugConvertData

debugConstruct

public static boolean debugConstruct

debugPreload

public static boolean debugPreload

debugTime

public static boolean debugTime

showNCfile

public static boolean showNCfile

debugAttributes

public static boolean debugAttributes

debugCached

public static boolean debugCached

debugOpenTime

public static boolean debugOpenTime

Constructor Detail

DODSNetcdfFile

public DODSNetcdfFile(String datasetURL)
               throws IOException

Open a DODS file.

Parameters:

datasetURL - URL of the file. This should start with the protocol "dods:" It may also start with protocol "http:".

Throws:

IOException - on io error

MalformedURLException

DODSNetcdfFile

public DODSNetcdfFile(String datasetURL,
              CancelTask cancelTask)
               throws IOException

Open a DODS file, allow user control over preloading string arrays and making structure data available through netcdf API.

Parameters:

datasetURL - URL of the file. This should start with the protocol "dods:" or "http:".

cancelTask - check if task is cancelled. may be null.

Throws:

IOException - on io error

MalformedURLException

Method Detail

setAllowSessions

public static void setAllowSessions(boolean b)

Set whether to allow sessions by allowing cookies. This only affects requests to the TDS. Setting this to true can eliminate consistency problems for datasets that are being updated.

Parameters:

b - true or false. default is false.

setAllowDeflate

public static void setAllowDeflate(boolean b)

Deprecated. use setAllowCompression

Set whether to allow messages to be compressed.

Parameters:

b - true or false.

setAllowCompression

public static void setAllowCompression(boolean b)

Set whether to allow messages to be compressed.

Parameters:

b - true or false.

setDebugFlags

public static void setDebugFlags(DebugFlags debugFlag)

Debugging flags. This is a way to decouple setting flags from particular implementations.

Parameters:

debugFlag - set of debug flags.

setPreload

public static void setPreload(boolean b)

Set whether small variables are preloaded; only turn off for debugging.

Parameters:

b - true if small variables are preloaded (default true)

setCoordinateVariablePreloadSize

public static void setCoordinateVariablePreloadSize(int size)

If preloading, set maximum size of coordinate variables to be preloaded.

Parameters:

size - maximum size of coordinate variables to be preloaded.

canonicalURL

public static String canonicalURL(String urlName)

Create the canonical form of the URL. If the urlName starts with "http:" or "https:", change it to start with "dods:", otherwise leave it alone.

Parameters:

urlName - the url string

Returns:

canonical form

close

public void close()
           throws IOException

Specified by:

close in interface FileCacheable

Overrides:

close in class NetcdfFile

Throws:

IOException

reGroup

protected void reGroup()
                throws DAP2Exception

Go thru the variables/structure-variables and their attributes and move to the proper groups.

Throws:

DAP2Exception

reGroupVariable

@Deprecated
protected void reGroupVariable(Group rootgroup,
                              DODSVariable dodsv)
                        throws DAP2Exception

Deprecated.

Throws:

DAP2Exception

reGroupVariableAttributes

protected void reGroupVariableAttributes(Group rootgroup,
                             Variable v)
                                  throws DAP2Exception

Throws:

DAP2Exception

makeShape

protected int[] makeShape(DArray dodsArray)

getDODSConstraintName

public static String getDODSConstraintName(Variable var)

Return a variable name suitable for use in a DAP constraint expression. [Original code seemed wrong because structures can be nested and hence would have to use the full name just like non-structures]

Parameters:

var - The variable whose name will appear in the CE

Returns:

The name in a form suitable for use in a cE

convertToDODSType

public static int convertToDODSType(DataType dataType,
                    boolean isUnsigned)

Get the DODS data class corresponding to the Netcdf data type. This is the inverse of convertToNCType().

Parameters:

dataType - Netcdf data type.

isUnsigned - if its unsigned

Returns:

the corresponding DODS type enum, from opendap.dap.Attribute.XXXX.

convertToNCType

public static DataType convertToNCType(int dodsDataType)

Get the Netcdf data type corresponding to the DODS data type. This is the inverse of convertToDODSType().

Parameters:

dodsDataType - DODS type enum, from dods.dap.Attribute.XXXX.

Returns:

the corresponding netcdf DataType.

See Also:

isUnsigned(int)

isUnsigned

public static boolean isUnsigned(int dodsDataType)

Get whether this is an unsigned type.

Parameters:

dodsDataType - DODS type enum, from dods.dap.Attribute.XXXX.

Returns:

true if unsigned

convertToNCType

public static DataType convertToNCType(BaseType dtype)

Get the Netcdf data type corresponding to the DODS BaseType class. This is the inverse of convertToDODSType().

Parameters:

dtype - DODS BaseType.

Returns:

the corresponding netcdf DataType.

See Also:

isUnsigned(int)

isUnsigned

public static boolean isUnsigned(BaseType dtype)

Get whether this is an unsigned type.

Parameters:

dtype - DODS BaseType.

Returns:

true if unsigned

readArrays

public List<Array> readArrays(List<Variable> preloadVariables)
                       throws IOException

Make a single call to the DODS Server to read all the named variable's data in one client/server roundtrip.

Overrides:

readArrays in class NetcdfFile

Parameters:

preloadVariables - list of type Variable

Returns:

list of type Array, contains the data

Throws:

IOException - on error

readSection

public Array readSection(String variableSection)
                  throws IOException,
                         InvalidRangeException

Overrides:

readSection in class NetcdfFile

Throws:

IOException

InvalidRangeException

readData

protected Array readData(Variable v,
             Section section)
                  throws IOException,
                         InvalidRangeException

Overrides:

readData in class NetcdfFile

Throws:

IOException

InvalidRangeException

readToByteChannel

public long readToByteChannel(Variable v,
                     Section section,
                     WritableByteChannel channel)
                       throws IOException,
                              InvalidRangeException

Overrides:

readToByteChannel in class NetcdfFile

Throws:

IOException

InvalidRangeException

readWithCE

public Array readWithCE(Variable v,
               String CE)
                 throws IOException

Throws:

IOException

getDetailInfo

public void getDetailInfo(Formatter f)

Overrides:

getDetailInfo in class NetcdfFile

getFileTypeId

public String getFileTypeId()

Overrides:

getFileTypeId in class NetcdfFile

getFileTypeDescription

public String getFileTypeDescription()

Overrides:

getFileTypeDescription in class NetcdfFile

main

public static void main(String[] arg)