org.jboss.weld.util.collections

Class ImmutableSet<T>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<T>

org.jboss.weld.util.collections.ImmutableSet<T>

Type Parameters:

T - the type of elements

All Implemented Interfaces:

Iterable<T>, Collection<T>, Set<T>

Direct Known Subclasses:

ImmutableHashSet

public abstract class ImmutableSet<T>
extends AbstractSet<T>

Weld's immutable set implementation. Instances returned from methods of this class may use different strategies to achieve good performance / memory consumption balance.

These strategies include:

• A single shared Set implementation instance representing an empty list
• An optimized implementation for holding one, two or three references.
• An immutable Set implementation based on hashing

Author:

Jozef Hartinger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ImmutableSet.Builder<T> Builder for building immutable sets.

Method Summary

Modifier and Type	Method and Description
boolean	add(T e)
boolean	addAll(Collection<? extends T> c)
static <T> ImmutableSet.Builder<T>	builder() Creates a new empty builder for building immutable sets.
void	clear()
boolean	containsAll(Collection<?> c)
static <T> Set<T>	copyOf(Collection<? extends T> collection) Creates a new immutable set that consists of the elements in the given collection.
static <T> Set<T>	copyOf(Iterable<? extends T> iterable)
boolean	equals(Object obj)
boolean	isEmpty()
static <T> Set<T>	of(T... elements) Creates a new immutable set that consists of given elements.
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)

Methods inherited from class java.util.AbstractSet

hashCode

Methods inherited from class java.util.AbstractCollection

contains, iterator, size, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Set

contains, hashCode, iterator, size, spliterator, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Method Detail

copyOf

public static <T> Set<T> copyOf(Collection<? extends T> collection)

Creates a new immutable set that consists of the elements in the given collection. If the given collection is already an instance created by ImmutableSet, the instance is re-used.

Parameters:

collection - the given collection

Returns:

a new immutable set that consists of the elements in the given collection

copyOf

public static <T> Set<T> copyOf(Iterable<? extends T> iterable)

of

@SafeVarargs
public static <T> Set<T> of(T... elements)

Creates a new immutable set that consists of given elements.

Parameters:

elements - the given elements

Returns:

a new immutable set that consists of given elements

builder

public static <T> ImmutableSet.Builder<T> builder()

Creates a new empty builder for building immutable sets.

Returns:

a new empty builder

add

public boolean add(T e)

Specified by:

add in interface Collection<T>

Specified by:

add in interface Set<T>

Overrides:

add in class AbstractCollection<T>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<T>

Specified by:

remove in interface Set<T>

Overrides:

remove in class AbstractCollection<T>

addAll

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

Specified by:

addAll in interface Collection<T>

Specified by:

addAll in interface Set<T>

Overrides:

addAll in class AbstractCollection<T>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<T>

Specified by:

retainAll in interface Set<T>

Overrides:

retainAll in class AbstractCollection<T>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<T>

Specified by:

removeAll in interface Set<T>

Overrides:

removeAll in class AbstractSet<T>

clear

public void clear()

Specified by:

clear in interface Collection<T>

Specified by:

clear in interface Set<T>

Overrides:

clear in class AbstractCollection<T>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<T>

Specified by:

isEmpty in interface Set<T>

Overrides:

isEmpty in class AbstractCollection<T>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<T>

Specified by:

containsAll in interface Set<T>

Overrides:

containsAll in class AbstractCollection<T>

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<T>

Specified by:

equals in interface Set<T>

Overrides:

equals in class AbstractSet<T>