dods.dap.Server
Class CEEvaluator

java.lang.Object
  dods.dap.Server.CEEvaluator

public class CEEvaluator
extends Object

This class is used to parse and evaluate a constraint expression. When constructed it must be passed a valid DDS along with the expression. This DDS will be used as the environment (collection of variables and functions) during the parse and evaluation of the constraint expression.

A server (servlet, CGI, ...) must first instantiate the DDS (possibly reading it from a cache) and then create and instance of this class. Once created, the constraint may be parsed and then evaluated. The class supports sending data based on the results of CE evaluation. That is, the send() method of the class combines both the evaluation of the constraint and the output of data values so that the server can return data using a single method call.

Custom parsing The CEEvaluator parses constraint expressions into Clause objects using a ClauseFactory. Customized behavior during parsing can be achieved by passing a customized ClauseFactory into the CEEvaluator.

Support for server side functions Server side functions are supported via the FunctionLibrary class. Custom server side function support is achieved by using a customized ClauseFactory which in turn contains a customized FunctionLibrary.

More details are found in the documentation for the respective classes.

Version:

$Revision: 1.3 $

Author:

jhrg

See Also:

ServerDDS, ServerMethods, ClauseFactory, FunctionLibrary, Clause

Constructor Summary

CEEvaluator(ServerDDS dds)
Construct a new CEEvaluator with dds as the DDS object with which to resolve all variable and function names.

CEEvaluator(ServerDDS dds, ClauseFactory clauseFactory)
Construct a new CEEvaluator with dds as the DDS object with which to resolve all variable and function names, and clauseFactory as a source of Clause objects .

Method Summary

void	appendClause(Clause c) Add a clause to the constraint expression.
boolean	evalClauses(Object specialO) Evaluate all of the Clauses in the Clause vector.
Enumeration	getClauses() Get access to the list of clauses built by parsing the selection part of the constraint expression.
ServerDDS	getDDS() Return a reference to the CEEvaluator's DDS object.
void	markAll(boolean state) Mark all the variables in the DDS either as part of the current projection (when state is true) or not (state is false).
void	parseConstraint(String expression) Parse a constraint expression.
boolean	removeClause(Clause c) Remove a clause from the constraint expression.
void	send(String dataset, OutputStream sink, Object specialO) This function sends the variables described in the constrained DDS to the output described by sink.

Methods inherited from class java.lang.Object

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

Constructor Detail

CEEvaluator

public CEEvaluator(ServerDDS dds)

Construct a new CEEvaluator with dds as the DDS object with which to resolve all variable and function names.

Parameters:

dds - DDS object describing the dataset targeted by this constraint.

CEEvaluator

public CEEvaluator(ServerDDS dds,
                   ClauseFactory clauseFactory)

Construct a new CEEvaluator with dds as the DDS object with which to resolve all variable and function names, and clauseFactory as a source of Clause objects .

Parameters:

clauseFactory - The factory which will be used by the parser to construct the clause tree. This allows servers to pass in a factory which creates custom clause objects.

dds - DDS object describing the dataset targeted by this constraint. author Joe Wielgosz (joew@cola.iges.org)

Method Detail

getDDS

public ServerDDS getDDS()

Return a reference to the CEEvaluator's DDS object.

parseConstraint

public void parseConstraint(String expression)
                     throws ParseException,
                            dods.dap.DODSException,
                            dods.dap.NoSuchVariableException,
                            dods.dap.NoSuchFunctionException,
                            InvalidOperatorException,
                            InvalidParameterException,
                            SBHException,
                            WrongTypeException

Parse a constraint expression. Variables in the projection are marked as such in the CEEvaluator's ServerDDS instance. The selection subexpression is then parsed and a list of Clause objects is built.

The parser is located in dods.dap.parser.ExprParser.

Parameters:

expression - The constraint expression to parse.

Throws:

ParseException

dods.dap.NoSuchVariableException

dods.dap.NoSuchFunctionException

InvalidOperatorException

InvalidParameterException

SBHException

dods.dap.DODSException

WrongTypeException

appendClause

public void appendClause(Clause c)

Add a clause to the constraint expression.

Parameters:

c - The Clause to append.

removeClause

public boolean removeClause(Clause c)

Remove a clause from the constraint expression. This will will remove the first occurrence of the passed clause from the constraint expression. This is done be reference, so if the passed Clause object is NOT already in the constraint expression then nothing happens. And, if it should appear more than once (which I don't think is possible) only the first occurrence will be removed.

Parameters:

c - The Clause to append.

Returns:

True if constraint expression contained the passed Clause object and it was successfully removed.

getClauses

public final Enumeration getClauses()

Get access to the list of clauses built by parsing the selection part of the constraint expression.

NB: This is not valid until the CE has been parsed!

send

public void send(String dataset,
                 OutputStream sink,
                 Object specialO)
          throws dods.dap.NoSuchVariableException,
                 SDODSException,
                 IOException

This function sends the variables described in the constrained DDS to the output described by sink. This function calls parse_constraint(), BaseType::read(), and ServerIO::serialize().

Parameters:

dataset - The name of the dataset to send.

sink - A pointer to the output buffer for the data.

specialO - Not sure - special object?

Throws:

dods.dap.NoSuchVariableException

SDODSException

IOException

See Also:

parseConstraint(String), ServerMethods.serialize()

evalClauses

public boolean evalClauses(Object specialO)
                    throws dods.dap.NoSuchVariableException,
                           SDODSException,
                           IOException

Evaluate all of the Clauses in the Clause vector.

Parameters:

specialO - That special Object that can be passed down through the DDS.send() method.

Returns:

True if all the Clauses evaluate to true, false otherwise.

Throws:

dods.dap.NoSuchVariableException

SDODSException

IOException

markAll

public void markAll(boolean state)
             throws InvalidParameterException,
                    dods.dap.NoSuchVariableException,
                    SBHException

Mark all the variables in the DDS either as part of the current projection (when state is true) or not (state is false). This is a convenience function that provides a way to clear or set an entire dataset described by a DDS with respect to its projection.

Parameters:

state - true if the variables should all be projected, false is no variable should be projected.

Throws:

InvalidParameterException

dods.dap.NoSuchVariableException

SBHException