dap4.cdm

Class DapNetcdfFile

java.lang.Object

ucar.nc2.NetcdfFile

dap4.cdm.DapNetcdfFile

All Implemented Interfaces:

java.lang.AutoCloseable, ucar.nc2.util.cache.FileCacheable

public class DapNetcdfFile
extends ucar.nc2.NetcdfFile

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DapNetcdfFile.NullCancelTask

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowCompression
protected java.util.Map<ucar.nc2.Variable,ucar.ma2.Array>	arraymap Originally, the array for a variable was stored using var.setCacheData().
protected ucar.nc2.util.CancelTask	cancel
protected boolean	closed
protected dap4.dap4shared.D4DSP	dsp
protected java.lang.String	finalurl
protected dap4.cdmshared.NodeMap	nodemap
protected static DapNetcdfFile.NullCancelTask	nullcancel
protected java.lang.String	originalurl
protected dap4.dap4shared.XURI	xuri

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
DapNetcdfFile(java.lang.String url) Open a Dap4 connection
DapNetcdfFile(java.lang.String url, ucar.nc2.util.CancelTask cancelTask) Open a Dap4 connection or file via a D4DSP.

Method Summary

Modifier and Type	Method and Description
void	close() Close all resources (files, sockets, etc) associated with this file.
dap4.dap4shared.DSP	getDSP()
java.lang.String	getURL()
boolean	isconstrainable()
java.util.List<ucar.ma2.Array>	readArrays(java.util.List<ucar.nc2.Variable> variables) Do a bulk read on a list of Variables and return a corresponding list of Array that contains the results of a full read on each Variable.
protected ucar.ma2.Array	readData(ucar.nc2.Variable cdmvar, ucar.ma2.Section section) Primary read entry point.
ucar.ma2.Array	readSection(java.lang.String variableSection)
long	readToByteChannel(ucar.nc2.Variable v, ucar.ma2.Section section, java.nio.channels.WritableByteChannel channel) Read databuffer from a top level Variable and send databuffer to a WritableByteChannel.

Methods inherited from class ucar.nc2.NetcdfFile

addAttribute, addAttribute, addDimension, addGroup, addStringVariable, addVariable, addVariable, addVariableAttribute, canOpen, empty, findAttribute, findAttValueIgnoreCase, findDimension, findGlobalAttribute, findGlobalAttributeIgnoreCase, findGroup, findVariable, findVariable, findVariableByAttribute, finish, getCacheName, getDetailInfo, getDetailInfo, getDimensions, getFileTypeDescription, getFileTypeId, getFileTypeVersion, getGlobalAttributes, getId, getIosp, getLastModified, getLocation, getRootGroup, getStructureIterator, getTitle, getUnlimitedDimension, getVariables, hasUnlimitedDimension, iospRegistered, main, makeFullName, makeFullName, makeFullNameSectionSpec, makeFullNameWithString, makeNameUnescaped, makeRecordStructure, makeRootGroup, makeValidCDLName, makeValidCdmObjectName, makeValidPathName, makeValidSectionSpecName, open, open, open, open, open, open, openInMemory, openInMemory, openInMemory, openInMemory, reacquire, read, readAttributeDouble, readAttributeInteger, readToOutputStream, registerIOProvider, registerIOProvider, registerIOProvider, release, removeDimension, removeRecordStructure, removeVariable, sendIospMessage, setCacheName, setDebugFlags, 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

nullcancel

protected static final DapNetcdfFile.NullCancelTask nullcancel

allowCompression

protected boolean allowCompression

closed

protected boolean closed

originalurl

protected java.lang.String originalurl

finalurl

protected java.lang.String finalurl

xuri

protected dap4.dap4shared.XURI xuri

dsp

protected dap4.dap4shared.D4DSP dsp

cancel

protected ucar.nc2.util.CancelTask cancel

nodemap

protected dap4.cdmshared.NodeMap nodemap

arraymap

protected java.util.Map<ucar.nc2.Variable,ucar.ma2.Array> arraymap

Originally, the array for a variable was stored using var.setCacheData(). However, that is illegal for Structures and Sequences, so (for now) we maintain a map variable->array.

Constructor Detail

DapNetcdfFile

public DapNetcdfFile(java.lang.String url,
                     ucar.nc2.util.CancelTask cancelTask)
              throws java.io.IOException

Open a Dap4 connection or file via a D4DSP.

Parameters:

url - URL for the request.

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

Throws:

java.io.IOException

DapNetcdfFile

public DapNetcdfFile(java.lang.String url)
              throws java.io.IOException

Open a Dap4 connection

Parameters:

url - URL for the request.

Throws:

java.io.IOException

Method Detail

close

public void close()
           throws java.io.IOException

Close all resources (files, sockets, etc) associated with this file.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface ucar.nc2.util.cache.FileCacheable

Overrides:

close in class ucar.nc2.NetcdfFile

Throws:

java.io.IOException - if error when closing

isconstrainable

public boolean isconstrainable()

Returns:

true if we can ask the server to do constraint processing

getURL

public java.lang.String getURL()

getDSP

public dap4.dap4shared.DSP getDSP()

readArrays

public java.util.List<ucar.ma2.Array> readArrays(java.util.List<ucar.nc2.Variable> variables)
                                          throws java.io.IOException

Do a bulk read on a list of Variables and return a corresponding list of Array that contains the results of a full read on each Variable. TODO: optimize to make only a single server call and cache the results.

Overrides:

readArrays in class ucar.nc2.NetcdfFile

Parameters:

variables - List of type Variable

Returns:

List of Array, one for each Variable in the input.

Throws:

java.io.IOException - if read error

readToByteChannel

public long readToByteChannel(ucar.nc2.Variable v,
                              ucar.ma2.Section section,
                              java.nio.channels.WritableByteChannel channel)
                       throws java.io.IOException,
                              ucar.ma2.InvalidRangeException

Read databuffer from a top level Variable and send databuffer to a WritableByteChannel. Experimental.

Overrides:

readToByteChannel in class ucar.nc2.NetcdfFile

Parameters:

v - a top-level Variable

section - the section of databuffer to read. There must be a Range for each Dimension in the variable, in order. Note: no nulls allowed. IOSP may not modify.

channel - write databuffer to this WritableByteChannel

Returns:

the number of databuffer written to the channel

Throws:

java.io.IOException - if read error

ucar.ma2.InvalidRangeException - if invalid section

readSection

public ucar.ma2.Array readSection(java.lang.String variableSection)
                           throws java.io.IOException,
                                  ucar.ma2.InvalidRangeException

Overrides:

readSection in class ucar.nc2.NetcdfFile

Throws:

java.io.IOException

ucar.ma2.InvalidRangeException

readData

protected ucar.ma2.Array readData(ucar.nc2.Variable cdmvar,
                                  ucar.ma2.Section section)
                           throws java.io.IOException,
                                  ucar.ma2.InvalidRangeException

Primary read entry point. This is the primary implementor of Variable.read.

Overrides:

readData in class ucar.nc2.NetcdfFile

Parameters:

cdmvar - A top-level variable

section - the section of databuffer to read. There must be a Range for each Dimension in the variable, in order. Note: no nulls allowed.

Returns:

An Array object for accessing the databuffer

Throws:

java.io.IOException - if read error

ucar.ma2.InvalidRangeException - if invalid section