Package me.datafox.dfxengine.handles

Class HashHandleSet

java.lang.Object

java.util.AbstractCollection<Handle>

java.util.AbstractSet<Handle>

java.util.HashSet<Handle>

me.datafox.dfxengine.handles.HashHandleSet

All Implemented Interfaces:

Serializable, Cloneable, Iterable<Handle>, Collection<Handle>, Set<Handle>, HandleSet

public class HashHandleSet
extends HashSet<Handle>
implements HandleSet

An unordered implementation of HandleSet backed with a HashSet.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
HashHandleSet(Space space)	Uses LoggerFactory.getLogger(Class) with HashHandleSet.class.
HashHandleSet(Space space, org.slf4j.Logger logger)

Method Summary

Modifier and Type	Method	Description
Handle	add(String id)	Creates a Handle with the specified id if one does not already exist and adds it to this set.
boolean	add(Handle handle)	Adds the specified element to this set if it is not already present.
boolean	addAll(Collection<? extends Handle> c)	Adds all elements in the specified collection to this set if they're not already present.
boolean	contains(Object o)	Returns true if this set contains the specified element.
boolean	containsAll(Collection<?> c)	Returns true if this set contains all elements present in the specified collection.
Handle	get(String id)	Returns the Handle in this set with the specified String id, or null if none is present.
Collection<Handle>	getByTag(Object tag)	Returns all Handles in this set containing the specified tag.
Collection<Handle>	getByTags(Collection<?> tags)	Returns all Handles in this set containing the specified tags.
boolean	remove(Object o)	Removes the specified element from this set if it is present.
boolean	removeAll(Collection<?> c)	Removes from this set all of its elements that are contained in the specified collection.
boolean	retainAll(Collection<?> c)	Retains only the elements in this set that are contained in the specified collection.
HandleSet	unmodifiable()	Returns an unmodifiable version of this set.

Methods inherited from class java.util.HashSet

clear, clone, isEmpty, iterator, newHashSet, size, spliterator, toArray, toArray

Methods inherited from class java.util.AbstractSet

equals, hashCode

Methods inherited from class java.util.AbstractCollection

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface me.datafox.dfxengine.handles.api.HandleSet

getSpace

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

clear, equals, hashCode, isEmpty, iterator, size, spliterator, toArray, toArray

Constructor Details

HashHandleSet

public HashHandleSet(Space space,
 org.slf4j.Logger logger)

Parameters:

space - Space to be associated with this set

logger - Logger for this set

HashHandleSet

public HashHandleSet(Space space)

Uses LoggerFactory.getLogger(Class) with HashHandleSet.class.

Parameters:

space - Space to be associated with this set

Method Details

get

public Handle get(String id)

Returns the Handle in this set with the specified String id, or null if none is present.

Specified by:

get in interface HandleSet

Parameters:

id - String id of a Handle

Returns:

Handle with the given id, or null if none is present

Throws:

NullPointerException - if the specified id is null

add

public Handle add(String id)

Creates a Handle with the specified id if one does not already exist and adds it to this set.

Specified by:

add in interface HandleSet

Parameters:

id - id for the new Handle

Returns:

created or pre-existing Handle

Throws:

UnsupportedOperationException - if the add operation is not supported by this set

NullPointerException - if the id is null

IllegalArgumentException - if the id is empty, blank, contains non-ASCII or non-printable characters or more than one colon (:)

unmodifiable

public HandleSet unmodifiable()

Returns an unmodifiable version of this set. All changes made to the original set will be reflected in the returned one.

Specified by:

unmodifiable in interface HandleSet

Returns:

unmodifiable version of this set

getByTag

public Collection<Handle> getByTag(Object tag)

Returns all Handles in this set containing the specified tag. The tag may be a Handle or its String id.

Specified by:

getByTag in interface HandleSet

Parameters:

tag - tag Handle or its String id

Returns:

all Handles in this set containing the specified tag

Throws:

ClassCastException - if the tag is not a Handle or a String

NullPointerException - if the tag is null

IllegalArgumentException - if the Handle is not a tag

getByTags

public Collection<Handle> getByTags(Collection<?> tags)

Returns all Handles in this set containing the specified tags. The tags may be Handles or their String ids.

Specified by:

getByTags in interface HandleSet

Parameters:

tags - tag Handles or their String ids

Returns:

all Handles in this set containing the specified tags

Throws:

ClassCastException - if any of the tags is not a Handle or a String

