opendap.servers

Class SDGrid

java.lang.Object

opendap.dap.DAPNode

opendap.dap.BaseType

opendap.dap.DConstructor

opendap.dap.DGrid

opendap.servers.SDGrid

All Implemented Interfaces:

Serializable, Cloneable, ClientIO, RelOps, ServerArrayMethods, ServerMethods

public abstract class SDGrid
extends DGrid
implements ServerArrayMethods, RelOps

Holds a OPeNDAP Server Grid value.

Version:

$Revision: 19676 $

Author:

ndp

See Also:

BaseType, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class opendap.dap.DAPNode

DAPNode.CloneMap

Field Summary

Fields inherited from class opendap.dap.DGrid

ARRAY, arrayVar, MAPS, mapVars

Fields inherited from class opendap.dap.DAPNode

_nameClear, _nameEncoded, log

Constructor Summary

Constructors

Constructor and Description
SDGrid() Constructs a new SDGrid.
SDGrid(String n) Constructs a new SDGrid with name n.

Method Summary

Methods

Modifier and Type	Method and Description
void	addVariable(BaseType v, int part) Adds a variable to the container.
boolean	equal(BaseType bt) The RelOps interface defines how each type responds to relational operators.
int	getStart(int dimension) Gets the start value for the projection of the dimension indicated.
int	getStop(int dimension) Gets the stop value for the projection of the dimension indicated.
int	getStride(int dimension) Gets the stride value for the projection of the dimension indicated.
boolean	greater_eql(BaseType bt) The Operator class contains a generalized implementation of this method.
boolean	greater(BaseType bt) The Operator class contains a generalized implementation of this method.
boolean	isRead() Get the value of the Read property.
boolean	isSynthesized() Get the value of the Synthesized property.
boolean	less_eql(BaseType bt) The Operator class contains a generalized implementation of this method.
boolean	less(BaseType bt) The Operator class contains a generalized implementation of this method.
boolean	not_equal(BaseType bt) The Operator class contains a generalized implementation of this method.
void	printDecl(PrintWriter os, String space, boolean print_semi, boolean constrained) Write the variable's declaration in a C-style syntax.
void	printVal(PrintWriter os, String space, boolean print_decl_p) Prints the value of the variable, with its declaration.
void	printXML(PrintWriter pw, String pad, boolean constrained) Write the variable's declaration in a C-style syntax.
abstract boolean	read(String datasetName, Object specialO) Read a value from the named dataset for this variable.
boolean	regexp(BaseType bt) The Operator class contains a generalized implementation of this method.
void	serialize(String dataset, DataOutputStream sink, CEEvaluator ce, Object specialO) Server-side serialization for OPeNDAP variables (sub-classes of BaseType).
void	setProject(boolean state, boolean all) Set the state of this variable's projection.
void	setProjection(int dimension, int start, int stride, int stop) Set the projection information for this dimension.
void	setRead(boolean state) Set the Read property.
void	setSynthesized(boolean state) Set the Synthesized property.

Methods inherited from class opendap.dap.DGrid

checkSemantics, cloneDAG, deserialize, elementCount, externalize, getArray, getArrayDims, getTypeName, getVar, getVarCount, getVariable, getVariables, projectedComponents, projectionYieldsGrid

Methods inherited from class opendap.dap.DConstructor

addVariable, someChildHasAttributes

Methods inherited from class opendap.dap.BaseType

addAttributeAlias, addAttributeContainer, appendAttribute, appendAttribute, appendAttributeContainer, checkSemantics, delAttribute, delAttribute, elementCount, getAttribute, getAttribute, getAttributeNames, getAttributeTable, getLongName, hasAttributes, newPrimitiveVector, printAttributes, printAttributes, printAttributes, printAttributes, printConstraint, printDecl, printDecl, printDecl, printDecl, printDecl, printDecl, printDecl, printVal, printVal, printVal, printXML, printXML, printXML, printXML, setClearName

Methods inherited from class opendap.dap.DAPNode

clone, cloneDAG, getClearName, getEncodedName, getParent, isProject, setEncodedName, setParent, setProject, setProjected

Methods inherited from class java.lang.Object

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

Methods inherited from interface opendap.servers.ServerMethods

isProject, setProject

Constructor Detail

SDGrid

public SDGrid()

Constructs a new SDGrid.

SDGrid

public SDGrid(String n)

Constructs a new SDGrid with name n.

Parameters:

n - the name of the variable.

Method Detail

printDecl

public void printDecl(PrintWriter os,
             String space,
             boolean print_semi,
             boolean constrained)

Write the variable's declaration in a C-style syntax. This function is used to create textual representation of the Data Descriptor Structure (DDS). See The OPeNDAP User Manual for information about this structure.

Overrides:

printDecl in class DGrid

Parameters:

os - The PrintWriter on which to print the declaration.

space - Each line of the declaration will begin with the characters in this string. Usually used for leading spaces.

print_semi - a boolean value indicating whether to print a semicolon at the end of the declaration.

constrained - a boolean value indicating whether to print the declartion dependent on the projection information. This is only used by Server side code.

See Also:

