dap4.servlet

Class DapServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

dap4.servlet.DapServlet

All Implemented Interfaces:

Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

@NotThreadSafe
public abstract class DapServlet
extends javax.servlet.http.HttpServlet

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	BIG_ENDIAN
protected static long	binarywritelimit
protected ByteOrder	byteorder
protected static DapCache	cache
protected boolean	compress
protected static String	DATAEXT
static boolean	DEBUG
static long	DEFAULTBINARYWRITELIMIT
protected static String	DMREXT
protected DapDSR	dsrbuilder
protected static String	DSREXT
protected static String	FAVICON
protected static boolean	IS_BIG_ENDIAN
protected static String	LITTLE_ENDIAN
static boolean	PARSEDEBUG
protected ServletInfo	svcinfo

Constructor Summary

Constructors

Constructor and Description
DapServlet()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addCommonHeaders(DapRequest drq)
protected CEConstraint	buildconstraint(DapRequest drq, String sce, DapDataset dmr) If the request has a constraint, then parse it else use the universal constraint
protected abstract void	doCapabilities(DapRequest drq) Process a capabilities request.
protected void	doData(DapRequest drq) Process a DataDMR request.
protected void	doDMR(DapRequest drq) Process a DMR request.
protected void	doDSR(DapRequest drq) Process a DSR request.
protected abstract void	doFavicon(DapRequest drq) Process a favicon request.
void	doGet(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse resp)
protected abstract long	getBinaryWriteLimit() Set the limit of the max amount of binary data to return to caller.
protected static DapCache	getCache()
ServletInfo	getInfo()
protected DapRequest	getRequestState(ServletInfo info, javax.servlet.http.HttpServletRequest rq, javax.servlet.http.HttpServletResponse rsp) Merge the servlet inputs into a single object for easier transport as well as adding value.
protected abstract String	getResourcePath(DapRequest drq) Convert a URL path into an absolute file path
void	init()
protected void	senderror(DapRequest drq, int httpcode, Throwable t) Generate an error based on the parameters
static void	setBinaryWritelimit(long limit)
protected static void	setCache(DapCache cache)

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static final boolean DEBUG

See Also:

Constant Field Values

PARSEDEBUG

public static final boolean PARSEDEBUG

See Also:

Constant Field Values

BIG_ENDIAN

protected static final String BIG_ENDIAN

See Also:

Constant Field Values

LITTLE_ENDIAN

protected static final String LITTLE_ENDIAN

See Also:

Constant Field Values

IS_BIG_ENDIAN

protected static boolean IS_BIG_ENDIAN

DMREXT

protected static final String DMREXT

See Also:

Constant Field Values

DATAEXT

protected static final String DATAEXT

See Also:

Constant Field Values

DSREXT

protected static final String DSREXT

See Also:

Constant Field Values

FAVICON

protected static final String FAVICON

See Also:

Constant Field Values

DEFAULTBINARYWRITELIMIT

public static final long DEFAULTBINARYWRITELIMIT

See Also:

Constant Field Values

cache

protected static DapCache cache

binarywritelimit

protected static long binarywritelimit

compress

protected boolean compress

byteorder

protected transient ByteOrder byteorder

dsrbuilder

protected transient DapDSR dsrbuilder

svcinfo

protected transient ServletInfo svcinfo

Constructor Detail

DapServlet

public DapServlet()

Method Detail

setCache

protected static void setCache(DapCache cache)

getCache

protected static DapCache getCache()

setBinaryWritelimit

public static void setBinaryWritelimit(long limit)

doFavicon

protected abstract void doFavicon(DapRequest drq)
                           throws IOException

Process a favicon request.

Parameters:

drq - The merged dap state

Throws:

IOException

doCapabilities

protected abstract void doCapabilities(DapRequest drq)
                                throws IOException

Process a capabilities request. Currently, does nothing (but see D4TSServlet.doCapabilities).

Parameters:

drq - The merged dap state

Throws:

IOException

getResourcePath

protected abstract String getResourcePath(DapRequest drq)
                                   throws IOException

Convert a URL path into an absolute file path

Parameters:

drq - The wrapped request info

Throws:

IOException

getBinaryWriteLimit

protected abstract long getBinaryWriteLimit()

Set the limit of the max amount of binary data to return to caller.

Returns:

limit to the max amount to write

getInfo

public ServletInfo getInfo()

init

public void init()
          throws javax.servlet.ServletException

Overrides:

init in class javax.servlet.GenericServlet

Throws:

javax.servlet.ServletException

doGet

public void doGet(javax.servlet.http.HttpServletRequest req,
         javax.servlet.http.HttpServletResponse resp)
           throws javax.servlet.ServletException,
                  IOException

Overrides:

doGet in class javax.servlet.http.HttpServlet

Throws:

javax.servlet.ServletException

IOException

doDSR

protected void doDSR(DapRequest drq)
              throws IOException

Process a DSR request.

Parameters:

drq - The merged dap state

Throws:

IOException

doDMR

protected void doDMR(DapRequest drq)
              throws IOException

Process a DMR request.

Parameters:

drq - The merged dap state

Throws:

IOException

doData

protected void doData(DapRequest drq)
               throws IOException

Process a DataDMR request. Note that if this throws an exception, then it has not yet started to output a response. It a response had been initiated, then the exception would produce an error chunk.

Parameters:

drq - The merged dap state

Throws:

IOException

addCommonHeaders

protected void addCommonHeaders(DapRequest drq)
                         throws IOException

Throws:

IOException

getRequestState

protected DapRequest getRequestState(ServletInfo info,
                         javax.servlet.http.HttpServletRequest rq,
                         javax.servlet.http.HttpServletResponse rsp)
                              throws IOException

Merge the servlet inputs into a single object for easier transport as well as adding value.

Parameters:

rq - A Servlet request object

rsp - A Servlet response object

Returns:

the union of the servlet request and servlet response arguments from the servlet engine.

Throws:

IOException

senderror

protected void senderror(DapRequest drq,
             int httpcode,
             Throwable t)
                  throws IOException

Generate an error based on the parameters

Parameters:

drq - DapRequest

httpcode - 0=>no code specified

t - exception that caused the error; may be null

Throws:

IOException

buildconstraint

protected CEConstraint buildconstraint(DapRequest drq,
                           String sce,
                           DapDataset dmr)
                                throws IOException

If the request has a constraint, then parse it else use the universal constraint

Parameters:

drq -

sce - string of the constraint

Returns:

parsed constraint

Throws:

IOException