Interface CompositeMap.MapMutator

  • Enclosing class:
    CompositeMap

    @Deprecated(since="2021-04-30")
    public static interface CompositeMap.MapMutator
    Deprecated.
    Commons Collections 3 is in maintenance mode. Commons Collections 4 should be used instead.
    This interface allows definition for all of the indeterminate mutators in a CompositeMap, as well as providing a hook for callbacks on key collisions.
    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      java.lang.Object put​(CompositeMap map, java.util.Map[] composited, java.lang.Object key, java.lang.Object value)
      Deprecated.
      Called when the CompositeMap.put() method is invoked.
      void putAll​(CompositeMap map, java.util.Map[] composited, java.util.Map mapToAdd)
      Deprecated.
      Called when the CompositeMap.putAll() method is invoked.
      void resolveCollision​(CompositeMap composite, java.util.Map existing, java.util.Map added, java.util.Collection intersect)
      Deprecated.
      Called when adding a new Composited Map results in a key collision.
    • Method Detail

      • resolveCollision

        void resolveCollision​(CompositeMap composite,
                              java.util.Map existing,
                              java.util.Map added,
                              java.util.Collection intersect)
        Deprecated.
        Called when adding a new Composited Map results in a key collision.
        Parameters:
        composite - the CompositeMap with the collision
        existing - the Map already in the composite which contains the offending key
        added - the Map being added
        intersect - the intersection of the keysets of the existing and added maps
      • put

        java.lang.Object put​(CompositeMap map,
                             java.util.Map[] composited,
                             java.lang.Object key,
                             java.lang.Object value)
        Deprecated.
        Called when the CompositeMap.put() method is invoked.
        Parameters:
        map - the CompositeMap which is being modified
        composited - array of Maps in the CompositeMap being modified
        key - key with which the specified value is to be associated.
        value - value to be associated with the specified key.
        Returns:
        previous value associated with specified key, or null if there was no mapping for key. A null return can also indicate that the map previously associated null with the specified key, if the implementation supports null values.
        Throws:
        java.lang.UnsupportedOperationException - if not defined
        java.lang.ClassCastException - if the class of the specified key or value prevents it from being stored in this map.
        java.lang.IllegalArgumentException - if some aspect of this key or value prevents it from being stored in this map.
        java.lang.NullPointerException - this map does not permit null keys or values, and the specified key or value is null.
      • putAll

        void putAll​(CompositeMap map,
                    java.util.Map[] composited,
                    java.util.Map mapToAdd)
        Deprecated.
        Called when the CompositeMap.putAll() method is invoked.
        Parameters:
        map - the CompositeMap which is being modified
        composited - array of Maps in the CompositeMap being modified
        mapToAdd - Mappings to be stored in this CompositeMap
        Throws:
        java.lang.UnsupportedOperationException - if not defined
        java.lang.ClassCastException - if the class of the specified key or value prevents it from being stored in this map.
        java.lang.IllegalArgumentException - if some aspect of this key or value prevents it from being stored in this map.
        java.lang.NullPointerException - this map does not permit null keys or values, and the specified key or value is null.