BaseType.printDecl(PrintWriter, String, boolean)

printVal

public void printVal(PrintWriter os,
            String space,
            boolean print_decl_p)

Prints the value of the variable, with its declaration. This function is primarily intended for debugging OPeNDAP applications and text-based clients such as geturl.

Important Note

This method overrides the BaseType method of the same name and type signature and it significantly changes the behavior for all versions of printVal() for this type: All the various versions of printVal() will only print a value, or a value with declaration, if the variable is in the projection.

In other words, if a call to isProject() for a particular variable returns true then printVal() will print a value (or a declaration and a value).

If isProject() for a particular variable returns false then printVal() is basically a No-Op.

Overrides:

printVal in class DGrid

Parameters:

os - the PrintWriter on which to print the value.

space - this value is passed to the printDecl method, and controls the leading spaces of the output.

print_decl_p - a boolean value controlling whether the variable declaration is printed as well as the value.

See Also:

BaseType.printVal(PrintWriter, String, boolean), ServerMethods.isProject()

addVariable

public void addVariable(BaseType v,
               int part)

Adds a variable to the container. This overrides the same method in the parent class DGrid in order to add array projection functionality.

Overrides:

addVariable in class DGrid

Parameters:

v - the variable to add.

part - the part of the DGrid to be modified. Allowed values are ARRAY or MAPS.

Throws:

IllegalArgumentException - if an invalid part was given.

setProject

public void setProject(boolean state,
              boolean all)

Set the state of this variable's projection. true means that this variable is part of the current projection as defined by the current constraint expression, otherwise the current projection for this variable should be false.

Specified by:

setProject in interface ServerMethods

Overrides:

setProject in class DAPNode

Parameters:

state - true if the variable is part of the current projection, false otherwise.

all - If true, set the Project property of all the members (and their children, and so on).

See Also:

CEEvaluator

equal

public boolean equal(BaseType bt)
              throws InvalidOperatorException,
                     RegExpException,
                     SBHException

