Package com.tangosol.util

Class ChainedSet<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<E>

com.tangosol.util.ChainedSet<E>

Type Parameters:

E - the type of Set elements

All Implemented Interfaces:

Iterable<E>, Collection<E>, Set<E>

public class ChainedSet<E>
extends AbstractSet<E>

An unmodifiable Set that provides access to many sets in the given order.

Note that this implementation does not ensure that the elements are unique across all chained sets. It is up to the user to provide that guarantee.

Since:

Coherence 23.03

Author:

as 2023.03.03

Field Summary

Fields

Modifier and Type	Field	Description
protected final Set<E>[]	f_aSets	An array of Sets to enumerate.

Constructor Summary

Constructors

Constructor	Description
ChainedSet(ChainedSet<E> original, Set<E> set)	Construct a ChainedSet from the existing ChainedSet and an additional Set object.
ChainedSet(ChainedSet<E> original, Set<E>... aSets)	Construct a ChainedSet from the existing ChainedSet and an array of Set objects.
ChainedSet(Collection<Set<E>> col)	Construct a ChainedSet with the provided Collection of Set objects.
ChainedSet(Set<E>... aSets)	Construct a ChainedSet with the provided array of Set objects.

Method Summary

Modifier and Type	Method	Description
boolean	add(E e)
boolean	addAll(Collection<? extends E> c)
void	clear()
boolean	contains(Object o)
boolean	containsAll(Collection<?> col)
boolean	isEmpty()
Iterator<E>	iterator()
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
int	size()
Object[]	toArray()
<T> T[]	toArray(IntFunction<T[]> generator)
<T> T[]	toArray(T[] a)

Methods inherited from class java.util.AbstractSet

equals, hashCode

Methods inherited from class java.util.AbstractCollection

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

spliterator

Field Details

f_aSets

protected final Set<E>[] f_aSets

An array of Sets to enumerate.

Constructor Details

ChainedSet

public ChainedSet(Collection<Set<E>> col)

Construct a ChainedSet with the provided Collection of Set objects.

Parameters:

col - a Collection of Set objects

ChainedSet

public ChainedSet(ChainedSet<E> original,
 Set<E> set)

Construct a ChainedSet from the existing ChainedSet and an additional Set object.

Parameters:

original - the original ChainedSet

set - a Set object to append

ChainedSet

public ChainedSet(ChainedSet<E> original,
 Set<E>... aSets)

Construct a ChainedSet from the existing ChainedSet and an array of Set objects.

Parameters:

original - the original ChainedSet

aSets - an array of Set objects

ChainedSet

public ChainedSet(Set<E>... aSets)

Construct a ChainedSet with the provided array of Set objects.

Parameters:

aSets - an array of Set objects

Method Details

size

public int size()

Specified by:

size in interface Collection<E>

Specified by:

size in interface Set<E>

Specified by:

size in class AbstractCollection<E>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<E>

Specified by:

isEmpty in interface Set<E>

Overrides:

isEmpty in class AbstractCollection<E>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<E>

Specified by:

contains in interface Set<E>

Overrides:

contains in class AbstractCollection<E>

containsAll

public boolean containsAll(Collection<?> col)

Specified by:

containsAll in interface Collection<E>

Specified by:

containsAll in interface Set<E>

Overrides:

containsAll in class AbstractCollection<E>

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Collection<E>

Specified by:

iterator in interface Iterable<E>

Specified by:

iterator in interface Set<E>

Specified by:

iterator in class AbstractCollection<E>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface Set<E>

Overrides:

toArray in class AbstractCollection<E>

toArray

public <T> T[] toArray(IntFunction<T[]> generator)

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<E>

Specified by:

toArray in interface Set<E>

Overrides:

toArray in class AbstractCollection<E>

add

public boolean add(E e)

Specified by:

add in interface Collection<E>

Specified by:

add in interface Set<E>

Overrides:

add in class AbstractCollection<E>

addAll

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

Specified by:

addAll in interface Collection<E>

Specified by:

addAll in interface Set<E>

Overrides:

addAll in class AbstractCollection<E>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<E>

Specified by:

remove in interface Set<E>

Overrides:

remove in class AbstractCollection<E>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<E>

Specified by:

removeAll in interface Set<E>

Overrides:

removeAll in class AbstractSet<E>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<E>

Specified by:

retainAll in interface Set<E>

Overrides:

retainAll in class AbstractCollection<E>

clear

public void clear()

Specified by:

clear in interface Collection<E>

Specified by:

clear in interface Set<E>

Overrides:

clear in class AbstractCollection<E>