ucar.nc2.stream

Class CdmRemote

java.lang.Object

ucar.nc2.NetcdfFile

ucar.nc2.stream.CdmRemote

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, FileCacheable

public class CdmRemote
extends NetcdfFile

A remote CDM dataset (extending NetcdfFile), using cdmremote protocol to communicate. Similar to Opendap in that it is a remote access protocol using indexed data access. Supports full CDM / netcdf-4 data model.

Since:

Feb 7, 2009

Nested Class Summary

Nested classes/interfaces inherited from class ucar.nc2.NetcdfFile

NetcdfFile.Builder<T extends NetcdfFile.Builder<T>>

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROTOCOL
static java.lang.String	SCHEME

Fields inherited from class ucar.nc2.NetcdfFile

cache, dimensions, gattributes, id, iosp, IOSP_MESSAGE_ADD_RECORD_STRUCTURE, IOSP_MESSAGE_CONVERT_RECORD_STRUCTURE, IOSP_MESSAGE_GET_NETCDF_FILE_FORMAT, IOSP_MESSAGE_RANDOM_ACCESS_FILE, IOSP_MESSAGE_REMOVE_RECORD_STRUCTURE, location, rootGroup, title, variables

Constructor Summary

Constructors

Constructor and Description
CdmRemote(java.io.InputStream is, java.lang.String location)
CdmRemote(java.lang.String _remoteURI)

Method Summary

Modifier and Type	Method and Description
static java.lang.String	canonicalURL(java.lang.String urlName) Create the canonical form of the URL.
void	close() Close all resources (files, sockets, etc) associated with this file.
java.lang.String	getFileTypeDescription() Get a human-readable description for this file type.
java.lang.String	getFileTypeId() Get the file type id for the underlying data source.
protected StructureDataIterator	getStructureIterator(Structure s, int bufferSize)
protected Array	readData(Variable v, Section section) Do not call this directly, use Variable.read() !! Ranges must be filled (no nulls)
static java.io.InputStream	sendQuery(HTTPSession session, java.lang.String remoteURI, java.lang.String query)
static void	setAllowCompression(boolean b)
static void	setDebugFlags(DebugFlags debugFlag)
long	writeToFile(java.lang.String filename)

Methods inherited from class ucar.nc2.NetcdfFile

addAttribute, addAttribute, addDimension, addGroup, addLocalFieldsToBuilder, addStringVariable, addVariable, addVariable, addVariableAttribute, builder, canonicalizeUriString, canOpen, empty, findAttribute, findAttValueIgnoreCase, findDimension, findGlobalAttribute, findGlobalAttributeIgnoreCase, findGroup, findVariable, findVariable, findVariableByAttribute, finish, getCacheName, getDetailInfo, getDetailInfo, getDimensions, getFileTypeVersion, getGlobalAttributes, getId, getIosp, getLastModified, getLocation, getRootGroup, getTitle, getUnlimitedDimension, getVariables, hasUnlimitedDimension, iospDeRegister, iospRegistered, makeFullName, makeFullName, makeFullNameSectionSpec, makeFullNameWithString, makeNameUnescaped, makeRecordStructure, makeValidCDLName, makeValidCdmObjectName, makeValidPathName, makeValidSectionSpecName, open, open, open, open, open, open, openInMemory, openInMemory, openInMemory, openInMemory, reacquire, read, readArrays, readAttributeDouble, readAttributeInteger, readSection, readToByteChannel, readToOutputStream, registerIOProvider, registerIOProvider, registerIOProvider, registerIOProviderPreferred, release, removeDimension, removeRecordStructure, removeVariable, sendIospMessage, setCacheName, setFileCache, setId, setImmutable, setLocation, setProperty, setRootGroup, setTitle, showCached, showProxies, syncExtend, toBuilder, toNcml, toString, toStringDebug, writeCDL, writeCDL, writeCDL, writeNcml, writeNcml

Methods inherited from class java.lang.Object

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

Field Detail

PROTOCOL

public static final java.lang.String PROTOCOL

See Also:

Constant Field Values

SCHEME

public static final java.lang.String SCHEME

See Also:

Constant Field Values

Constructor Detail

CdmRemote

public CdmRemote(java.lang.String _remoteURI)
          throws java.io.IOException

Throws:

java.io.IOException

CdmRemote

public CdmRemote(java.io.InputStream is,
                 java.lang.String location)
          throws java.io.IOException

Throws:

java.io.IOException

Method Detail

setDebugFlags

public static void setDebugFlags(DebugFlags debugFlag)

setAllowCompression

public static void setAllowCompression(boolean b)

canonicalURL

public static java.lang.String canonicalURL(java.lang.String urlName)

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

Parameters:

urlName - the url string

Returns:

canonical form

readData

protected Array readData(Variable v,
                         Section section)
                  throws java.io.IOException

Description copied from class: NetcdfFile

Do not call this directly, use Variable.read() !! Ranges must be filled (no nulls)

Overrides:

readData in class NetcdfFile

Throws:

java.io.IOException

getStructureIterator

protected StructureDataIterator getStructureIterator(Structure s,
                                                     int bufferSize)

Overrides:

getStructureIterator in class NetcdfFile

sendQuery

public static java.io.InputStream sendQuery(HTTPSession session,
                                            java.lang.String remoteURI,
                                            java.lang.String query)
                                     throws java.io.IOException

Throws:

java.io.IOException

getFileTypeId

public java.lang.String getFileTypeId()

Description copied from class: NetcdfFile

Get the file type id for the underlying data source.

Overrides:

getFileTypeId in class NetcdfFile

Returns:

registered id of the file type

See Also:

"https://www.unidata.ucar.edu/software/netcdf-java/formats/FileTypes.html"

getFileTypeDescription

public java.lang.String getFileTypeDescription()

Description copied from class: NetcdfFile

Get a human-readable description for this file type.

Overrides:

getFileTypeDescription in class NetcdfFile

Returns:

description of the file type

See Also:

"https://www.unidata.ucar.edu/software/netcdf-java/formats/FileTypes.html"

writeToFile

public long writeToFile(java.lang.String filename)
                 throws java.io.IOException

Throws:

java.io.IOException

close

public void close()

Description copied from class: NetcdfFile

Close all resources (files, sockets, etc) associated with this file. If the underlying file was acquired, it will be released, otherwise closed. if isClosed() already, nothing will happen

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface FileCacheable

Overrides:

close in class NetcdfFile