public class MapSet extends AbstractSet implements Cloneable, Externalizable, ExternalizableLite
Modifier and Type | Field and Description |
---|---|
protected Map |
m_map
The underlying Map.
|
protected static Object |
NO_VALUE
A no-value object.
|
Constructor and Description |
---|
MapSet()
Default constructor.
|
MapSet(Map map)
Construct a MapSet that uses the given Map for its underlying storage.
|
Modifier and Type | Method and Description |
---|---|
boolean |
add(Object o)
Ensures that this Set contains the specified element.
|
boolean |
addAll(Collection coll)
Adds all of the elements in the specified Collection to this Set if they're not already present.
|
void |
clear()
Removes all of the elements from this Set.
|
Object |
clone()
Create a clone of this MapSet.
|
boolean |
contains(Object o)
Returns true if this Set contains the specified element.
|
boolean |
containsAll(Collection coll)
Returns true if this Set contains all of the elements in the specified Collection.
|
Map |
getMap()
Obtain the underlying Map for purposes of synchronization or read-only access; the caller must never directly modify the returned Map.
|
protected Map |
instantiateMap()
Factory pattern: Provide an underlying Map for this Set implementation to store its contents in.
|
Iterator |
iterator()
Returns an iterator over the elements in this Set.
|
void |
readExternal(DataInput in)
Restore the contents of this object by loading the object's state from the passed DataInput object.
|
void |
readExternal(ObjectInput in)
Initialize this object from the contents of the passed object stream.
|
boolean |
remove(Object o)
Removes the specified element from this Set if it is present.
|
boolean |
removeAll(Collection coll)
Removes from this Set all of its elements that are contained in the specified Collection.
|
boolean |
retainAll(Collection coll)
Retains only the elements in this Set that are contained in the specified Collection.
|
int |
size()
Returns the number of elements in this Set.
|
Object[] |
toArray()
Returns an array containing all of the elements in this Set.
|
Object[] |
toArray(Object[] ao)
Returns an array containing all of the elements in this set whose runtime type is that of the specified array.
|
void |
writeExternal(DataOutput out)
Save the contents of this object by storing the object's state into the passed DataOutput object.
|
void |
writeExternal(ObjectOutput out)
Write the contents of this object into the passed object stream.
|
equals, hashCode
isEmpty, toString
finalize, getClass, notify, notifyAll, wait, wait, wait
isEmpty, spliterator
parallelStream, removeIf, stream
protected static final Object NO_VALUE
protected transient Map m_map
public MapSet()
MapSet(Map)
constructor. To change the default Map implementation, sub-class the MapSet and override the instantiateMap()
method.public MapSet(Map map)
map
- the underlying Map objectpublic int size()
size
in interface Collection
size
in interface Set
size
in class AbstractCollection
public boolean contains(Object o)
contains
in interface Collection
contains
in interface Set
contains
in class AbstractCollection
public Iterator iterator()
iterator
in interface Iterable
iterator
in interface Collection
iterator
in interface Set
iterator
in class AbstractCollection
public Object[] toArray()
Collection.toArray()
method.toArray
in interface Collection
toArray
in interface Set
toArray
in class AbstractCollection
public Object[] toArray(Object[] ao)
Collection.toArray(Object[])
method.toArray
in interface Collection
toArray
in interface Set
toArray
in class AbstractCollection
ao
- the array into which the elements of this Set are to be stored, if it is big enough; otherwise, a new array of the same runtime type is allocated for this purposeArrayStoreException
- the runtime type of a is not a supertype of the runtime type of every element in this Setpublic boolean add(Object o)
add
in interface Collection
add
in interface Set
add
in class AbstractCollection
o
- element to be added to this Setpublic boolean remove(Object o)
remove
in interface Collection
remove
in interface Set
remove
in class AbstractCollection
o
- object to be removed from this Set, if presentpublic boolean containsAll(Collection coll)
containsAll
in interface Collection
containsAll
in interface Set
containsAll
in class AbstractCollection
coll
- Collection to be checked for containment in this Setcontains(Object)
public boolean addAll(Collection coll)
addAll
in interface Collection
addAll
in interface Set
addAll
in class AbstractCollection
coll
- Collection whose elements are to be added to this Setadd(Object)
public boolean retainAll(Collection coll)
retainAll
in interface Collection
retainAll
in interface Set
retainAll
in class AbstractCollection
coll
- Collection that defines which elements this Set will retainpublic boolean removeAll(Collection coll)
removeAll
in interface Collection
removeAll
in interface Set
removeAll
in class AbstractSet
coll
- Collection that defines which elements will be removed from this Setremove(Object)
public void clear()
clear
in interface Collection
clear
in interface Set
clear
in class AbstractCollection
public Map getMap()
public Object clone()
public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException
readExternal
in interface Externalizable
in
- the stream to read data from in order to restore the objectIOException
- if an I/O exception occursClassNotFoundException
public void writeExternal(ObjectOutput out) throws IOException
writeExternal
in interface Externalizable
out
- the stream to write the object toIOException
- if an I/O exception occurspublic void readExternal(DataInput in) throws IOException
readExternal
in interface ExternalizableLite
in
- the DataInput stream to read data from in order to restore the state of this objectIOException
- if an I/O exception occursNotActiveException
- if the object is not in its initial state, and therefore cannot be deserialized intopublic void writeExternal(DataOutput out) throws IOException
writeExternal
in interface ExternalizableLite
out
- the DataOutput stream to write the state of this object toIOException
- if an I/O exception occursprotected Map instantiateMap()