The RelOps interface defines how each type responds to relational operators. Most (all?) types will not have sensible responses to all of the relational operators (e.g. DGrid won't know how to match a regular expression but DString will). For those operators that are nonsensical a class should throw InvalidOperatorException.

Specified by:

equal in interface RelOps

Specified by:

equal in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when they are equal, false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

not_equal

public boolean not_equal(BaseType bt)
                  throws InvalidOperatorException,
                         RegExpException,
                         SBHException

Description copied from interface: ServerMethods

The Operator class contains a generalized implementation of this method. It should be used unless a localized architecture/implementation requires otherwise.

Specified by:

not_equal in interface RelOps

Specified by:

not_equal in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when they are not equal, false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

greater

public boolean greater(BaseType bt)
                throws InvalidOperatorException,
                       RegExpException,
                       SBHException

Description copied from interface: ServerMethods

The Operator class contains a generalized implementation of this method. It should be used unless a localized architecture/implementation requires otherwise.

Specified by:

greater in interface RelOps

Specified by:

greater in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when this value is greater than the based 'bt' value, false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

greater_eql

public boolean greater_eql(BaseType bt)
                    throws InvalidOperatorException,
                           RegExpException,
                           SBHException

Description copied from interface: ServerMethods

The Operator class contains a generalized implementation of this method. It should be used unless a localized architecture/implementation requires otherwise.

Specified by:

greater_eql in interface RelOps

Specified by:

greater_eql in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when this value is greater or equal than the based 'bt' value, false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

less

public boolean less(BaseType bt)
             throws InvalidOperatorException,
                    RegExpException,
                    SBHException

Description copied from interface: ServerMethods

The Operator class contains a generalized implementation of this method. It should be used unless a localized architecture/implementation requires otherwise.

Specified by:

less in interface RelOps

Specified by:

less in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when this value is less than the based 'bt' value, false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

less_eql

public boolean less_eql(BaseType bt)
                 throws InvalidOperatorException,
                        RegExpException,
                        SBHException

Description copied from interface: ServerMethods

The Operator class contains a generalized implementation of this method. It should be used unless a localized architecture/implementation requires otherwise.

Specified by:

less_eql in interface RelOps

Specified by:

less_eql in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when this value is less than or equal to the based 'bt' value, false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

regexp

public boolean regexp(BaseType bt)
               throws InvalidOperatorException,
                      RegExpException,
                      SBHException

Description copied from interface: ServerMethods

The Operator class contains a generalized implementation of this method. It should be used unless a localized architecture/implementation requires otherwise.

Specified by:

regexp in interface RelOps

Specified by:

regexp in interface ServerMethods

Parameters:

bt - The variable to which to compare 'this' value.

Returns:

True when regular expression evaluates to true., false otherwise.

Throws:

InvalidOperatorException - When the operator cannot be applied to the two data types.

RegExpException - When the regular expression is badly formed.

SBHException - When Something Bad Happens.

See Also:

Operator

setSynthesized

public void setSynthesized(boolean state)

Set the Synthesized property.

Specified by:

setSynthesized in interface ServerMethods

Parameters:

state - If true then the variable is considered a synthetic variable and no part of OPeNDAP will ever try to read it from a file, otherwise if false the variable is considered a normal variable whose value should be read using the read() method. By default this property is false.

See Also:

isSynthesized(), read(String, Object)

isSynthesized

public boolean isSynthesized()

Get the value of the Synthesized property.

Specified by:

isSynthesized in interface ServerMethods

Returns:

true if this is a synthetic variable, false otherwise.

setRead

public void setRead(boolean state)

Set the Read property. A normal variable is read using the read() method. Once read the Read property is true. Use this function to manually set the property value. By default this property is false.

Specified by:

setRead in interface ServerMethods

Parameters:

state - true if the variable has been read, false otherwise.

See Also:

isRead(), read(String, Object)

isRead

public boolean isRead()

Get the value of the Read property.

Specified by:

isRead in interface ServerMethods

Returns:

true if the variable has been read, false otherwise.

See Also:

read(String, Object), setRead(boolean)

read

public abstract boolean read(String datasetName,
           Object specialO)
                      throws NoSuchVariableException,
                             IOException,
                             EOFException

Read a value from the named dataset for this variable.

Specified by:

read in interface ServerMethods

Parameters:

datasetName - String identifying the file or other data store from which to read a vaue for this variable.

specialO - This Object is a goody that is used by Server implementations to deliver important, and as yet unknown, stuff to the read method. If you don't need it, make it a null.

Returns:

true if more data remains to be read, otherwise false. This is an abtsract method that must be implemented as part of the installation/localization of a OPeNDAP server.

Throws:

IOException

EOFException

NoSuchVariableException - When a variable can't be found.

serialize

public void serialize(String dataset,
             DataOutputStream sink,
             CEEvaluator ce,
             Object specialO)
               throws NoSuchVariableException,
                      DAP2ServerSideException,
                      IOException

Server-side serialization for OPeNDAP variables (sub-classes of BaseType). This does not send the entire class as the Java Serializable interface does, rather it sends only the binary data values. Other software is responsible for sending variable type information (see DDS).

Writes data to a DataOutputStream. This method is used on the server side of the OPeNDAP client/server connection, and possibly by GUI clients which need to download OPeNDAP data, manipulate it, and then re-save it as a binary file.

Specified by:

serialize in interface ServerMethods

Parameters:

sink - a DataOutputStream to write to.

dataset - a String indicated which dataset to read from (Or something else if you so desire).

ce - the CEEvaluator to use in the parse process.

specialO - This Object is a goody that is used by a Server implementations to deliver important, and as yet unknown, stuff to the read method. If you don't need it, make it a null.

Throws:

IOException - thrown on any OutputStream exception.

NoSuchVariableException - When a variable cannot be found.

DAP2ServerSideException - When there is a server error.

See Also:

BaseType, DDS, ServerDDS

setProjection

public void setProjection(int dimension,
                 int start,
                 int stride,
                 int stop)
                   throws InvalidDimensionException,
                          SBHException

Set the projection information for this dimension. The internal DArray is retrieved and then the DArrayDimension associated with the dimension specified is retrieved and the start stride and stop parameters are passed to its setProjection() method.

Specified by:

setProjection in interface ServerArrayMethods

Parameters:

dimension - The dimension that is to be modified.

start - The starting point for the projection of this DArrayDimension.

stride - The size of the stride for the projection of this DArrayDimension.

stop - The stopping point for the projection of this DArrayDimension.

Throws:

InvalidDimensionException

SBHException

See Also:

DArray, DArrayDimension

getStart

public int getStart(int dimension)
             throws InvalidDimensionException

Gets the start value for the projection of the dimension indicated. The parameter dimension is checked against the instance of the SDArray for bounds violation.

Specified by:

getStart in interface ServerArrayMethods

Parameters:

dimension - The dimension from whose projection to retrieve the start value.

Throws:

InvalidDimensionException

getStride

public int getStride(int dimension)
              throws InvalidDimensionException

Gets the stride value for the projection of the dimension indicated. The parameter dimension is checked against the instance of the SDArray for bounds violation.

Specified by:

getStride in interface ServerArrayMethods

Parameters:

dimension - The dimension from whose projection to retrieve the stride value.

Throws:

InvalidDimensionException

getStop

public int getStop(int dimension)
            throws InvalidDimensionException

Gets the stop value for the projection of the dimension indicated. The parameter dimension is checked against the instance of the SDArray for bounds violation.

Specified by:

getStop in interface ServerArrayMethods

Parameters:

dimension - The dimension from whose projection to retrieve the stop value.

Throws:

InvalidDimensionException

printXML

public void printXML(PrintWriter pw,
            String pad,
            boolean constrained)

Write the variable's declaration in a C-style syntax. This function is used to create textual representation of the Data Descriptor Structure (DDS). See The OPeNDAP User Manual for information about this structure.

Overrides:

printXML in class DGrid

Parameters:

pw - Where to print

pad - Padding for iondentation (makes the output easier for humans to read).

constrained - If true then only projected variables (and their Attributes) will be printed.

See Also:

BaseType.printDecl(PrintWriter, String, boolean)