NullPointerException - if the specified collection contains one or more null elements or if the collection itself is null

IllegalArgumentException - if any of the Handles is not a tag

contains

public boolean contains(Object o)

Returns true if this set contains the specified element. The element may be a Handle or its String id.

Specified by:

contains in interface Collection<Handle>

Specified by:

contains in interface HandleSet

Specified by:

contains in interface Set<Handle>

Overrides:

contains in class HashSet<Handle>

Parameters:

o - Handle element or its String id whose presence in this set is to be tested

Returns:

true if this set contains the specified element

Throws:

ClassCastException - if the object is of not a Handle or a String

NullPointerException - if the specified element is null

add

public boolean add(Handle handle)

Adds the specified element to this set if it is not already present. The Handle element must be present in this set's associated Space.

Specified by:

add in interface Collection<Handle>

Specified by:

add in interface HandleSet

Specified by:

add in interface Set<Handle>

Overrides:

add in class HashSet<Handle>

Parameters:

handle - element to be added to this set

Returns:

true if this set did not already contain the specified element

Throws:

UnsupportedOperationException - if the add operation is not supported by this set

NullPointerException - if the specified element is null

IllegalArgumentException - if the Handle element is not present in this set's associated Space

remove

public boolean remove(Object o)

Removes the specified element from this set if it is present. The element may be a Handle or its String id.

Specified by:

remove in interface Collection<Handle>

Specified by:

remove in interface HandleSet

Specified by:

remove in interface Set<Handle>

Overrides:

remove in class HashSet<Handle>

Parameters:

o - Handle element or its String id to be removed from this set, if present

Returns:

true if this set contained the specified element

Throws:

UnsupportedOperationException - if the remove operation is not supported by this set

ClassCastException - if the object is of not a Handle or a String

NullPointerException - if the specified element is null

containsAll

public boolean containsAll(Collection<?> c)

Returns true if this set contains all elements present in the specified collection. The elements may be Handles or their String ids.

Specified by:

containsAll in interface Collection<Handle>

Specified by:

containsAll in interface HandleSet

Specified by:

containsAll in interface Set<Handle>

Overrides:

containsAll in class AbstractCollection<Handle>

Parameters:

c - Handle elements or their String ids to be checked for containment in this set

Returns:

true if this set contains all elements of the specified collection

Throws:

ClassCastException - if any of the elements is not a Handle or a String

NullPointerException - if the specified collection contains one or more null elements

addAll

public boolean addAll(Collection<? extends Handle> c)

Adds all elements in the specified collection to this set if they're not already present. The Handle elements must be present in this set's associated Space.

Specified by:

addAll in interface Collection<Handle>

Specified by:

addAll in interface HandleSet

Specified by:

addAll in interface Set<Handle>

Overrides:

addAll in class AbstractCollection<Handle>

Parameters:

c - collection containing elements to be added to this set

Returns:

true if this set changed as a result of the call

Throws:

UnsupportedOperationException - if the addAll operation is not supported by this set

NullPointerException - if the specified collection contains one or more null elements

IllegalArgumentException - if any of the Handle elements is not present within this set's associated Space

retainAll

public boolean retainAll(Collection<?> c)

Retains only the elements in this set that are contained in the specified collection. The elements may be Handles or their String ids.

Specified by:

retainAll in interface Collection<Handle>

Specified by:

retainAll in interface HandleSet

Specified by:

retainAll in interface Set<Handle>

Overrides:

retainAll in class AbstractCollection<Handle>

Parameters:

c - collection containing elements to be retained in this set

Returns:

true if this set changed as a result of the call

Throws:

UnsupportedOperationException - if the retainAll operation is not supported by this set

ClassCastException - if any of the elements is not a Handle or a String

NullPointerException - if the specified collection contains a null element

removeAll

public boolean removeAll(Collection<?> c)

Removes from this set all of its elements that are contained in the specified collection. The elements may be Handles or their String ids.

Specified by:

removeAll in interface Collection<Handle>

Specified by:

removeAll in interface HandleSet

Specified by:

removeAll in interface Set<Handle>

Overrides:

removeAll in class AbstractSet<Handle>

Parameters:

c - collection containing elements to be removed from this set

Returns:

true if this set changed as a result of the call

Throws:

UnsupportedOperationException - if the removeAll operation is not supported by this set

ClassCastException - if any of the elements is not a Handle or a String

NullPointerException - if the specified collection contains a null element