opendap.util

Class SortedTable

java.lang.Object

java.util.Dictionary

opendap.util.SortedTable

All Implemented Interfaces:

Serializable

public final class SortedTable
extends Dictionary
implements Serializable

SortedTable looks exactly like Hashtable but preserves the insertion order of elements. While this results in slower performance, it ensures that the DAS will always be printed in the same order in which it was read.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SortedTable()

Method Summary

Methods

Modifier and Type	Method and Description
Object	elementAt(int index) Returns the element at the specified index.
Enumeration	elements() Returns an enumeration of the values in this table.
Object	get(Object key) Returns the value to which the key is mapped in this table.
Vector	getElementVector() Returns a Vector containing the elements in the SortedTable.
Object	getKey(int index) Returns the key at the specified index.
boolean	isEmpty() Tests if this table is empty.
Enumeration	keys() Returns an enumeration of the keys in this table.
Object	put(Object key, Object value) Maps the specified key to the specified value in this table.
Object	remove(Object key) Removes the key (and its corresponding value) from this table.
int	size() Returns the number of keys in this table.

Methods inherited from class java.lang.Object

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

Constructor Detail

SortedTable

public SortedTable()

Method Detail

size

public int size()

Returns the number of keys in this table.

Specified by:

size in class Dictionary

isEmpty

public boolean isEmpty()

Tests if this table is empty.

Specified by:

isEmpty in class Dictionary

keys

public Enumeration keys()

Returns an enumeration of the keys in this table.

Specified by:

keys in class Dictionary

elements

public Enumeration elements()

Returns an enumeration of the values in this table.

Specified by:

elements in class Dictionary

get

public Object get(Object key)

Returns the value to which the key is mapped in this table.

Specified by:

get in class Dictionary

Parameters:

key - a key in this table.

Returns:

the value to which the key is mapped, or null if the key is not mapped to any value in the table.

getKey

public Object getKey(int index)

Returns the key at the specified index.

Parameters:

index - the index to return

Returns:

the key at the specified index.

elementAt

public Object elementAt(int index)

Returns the element at the specified index.

Parameters:

index - the index to return

Returns:

the element at the specified index.

put

public Object put(Object key,
         Object value)
           throws NullPointerException

Maps the specified key to the specified value in this table.

Specified by:

put in class Dictionary

Parameters:

key - the key

value - the value

Returns:

the previous value to which the key is mapped, or null if the key did not have a previous mapping.

Throws:

NullPointerException - if the key or value is null.

remove

public Object remove(Object key)

Removes the key (and its corresponding value) from this table. If the key is not in the table, do nothing.

Specified by:

remove in class Dictionary

Parameters:

key - the key to remove.

Returns:

the value to which the key had been mapped, or null if the key did not have a mapping.

getElementVector

public Vector getElementVector()

Returns a Vector containing the elements in the SortedTable. This is used for more efficient implementation of opendap.dap.Util.uniqueNames() by opendap.dap.DDS.checkSemantics()

Returns:

A Vector containing the elements in this SortedTable.