|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectdods.dap.AttributeTable
public class AttributeTable
An AttributeTable
stores a set of names and, for each name,
an Attribute
object. For more information on the types of
data which can be stored in an attribute, including aliases and other
AttributeTable
objects, see the documentation for
Attribute
.
The attribute tables have a standard printed representation. There is a
print
method for writing this form and a parse
method for reading the printed form.
An AttributeTable
's print representation might look like:
String long_name "Weekly Means of Sea Surface Temperature";or
actual_range { Float64 min -1.8; Float64 max 35.09; }or
String Investigators "Cornillon", "Fleirl", "Watts";or
Alias New_Attribute Old_Attribute;Here, long_name and Investigators are simple attributes, actual_range is a container attribute, and New_Attribute is an alias pointing to Old_Attribute.
DAS
,
Attribute
Constructor Summary | |
---|---|
AttributeTable()
Deprecated. |
|
AttributeTable(java.lang.String name)
Create a new empty AttributeTable . |
Method Summary | |
---|---|
void |
addAlias(java.lang.String alias,
java.lang.String name)
Add an alias to the current table. |
void |
appendAttribute(java.lang.String name,
int type,
java.lang.String value)
Adds an attribute to the table. |
void |
appendAttribute(java.lang.String name,
int type,
java.lang.String value,
boolean check)
Adds an attribute to the table. |
AttributeTable |
appendContainer(java.lang.String name)
Create and append an attribute container to the table. |
java.lang.Object |
clone()
Returns a clone of this AttributeTable . |
void |
delAttribute(java.lang.String name)
Delete the attribute named name . |
void |
delAttribute(java.lang.String name,
int i)
Delete the attribute named name . |
Attribute |
getAttribute(java.lang.String name)
Returns the Attribute which matches name. |
java.lang.String |
getName()
Returns the name of this AttributeTable. |
java.util.Enumeration |
getNames()
Returns an Enumeration of the attribute names in this
AttributeTable . |
void |
print(java.io.OutputStream os)
Print the attribute table on the given OutputStream with
four spaces of indentation. |
void |
print(java.io.OutputStream os,
java.lang.String pad)
Print the attribute table on the given OutputStream . |
void |
print(java.io.PrintWriter os)
Print the attribute table on the given PrintWriter with
four spaces of indentation. |
void |
print(java.io.PrintWriter os,
java.lang.String pad)
Print the attribute table on the given PrintWriter . |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AttributeTable()
AttributeTable
.
public AttributeTable(java.lang.String name)
AttributeTable
.
Method Detail |
---|
public java.lang.Object clone()
AttributeTable
. A deep copy is
performed on all Attribute
and AttributeTable
objects inside the AttributeTable
.
clone
in class java.lang.Object
AttributeTable
.public final java.lang.String getName()
public final java.util.Enumeration getNames()
Enumeration
of the attribute names in this
AttributeTable
.
Use the getAttribute
method to get the
Attribute
for a given name.
Enumeration
of String
.getAttribute(String)
public final Attribute getAttribute(java.lang.String name)
Attribute
which matches name.
name
- the name of the Attribute
to return.
Attribute
with the specified name, or null
if there is no matching Attribute
.Attribute
public final void appendAttribute(java.lang.String name, int type, java.lang.String value, boolean check) throws AttributeExistsException, AttributeBadValueException
The function throws an exception if the attribute is a
container, or if the type of the input value does not match the
existing attribute's type and the check
parameter
is true. Use the appendContainer
method to add container
attributes.
name
- The name of the attribute to add or modify.type
- The type code of the attribute to add or modify.value
- The value to add to the attribute table.check
- Check the validity of the attribute's value?
AttributeExistsException
- thrown if an Attribute with the same
name, but a different type was previously defined.
AttributeBadValueException
- thrown if the value is not a legal
member of typeappendContainer(String)
public final void appendAttribute(java.lang.String name, int type, java.lang.String value) throws AttributeExistsException, AttributeBadValueException
The function throws an exception if the attribute is a
container, or if the type of the input value does not match the
existing attribute's type. Use the appendContainer
method to add container attributes.
name
- The name of the attribute to add or modify.type
- The type code of the attribute to add or modify.value
- The value to add to the attribute table.
AttributeExistsException
- thrown if an Attribute with the same
name, but a different type was previously defined.
AttributeBadValueException
- thrown if the value is not a legal
member of typeappendContainer(String)
public final AttributeTable appendContainer(java.lang.String name)
AttributeTable
object.
name
- the name of the container to add.
AttributeTable
object, or null
if a container by that name already exists.public final void addAlias(java.lang.String alias, java.lang.String name) throws NoSuchAttributeException, AttributeExistsException
alias
- The alias to insert into the attribute table.name
- The name of the already-existing attribute to which
the alias will refer.
NoSuchAttributeException
- thrown if the existing attribute
could not be found.
AttributeExistsException
- thrown if the new alias has the same
name as an existing attribute.public final void delAttribute(java.lang.String name)
name
.
name
- The name of the attribute to delete. This can be an
attribute of any type, including containers.public final void delAttribute(java.lang.String name, int i)
name
. If the attribute has a
vector value, delete the i
'th element of the vector.
name
- The name of the attribute to delete. This can be an
attribute of any type, including containers.i
- If the named attribute is a vector, and i
is
non-negative, the i
'th entry in the vector is deleted.
If i
equals -1, the entire attribute is deleted.delAttribute(String)
public void print(java.io.PrintWriter os, java.lang.String pad)
PrintWriter
.
os
- the PrintWriter
to use for output.pad
- the number of spaces to indent each line.public final void print(java.io.OutputStream os, java.lang.String pad)
OutputStream
.
os
- the OutputStream
to use for output.pad
- the number of spaces to indent each line.public final void print(java.io.PrintWriter os)
PrintWriter
with
four spaces of indentation.
os
- the PrintWriter
to use for output.public final void print(java.io.OutputStream os)
OutputStream
with
four spaces of indentation.
os
- the OutputStream
to use for output.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |