|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ServerMethods
This interface defines the additional behaviors that Server side types need to support. These include:
The file I/O operations of which each variable must be capable.
The projection information. A projection defines the variables specified by a constraint to be returned by the server. These methods store projection information for a non-vector variable. Each variable type used on the server-side of DODS must implement this interface or one of its descendents.
The methods that define how each type responds to relational operators. Most (all?) types will not have sensible responses to all of the relational operators (e.g. SDByte won't know how to match a regular expression but SDString will). For those operators that are nonsensical a class should throw InvalidOperator.
ServerArrayMethods
,
Operator
Method Summary | |
---|---|
boolean |
equal(dods.dap.BaseType bt)
The Operator class contains a generalized implementation
of this method. |
boolean |
greater_eql(dods.dap.BaseType bt)
The Operator class contains a generalized implementation
of this method. |
boolean |
greater(dods.dap.BaseType bt)
The Operator class contains a generalized implementation
of this method. |
boolean |
isProject()
Is the given variable marked as projected? |
boolean |
isRead()
Get the value of the Read property. |
boolean |
isSynthesized()
Get the value of the Synthesized property. |
boolean |
less_eql(dods.dap.BaseType bt)
The Operator class contains a generalized implementation
of this method. |
boolean |
less(dods.dap.BaseType bt)
The Operator class contains a generalized implementation
of this method. |
boolean |
not_equal(dods.dap.BaseType bt)
The Operator class contains a generalized implementation
of this method. |
boolean |
read(String datasetName,
Object specialO)
Read a value from the named dataset for this variable. |
boolean |
regexp(dods.dap.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 DODS variables (sub-classes of BaseType ). |
void |
setProject(boolean state)
Set the Project property of this variable. |
void |
setProject(boolean state,
boolean all)
Set the state of this variable's projection. |
void |
setRead(boolean state)
Set the Read property. |
void |
setSynthesized(boolean state)
Set the Synthesized property. |
Method Detail |
---|
void setSynthesized(boolean state)
state
- If true
then the variable is considered a
synthetic variable and no part of DODS 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.isSynthesized()
,
read(String, Object)
boolean isSynthesized()
true
if this is a synthetic variable,
false
otherwise.void setRead(boolean state)
read()
method. Once read the Read property is
true
. Use this function to manually set the property
value. By default this property is false.
state
- true
if the variable has been read,
false
otherwise.isRead()
,
read(String, Object)
boolean isRead()
true
if the variable has been read,
false
otherwise.read(String, Object)
,
setRead(boolean)
boolean read(String datasetName, Object specialO) throws dods.dap.NoSuchVariableException, IOException, EOFException
datasetName
- String identifying the file or other data store from which to
read a value for this variable.specialO
- Object this 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
.
true
if more data remains to be read, otherwise
false
.
dods.dap.NoSuchVariableException
IOException
EOFException
void setProject(boolean state, boolean all)
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
.For simple variables and for children of DVector, the variable either is or is not projected. For children of DConstructor, it may be that the request is for only part of the constructor type (e.g., only oe field of a structure). However, the structure variable itself must be marked as projected given the implementation of serialize. The serialize() method does not search the entire tree of variables; it relies on the fact that for a particular variable to be sent, the path from the top of the DDS to that variable must be marked as `projected', not just the variable itself. This keeps the CEEvaluator.send() method from having to search the entire tree for the variables to be sent.
state
- true
if the variable is part of the current
projection, false
otherwise.all
- set (or clear) the Project property of any children.CEEvaluator
void setProject(boolean state)
state
- true
if the variable is part of the current
projection, false
otherwise.setProject(boolean)
,
CEEvaluator
boolean isProject()
true
, otherwise it
should return false
.
true
if the variable is part of the current
projections, false
otherwise.setProject(boolean,boolean)
,
setProject(boolean)
,
CEEvaluator
boolean equal(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
boolean not_equal(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
boolean greater(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
boolean greater_eql(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
boolean less(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
boolean less_eql(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
boolean regexp(dods.dap.BaseType bt) throws InvalidOperatorException, RegExpException, SBHException
Operator
class contains a generalized implementation
of this method. It should be used unless a localized
architecture/implementation requires otherwise.
InvalidOperatorException
RegExpException
SBHException
Operator
void serialize(String dataset, DataOutputStream sink, CEEvaluator ce, Object specialO) throws dods.dap.NoSuchVariableException, SDODSException, IOException
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 DODS client/server connection, and possibly
by GUI clients which need to download DODS data, manipulate it, and
then re-save it as a binary file.
For children of DConstructor, this method should call itself on each of the components. For other types this method should call externalize().
dataset
- a String
indicated which dataset to read
from (Or something else if you so desire).sink
- a DataOutputStream
to write to.ce
- the CEEvaluator
to use in the parse process.
IOException
- thrown on any OutputStream
exception.
dods.dap.NoSuchVariableException
SDODSException
BaseType
,
DDS
,
ServerDDS
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |