xdev.util

Class XdevHashtable<K,V>

java.lang.Object

java.util.Dictionary<K,V>

java.util.Hashtable<K,V>

xdev.util.XdevHashtable<K,V>

Type Parameters:

K - type of the key entries.

V -

All Implemented Interfaces:

Serializable, Cloneable, Map<K,V>, Copyable<XdevHashtable<K,V>>

public class XdevHashtable<K,V>
extends Hashtable<K,V>
implements Copyable<XdevHashtable<K,V>>

The standard Map in XDEV. Based on Hashtable.

Since:

2.0

Author:

XDEV Software

See Also:

Map, Hashtable, Serialized Form

Constructor Summary

Constructors

Constructor and Description
XdevHashtable() Constructs a new, empty XdevHashtable with a default initial capacity (11) and load factor (0.75).
XdevHashtable(int initialCapacity) Constructs a new, empty XdevHashtable with the specified initial capacity and default load factor (0.75).
XdevHashtable(Map<? extends K,? extends V> m) Constructs a new XdevHashtable with the same mappings as the given Map.
XdevHashtable(Object... keysAndValues) Constructs a new XdevHashtable with the given value pairs.

Method Summary

Modifier and Type	Method and Description
void	clear()
XdevHashtable<K,V>	clone() Returns a field-for-field copy of this instance.
XdevHashtable<K,V>	copy() Creates a (defensive) copy of this XdevHashtable.
K	getKey() Returns the key at the current cursor position.
XdevList<K>	getKeys() Returns a XdevList containing all the keys of this XdevHashtable.
V	getValue() Returns the value at the current cursor position.
XdevList<V>	getValues() Returns a XdevList containing all the values of this XdevHashtable.
boolean	next() Tests if this XdevHashtable contains more elements.
V	put(K key, V value)
void	putAll(Map<? extends K,? extends V> t)
V	remove(Object key)
void	resetCursor() Resets the cursor for this XdevHashtable.
String	toString()
String	toString(String separator) Returns a String representation of all elements of this XdevHashtable separated by the specified separator.

Methods inherited from class java.util.Hashtable

compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keys, keySet, merge, putIfAbsent, rehash, remove, replace, replace, replaceAll, size, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

XdevHashtable

public XdevHashtable()

Constructs a new, empty XdevHashtable with a default initial capacity (11) and load factor (0.75).

XdevHashtable

public XdevHashtable(int initialCapacity)
              throws IllegalArgumentException

Constructs a new, empty XdevHashtable with the specified initial capacity and default load factor (0.75).

Parameters:

initialCapacity - the initial capacity of the XdevHashtable.

Throws:

IllegalArgumentException - if the initial capacity is less than zero.

XdevHashtable

public XdevHashtable(Map<? extends K,? extends V> m)
              throws NullPointerException

Constructs a new XdevHashtable with the same mappings as the given Map. The XdevHashtable is created with an initial capacity sufficient to hold the mappings in the given Map and a default load factor (0.75).

Parameters:

m - the map whose mappings are to be placed in this map.

Throws:

NullPointerException - if the specified map is null.

XdevHashtable

public XdevHashtable(Object... keysAndValues)
              throws IllegalArgumentException

Constructs a new XdevHashtable with the given value pairs. The given parameters become paired in the order that they are passed to the method. The first parameter will be the key, the second parameter will be the value for the first pair (and so on)...

Parameters:

keysAndValues - key value pairs in sequence

Throws:

IllegalArgumentException - if the parameter count is not even.

Method Detail

put

public V put(K key,
             V value)

Specified by:

put in interface Map<K,V>

Overrides:

put in class Hashtable<K,V>

putAll

public void putAll(Map<? extends K,? extends V> t)

Specified by:

putAll in interface Map<K,V>

Overrides:

putAll in class Hashtable<K,V>

remove

public V remove(Object key)

Specified by:

remove in interface Map<K,V>

Overrides:

remove in class Hashtable<K,V>

clear

public void clear()

Specified by:

clear in interface Map<K,V>

Overrides:

clear in class Hashtable<K,V>

getKeys

public XdevList<K> getKeys()

Returns a XdevList containing all the keys of this XdevHashtable.

Returns:

a XdevList containing all the keys of this XdevHashtable.

getValues

public XdevList<V> getValues()

Returns a XdevList containing all the values of this XdevHashtable.

Returns:

a XdevList containing all the values of this XdevHashtable.

resetCursor

public void resetCursor()

Resets the cursor for this XdevHashtable.

next

public boolean next()

Tests if this XdevHashtable contains more elements.

If this XdevHashtable contains more elements, the cursor is set to next element; otherwise the cursor is reseted via resetCursor().

Returns:

true if and only if this XdevHashtable object contains at least one more element to provide; false otherwise.

getKey

public K getKey()

Returns the key at the current cursor position.

Returns:

the key at the current cursor position.

See Also:

next(), resetCursor()

getValue

public V getValue()

Returns the value at the current cursor position.

Returns:

the value at the current cursor position.

See Also:

next(), resetCursor()

toString

public String toString()

Overrides:

toString in class Hashtable<K,V>

toString

public String toString(String separator)

Returns a String representation of all elements of this XdevHashtable separated by the specified separator.

Parameters:

separator - String to separated the list elements.

Returns:

a String representation of all elements of this XdevHashtable separated by the specified separator.

copy

public XdevHashtable<K,V> copy()

Creates a (defensive) copy of this XdevHashtable.

Returns:

a (defensive) copy of this XdevHashtable.

clone

public XdevHashtable<K,V> clone()

Returns a field-for-field copy of this instance.

Specified by:

clone in interface Copyable<XdevHashtable<K,V>>

Overrides:

clone in class Hashtable<K,V>

Returns:

a field-for-field copy of this instance.