dap4.dap4shared

Class D4DSP

java.lang.Object

dap4.dap4shared.AbstractDSP

dap4.dap4shared.D4DSP

All Implemented Interfaces:

DSP

public class D4DSP
extends AbstractDSP

DAP4 Serial to DSP This code should be completely free of references to ucar.* but not necessarily of org.apache.http.*

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	D4DSP.State Store compilation of information about a request for meta-databuffer or databuffer from a client and some info from the response

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowCompression
protected String	basece
protected static String	CHECKSUMTAG
protected static String	CONSTRAINTTAG
protected D4DataDataset	d4data
protected static String[]	DAP4EXTENSIONS
protected static String	DAP4PROTO
protected static String[]	DAPEXTENSIONS
protected static String	DAPVERSION
protected ByteBuffer	databuffer
protected static String	DATASUFFIX
protected static boolean	DEBUG
protected static int	DFALTPRELOADSIZE
protected static String	DMRSUFFIX
protected static String	DMRVERSION
protected static String	DSRSUFFIX
protected static String	FILEPROTO
protected boolean	isfile
protected static boolean	PARSEDEBUG
protected int	preloadsize
protected static String	PROTOTAG
protected static String	QUERYSTART

Fields inherited from class dap4.dap4shared.AbstractDSP

context, dmr, path, xuri

Constructor Summary

Constructors

Constructor and Description
D4DSP()
D4DSP(String path)
D4DSP(String path, DapContext cxt)

Method Summary

Methods

Modifier and Type	Method and Description
protected D4DSP	build()
protected static String	buildURL(String baseurl, String suffix, DapDataset template, String ce)
protected InputStream	callServer(String methodurl, D4DSP.State context)
void	close()
String	getCapabilities(String url) Provide a method for getting the capabilities document.
ByteBuffer	getDatabuffer()
DataDataset	getDataDataset()
boolean	match(String path, DapContext context) A path is a DAP4 path if at least one of the following is true.
D4DSP	open(String path)
D4DSP	open(String path, DapContext context)
void	parseDATA(D4DSP.State cxt, ChunkInputStream reader) Extract and "compile" the databuffer section of the server response
void	parseDMR(D4DSP.State cxt, ChunkInputStream reader) Parse a straight DMR request
protected void	readDAP(RequestMode mode) Open a connection and make a request for the (possibly constrained) DMR.
protected void	readDATA() Open a connection and make a request for the constrained DATA Note: for now, the whole of the databuffer is read, so any secondary constraint is ignored in reading.
protected void	readDMR() Open a connection and make a request for the (possibly constrained) DMR.
void	setD4Dataset(D4DataDataset dds)

Methods inherited from class dap4.dap4shared.AbstractDSP

getContext, getDMR, getPath, setContext, setDataset, setPath

Methods inherited from class java.lang.Object

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

Field Detail

PARSEDEBUG

protected static final boolean PARSEDEBUG

See Also:

Constant Field Values

DEBUG

protected static final boolean DEBUG

See Also:

Constant Field Values

DAPVERSION

protected static final String DAPVERSION

See Also:

Constant Field Values

DMRVERSION

protected static final String DMRVERSION

See Also:

Constant Field Values

DAP4PROTO

protected static final String DAP4PROTO

See Also:

Constant Field Values

FILEPROTO

protected static final String FILEPROTO

See Also:

Constant Field Values

DMRSUFFIX

protected static final String DMRSUFFIX

See Also:

Constant Field Values

DATASUFFIX

protected static final String DATASUFFIX

See Also:

Constant Field Values

DSRSUFFIX

protected static final String DSRSUFFIX

See Also:

Constant Field Values

QUERYSTART

protected static final String QUERYSTART

See Also:

Constant Field Values

CONSTRAINTTAG

protected static final String CONSTRAINTTAG

See Also:

Constant Field Values

CHECKSUMTAG

protected static final String CHECKSUMTAG

See Also:

Constant Field Values

PROTOTAG

protected static final String PROTOTAG

See Also:

Constant Field Values

DFALTPRELOADSIZE

protected static final int DFALTPRELOADSIZE

See Also:

Constant Field Values

DAPEXTENSIONS

protected static final String[] DAPEXTENSIONS

DAP4EXTENSIONS

protected static final String[] DAP4EXTENSIONS

isfile

protected boolean isfile

d4data

protected D4DataDataset d4data

allowCompression

protected boolean allowCompression

preloadsize

protected int preloadsize

basece

protected String basece

databuffer

protected ByteBuffer databuffer

Constructor Detail

D4DSP

public D4DSP()

D4DSP

public D4DSP(String path,
     DapContext cxt)
      throws DapException

Throws:

DapException

D4DSP

public D4DSP(String path)
      throws DapException

Throws:

DapException

Method Detail

open

public D4DSP open(String path)
           throws DapException

Specified by:

open in interface DSP

Specified by:

open in class AbstractDSP

Throws:

DapException

open

public D4DSP open(String path,
         DapContext context)
           throws DapException

Specified by:

open in interface DSP

Specified by:

open in class AbstractDSP

Throws:

DapException

match

public boolean match(String path,
            DapContext context)

A path is a DAP4 path if at least one of the following is true. 1. it has "dap4:" as its leading protocol 2. it has #protocol=dap4 in its fragment

Specified by:

match in interface DSP

Specified by:

match in class AbstractDSP

Parameters:

path -

context - Any parameters that may help to decide (like a File object).

Returns:

true if this path appears to be processible by this DSP

close

public void close()

getDataDataset

public DataDataset getDataDataset()

Specified by:

getDataDataset in interface DSP

Specified by:

getDataDataset in class AbstractDSP

getDatabuffer

public ByteBuffer getDatabuffer()

setD4Dataset

public void setD4Dataset(D4DataDataset dds)

build

protected D4DSP build()
               throws DapException

Throws:

DapException

readDAP

protected void readDAP(RequestMode mode)
                throws DapException

Open a connection and make a request for the (possibly constrained) DMR.

Throws:

DapException

readDMR

protected void readDMR()
                throws DapException

Open a connection and make a request for the (possibly constrained) DMR.

Throws:

DapException

readDATA

protected void readDATA()
                 throws DapException

Open a connection and make a request for the constrained DATA Note: for now, the whole of the databuffer is read, so any secondary constraint is ignored in reading. This will eventually change.

Throws:

IOException

DapException

parseDMR

public void parseDMR(D4DSP.State cxt,
            ChunkInputStream reader)
              throws IOException

Parse a straight DMR request

Parameters:

cxt - from which to read databuffer

reader - the chunk-based input stream

Throws:

DapException

IOException

parseDATA

public void parseDATA(D4DSP.State cxt,
             ChunkInputStream reader)
               throws IOException

Extract and "compile" the databuffer section of the server response

Parameters:

cxt - from which to read databuffer

reader - the chunk-based input stream

Throws:

DapException

IOException

callServer

protected InputStream callServer(String methodurl,
                     D4DSP.State context)
                          throws DapException

Throws:

DapException

getCapabilities

public String getCapabilities(String url)
                       throws IOException

Provide a method for getting the capabilities document.

Parameters:

url - for accessing the document

Throws:

DapException

IOException

buildURL

protected static String buildURL(String baseurl,
              String suffix,
              DapDataset template,
              String ce)