package nl.tudelft.simulation.immutablecollections; import java.util.Collection; import java.util.Set; import java.util.Spliterator; import java.util.function.Consumer; import java.util.stream.Stream; import nl.tudelft.simulation.language.Throw; /** * An abstract base class for an immutable wrapper for a Set. *

* Copyright (c) 2013-2018 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights * reserved.
* BSD-style license. See DSOL License. *

* $LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck * $, initial version May 7, 2016
* @author Alexander Verbraeck * @author Peter Knoppers * @author Wouter Schakel * @param the type of content of this Set */ public abstract class ImmutableAbstractSet extends ImmutableAbstractCollection implements ImmutableSet { /** */ private static final long serialVersionUID = 20160507L; /** the set that is wrapped, without giving access to methods that can change it. */ private final Set set; /** * Construct an abstract immutable set. Make sure that the argument is a safe copy of the set of the right type! * Copying does not take place in the Abstract class! * @param set a safe copy of the set to use for the immutable set * @param copyOrWrap indicate whether the immutable is a copy or a wrap */ protected ImmutableAbstractSet(final Set set, final Immutable copyOrWrap) { super(copyOrWrap); Throw.whenNull(set, "the collection argument cannot be null"); this.set = set; } /** {@inheritDoc} */ @Override public final Collection toCollection() { return toSet(); } /** {@inheritDoc} */ @Override protected Set getCollection() { return this.set; } /** {@inheritDoc} */ @Override public final int size() { return this.set.size(); } /** {@inheritDoc} */ @Override public final boolean isEmpty() { return this.set.isEmpty(); } /** {@inheritDoc} */ @Override public final boolean contains(final Object o) { return this.set.contains(o); } /** {@inheritDoc} */ @Override public final Object[] toArray() { return this.set.toArray(); } /** {@inheritDoc} */ @Override public final T[] toArray(final T[] a) { return this.set.toArray(a); } /** {@inheritDoc} */ @Override public final ImmutableIterator iterator() { return new ImmutableIterator(this.set.iterator()); } /** {@inheritDoc} */ @Override public final void forEach(final Consumer action) { this.set.forEach(action); } /** {@inheritDoc} */ @Override public final Spliterator spliterator() { return this.set.spliterator(); } /** {@inheritDoc} */ @Override public final boolean containsAll(final Collection c) { return this.set.containsAll(c); } /** {@inheritDoc} */ @Override public final boolean containsAll(final ImmutableCollection c) { return this.set.containsAll(c.toCollection()); } /** {@inheritDoc} */ @Override public final Stream stream() { return this.set.stream(); } /** {@inheritDoc} */ @Override public final Stream parallelStream() { return this.set.parallelStream(); } /** {@inheritDoc} */ @Override public final boolean isWrap() { return this.copyOrWrap.isWrap(); } /** {@inheritDoc} */ @Override @SuppressWarnings("checkstyle:designforextension") public int hashCode() { final int prime = 31; int result = 1; result = prime * result + ((this.set == null) ? 0 : this.set.hashCode()); return result; } /** {@inheritDoc} */ @Override @SuppressWarnings({"checkstyle:designforextension", "checkstyle:needbraces"}) public boolean equals(final Object obj) { if (this == obj) return true; if (obj == null) return false; if (getClass() != obj.getClass()) return false; ImmutableAbstractSet other = (ImmutableAbstractSet) obj; if (this.set == null) { if (other.set != null) return false; } else if (!this.set.equals(other.set)) return false; return true; } /** {@inheritDoc} */ @Override @SuppressWarnings("checkstyle:designforextension") public String toString() { return "Immutable[" + this.set.toString() + "]"; } }