Class MapBackedSet

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Iterable, java.util.Collection, java.util.Set

    @Deprecated(since="2021-04-30")
    public final class MapBackedSet
    extends java.lang.Object
    implements java.util.Set, java.io.Serializable
    Deprecated.
    Commons Collections 3 is in maintenance mode. Commons Collections 4 should be used instead.
    Decorates a Map to obtain Set behaviour.

    This class is used to create a Set with the same properties as the key set of any map. Thus, a ReferenceSet can be created by wrapping a ReferenceMap in an instance of this class.

    Most map implementation can be used to create a set by passing in dummy values. Exceptions include BidiMap implementations, as they require unique values.

    Since:
    Commons Collections 3.1
    See Also:
    Serialized Form
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      boolean add​(java.lang.Object obj)
      Deprecated.
       
      boolean addAll​(java.util.Collection coll)
      Deprecated.
       
      void clear()
      Deprecated.
       
      boolean contains​(java.lang.Object obj)
      Deprecated.
       
      boolean containsAll​(java.util.Collection coll)
      Deprecated.
       
      static java.util.Set decorate​(java.util.Map map)
      Deprecated.
      Factory method to create a set from a map.
      static java.util.Set decorate​(java.util.Map map, java.lang.Object dummyValue)
      Deprecated.
      Factory method to create a set from a map.
      boolean equals​(java.lang.Object obj)
      Deprecated.
       
      int hashCode()
      Deprecated.
       
      boolean isEmpty()
      Deprecated.
       
      java.util.Iterator iterator()
      Deprecated.
       
      boolean remove​(java.lang.Object obj)
      Deprecated.
       
      boolean removeAll​(java.util.Collection coll)
      Deprecated.
       
      boolean retainAll​(java.util.Collection coll)
      Deprecated.
       
      int size()
      Deprecated.
       
      java.lang.Object[] toArray()
      Deprecated.
       
      java.lang.Object[] toArray​(java.lang.Object[] array)
      Deprecated.
       
      • Methods inherited from class java.lang.Object

        getClass, 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

        spliterator
    • Method Detail

      • decorate

        public static java.util.Set decorate​(java.util.Map map)
        Deprecated.
        Factory method to create a set from a map.
        Parameters:
        map - the map to decorate, must not be null
        Throws:
        java.lang.IllegalArgumentException - if set is null
      • decorate

        public static java.util.Set decorate​(java.util.Map map,
                                             java.lang.Object dummyValue)
        Deprecated.
        Factory method to create a set from a map.
        Parameters:
        map - the map to decorate, must not be null
        dummyValue - the dummy value to use
        Throws:
        java.lang.IllegalArgumentException - if map is null
      • size

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

        public boolean isEmpty()
        Deprecated.
        Specified by:
        isEmpty in interface java.util.Collection
        Specified by:
        isEmpty in interface java.util.Set
      • iterator

        public java.util.Iterator iterator()
        Deprecated.
        Specified by:
        iterator in interface java.util.Collection
        Specified by:
        iterator in interface java.lang.Iterable
        Specified by:
        iterator in interface java.util.Set
      • contains

        public boolean contains​(java.lang.Object obj)
        Deprecated.
        Specified by:
        contains in interface java.util.Collection
        Specified by:
        contains in interface java.util.Set
      • containsAll

        public boolean containsAll​(java.util.Collection coll)
        Deprecated.
        Specified by:
        containsAll in interface java.util.Collection
        Specified by:
        containsAll in interface java.util.Set
      • add

        public boolean add​(java.lang.Object obj)
        Deprecated.
        Specified by:
        add in interface java.util.Collection
        Specified by:
        add in interface java.util.Set
      • addAll

        public boolean addAll​(java.util.Collection coll)
        Deprecated.
        Specified by:
        addAll in interface java.util.Collection
        Specified by:
        addAll in interface java.util.Set
      • remove

        public boolean remove​(java.lang.Object obj)
        Deprecated.
        Specified by:
        remove in interface java.util.Collection
        Specified by:
        remove in interface java.util.Set
      • removeAll

        public boolean removeAll​(java.util.Collection coll)
        Deprecated.
        Specified by:
        removeAll in interface java.util.Collection
        Specified by:
        removeAll in interface java.util.Set
      • retainAll

        public boolean retainAll​(java.util.Collection coll)
        Deprecated.
        Specified by:
        retainAll in interface java.util.Collection
        Specified by:
        retainAll in interface java.util.Set
      • clear

        public void clear()
        Deprecated.
        Specified by:
        clear in interface java.util.Collection
        Specified by:
        clear in interface java.util.Set
      • toArray

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

        public java.lang.Object[] toArray​(java.lang.Object[] array)
        Deprecated.
        Specified by:
        toArray in interface java.util.Collection
        Specified by:
        toArray in interface java.util.Set
      • equals

        public boolean equals​(java.lang.Object obj)
        Deprecated.
        Specified by:
        equals in interface java.util.Collection
        Specified by:
        equals in interface java.util.Set
        Overrides:
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        Deprecated.
        Specified by:
        hashCode in interface java.util.Collection
        Specified by:
        hashCode in interface java.util.Set
        Overrides:
        hashCode in class java.lang.Object