Class ExtendedSet<E>

  • All Implemented Interfaces:
    java.lang.Iterable<E>, java.util.Collection<E>, java.util.Set<E>

    public class ExtendedSet<E>
    extends java.lang.Object
    implements java.util.Set<E>
    A Set providing additional get, insertOrReplace and conditionalRemove methods.
    • Constructor Summary

      Constructors 
      Constructor Description
      ExtendedSet​(java.util.Map<E,​E> map)
      Constructs a new instance by backing it with the supplied Map.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean add​(E e)  
      boolean addAll​(java.util.Collection<? extends E> c)  
      void clear()  
      boolean conditionalRemove​(E entry, java.util.function.Predicate<E> entryTest)
      Removes the entry if the supplied predicate evaluates to true.
      boolean contains​(java.lang.Object o)  
      boolean containsAll​(java.util.Collection<?> c)  
      E get​(java.lang.Object o)
      Returns set element that is equal to the specified object.
      boolean insertOrReplace​(E entry, java.util.function.Predicate<E> entryTest)
      Inserts the entry if it is not already in the set otherwise replaces the existing entry if the supplied predicate evaluates to true.
      boolean isEmpty()  
      java.util.Iterator<E> iterator()  
      boolean remove​(java.lang.Object o)  
      boolean removeAll​(java.util.Collection<?> c)  
      boolean retainAll​(java.util.Collection<?> c)  
      int size()  
      java.lang.Object[] toArray()  
      <T> T[] toArray​(T[] a)  
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • Methods inherited from interface java.util.Collection

        parallelStream, removeIf, stream, toArray
      • Methods inherited from interface java.lang.Iterable

        forEach
      • Methods inherited from interface java.util.Set

        equals, hashCode, spliterator
    • Constructor Detail

      • ExtendedSet

        public ExtendedSet​(java.util.Map<E,​E> map)
        Constructs a new instance by backing it with the supplied Map.

        Constructed ExtendedSet will have the same concurrency properties as that of the supplied Map.

        Parameters:
        map - input map.
    • Method Detail

      • get

        public E get​(java.lang.Object o)
        Returns set element that is equal to the specified object.
        Parameters:
        o - object
        Returns:
        set element that is equal to the input argument or null if no such set element exists
      • insertOrReplace

        public boolean insertOrReplace​(E entry,
                                       java.util.function.Predicate<E> entryTest)
        Inserts the entry if it is not already in the set otherwise replaces the existing entry if the supplied predicate evaluates to true.
        Parameters:
        entry - entry to add
        entryTest - predicate that is used to evaluate if the existing entry should be replaced
        Returns:
        true if the set is updated; false otherwise
      • conditionalRemove

        public boolean conditionalRemove​(E entry,
                                         java.util.function.Predicate<E> entryTest)
        Removes the entry if the supplied predicate evaluates to true.
        Parameters:
        entry - entry to remove
        entryTest - predicate that is used to evaluated aginst the existing entry. Return value of true implies value should be removed.
        Returns:
        true if the set is updated; false otherwise
      • size

        public int size()
        Specified by:
        size in interface java.util.Collection<E>
        Specified by:
        size in interface java.util.Set<E>
      • isEmpty

        public boolean isEmpty()
        Specified by:
        isEmpty in interface java.util.Collection<E>
        Specified by:
        isEmpty in interface java.util.Set<E>
      • contains

        public boolean contains​(java.lang.Object o)
        Specified by:
        contains in interface java.util.Collection<E>
        Specified by:
        contains in interface java.util.Set<E>
      • iterator

        public java.util.Iterator<E> iterator()
        Specified by:
        iterator in interface java.util.Collection<E>
        Specified by:
        iterator in interface java.lang.Iterable<E>
        Specified by:
        iterator in interface java.util.Set<E>
      • toArray

        public java.lang.Object[] toArray()
        Specified by:
        toArray in interface java.util.Collection<E>
        Specified by:
        toArray in interface java.util.Set<E>
      • toArray

        public <T> T[] toArray​(T[] a)
        Specified by:
        toArray in interface java.util.Collection<E>
        Specified by:
        toArray in interface java.util.Set<E>
      • add

        public boolean add​(E e)
        Specified by:
        add in interface java.util.Collection<E>
        Specified by:
        add in interface java.util.Set<E>
      • remove

        public boolean remove​(java.lang.Object o)
        Specified by:
        remove in interface java.util.Collection<E>
        Specified by:
        remove in interface java.util.Set<E>
      • containsAll

        public boolean containsAll​(java.util.Collection<?> c)
        Specified by:
        containsAll in interface java.util.Collection<E>
        Specified by:
        containsAll in interface java.util.Set<E>
      • addAll

        public boolean addAll​(java.util.Collection<? extends E> c)
        Specified by:
        addAll in interface java.util.Collection<E>
        Specified by:
        addAll in interface java.util.Set<E>
      • retainAll

        public boolean retainAll​(java.util.Collection<?> c)
        Specified by:
        retainAll in interface java.util.Collection<E>
        Specified by:
        retainAll in interface java.util.Set<E>
      • removeAll

        public boolean removeAll​(java.util.Collection<?> c)
        Specified by:
        removeAll in interface java.util.Collection<E>
        Specified by:
        removeAll in interface java.util.Set<E>
      • clear

        public void clear()
        Specified by:
        clear in interface java.util.Collection<E>
        Specified by:
        clear in interface java.util.Set<E>