dap4.dap4lib

Class AbstractDSP

java.lang.Object

dap4.dap4lib.AbstractDSP

All Implemented Interfaces:

DSP

Direct Known Subclasses:

CDMDSP, D4DSP, Nc4DSP

public abstract class AbstractDSP
extends java.lang.Object
implements DSP

Provide a superclass for DSPs.

Field Summary

Fields

Modifier and Type	Field and Description
protected DapContext	context
protected static java.lang.String	DAPVERSION
protected static boolean	DEBUG
protected DapDataset	dmr
protected static java.lang.String	DMRNS
protected static java.lang.String	DMRVERSION
protected java.lang.String	location
protected static boolean	PARSEDEBUG
protected DataCursor	rootcursor
static boolean	TESTING
static java.lang.String	UCARTAGOPAQUE
static java.lang.String	UCARTAGORIGTYPE
static java.lang.String	UCARTAGUNLIMITED
static java.lang.String	UCARTAGVLEN
static boolean	USEDOM
protected java.util.Map<DapVariable,DataCursor>	variables

Constructor Summary

Constructors

Constructor and Description
AbstractDSP()

Method Summary

Modifier and Type	Method and Description
void	addVariableData(DapVariable var, DataCursor cursor)
abstract void	close()
ChecksumMode	getChecksumMode()
DapContext	getContext()
DapDataset	getDMR()
java.lang.String	getLocation()
java.nio.ByteOrder	getOrder()
DataCursor	getVariableData(DapVariable var)
abstract AbstractDSP	open(java.lang.String location) "open" a reference to a data source and return the DSP wrapper.
protected DapDataset	parseDMR(java.lang.String document) It is common to want to parse a DMR text to a DapDataset, so provide this utility.
static java.lang.String	printDMR(DapDataset dmr)
protected void	processAttributes(DapDataset dataset) Walk the dataset tree and remove selected attributes such as _Unsigned
AbstractDSP	setChecksumMode(ChecksumMode mode)
void	setContext(DapContext context)
protected void	setDataset(DapDataset dataset)
void	setDMR(DapDataset dmr)
AbstractDSP	setLocation(java.lang.String loc)
AbstractDSP	setOrder(java.nio.ByteOrder order)
protected boolean	suppress(java.lang.String attrname) Some attributes that are added by the NetcdfDataset need to be kept out of the DMR.

Methods inherited from class java.lang.Object

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

Methods inherited from interface dap4.core.data.DSP

dspMatch

Field Detail

TESTING

public static boolean TESTING

DEBUG

protected static final boolean DEBUG

See Also:

Constant Field Values

PARSEDEBUG

protected static final boolean PARSEDEBUG

See Also:

Constant Field Values

USEDOM

public static final boolean USEDOM

See Also:

Constant Field Values

DAPVERSION

protected static final java.lang.String DAPVERSION

See Also:

Constant Field Values

DMRVERSION

protected static final java.lang.String DMRVERSION

See Also:

Constant Field Values

DMRNS

protected static final java.lang.String DMRNS

See Also:

Constant Field Values

UCARTAGVLEN

public static final java.lang.String UCARTAGVLEN

See Also:

Constant Field Values

UCARTAGOPAQUE

public static final java.lang.String UCARTAGOPAQUE

See Also:

Constant Field Values

UCARTAGORIGTYPE

public static final java.lang.String UCARTAGORIGTYPE

See Also:

Constant Field Values

UCARTAGUNLIMITED

public static final java.lang.String UCARTAGUNLIMITED

See Also:

Constant Field Values

context

protected DapContext context

dmr

protected DapDataset dmr

location

protected java.lang.String location

variables

protected java.util.Map<DapVariable,DataCursor> variables

rootcursor

protected DataCursor rootcursor

Constructor Detail

AbstractDSP

public AbstractDSP()

Method Detail

open

public abstract AbstractDSP open(java.lang.String location)
                          throws DapException

"open" a reference to a data source and return the DSP wrapper.

Specified by:

open in interface DSP

Parameters:

location - - Object that defines the data source

Returns:

= wrapping dsp

Throws:

DapException

close

public abstract void close()
                    throws java.io.IOException

Specified by:

close in interface DSP

Throws:

java.io.IOException

getVariableData

public DataCursor getVariableData(DapVariable var)
                           throws DapException

Specified by:

getVariableData in interface DSP

Throws:

DapException

getContext

public DapContext getContext()

Specified by:

getContext in interface DSP

getLocation

public java.lang.String getLocation()

Specified by:

getLocation in interface DSP

setLocation

public AbstractDSP setLocation(java.lang.String loc)

Specified by:

setLocation in interface DSP

getDMR

public DapDataset getDMR()

Specified by:

getDMR in interface DSP

setContext

public void setContext(DapContext context)

Specified by:

setContext in interface DSP

setDMR

public void setDMR(DapDataset dmr)

setDataset

protected void setDataset(DapDataset dataset)
                   throws DapException

Throws:

DapException

getOrder

public java.nio.ByteOrder getOrder()

Specified by:

getOrder in interface DSP

setOrder

public AbstractDSP setOrder(java.nio.ByteOrder order)

getChecksumMode

public ChecksumMode getChecksumMode()

Specified by:

getChecksumMode in interface DSP

setChecksumMode

public AbstractDSP setChecksumMode(ChecksumMode mode)

addVariableData

public void addVariableData(DapVariable var,
                            DataCursor cursor)

parseDMR

protected DapDataset parseDMR(java.lang.String document)
                       throws DapException

It is common to want to parse a DMR text to a DapDataset, so provide this utility.

Parameters:

document - the dmr to parse

Returns:

the parsed dmr

Throws:

DapException - on parse errors

processAttributes

protected void processAttributes(DapDataset dataset)
                          throws DapException

Walk the dataset tree and remove selected attributes such as _Unsigned

Parameters:

dataset -

Throws:

DapException

suppress

protected boolean suppress(java.lang.String attrname)

Some attributes that are added by the NetcdfDataset need to be kept out of the DMR. This function defines that set.

Parameters:

attrname - A non-escaped attribute name to be tested for suppression

Returns:

true if the attribute should be suppressed, false otherwise.

printDMR

public static java.lang.String printDMR(DapDataset dmr)