## org.apache.commons.collections.map
Interface CompositeMap.MapMutator

Enclosing class:
  CompositeMap

    public static interface CompositeMap.MapMutator

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
`java.lang.Object` `put(CompositeMap map, java.util.Map[] composited, java.lang.Object key, java.lang.Object value)` Called when the CompositeMap.put() method is invoked.
`void` `putAll(CompositeMap map, java.util.Map[] composited, java.util.Map mapToAdd)` Called when the CompositeMap.putAll() method is invoked.
`void` `resolveCollision(CompositeMap composite, java.util.Map existing, java.util.Map added, java.util.Collection intersect)` 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)

  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)

  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)

  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`.

Copyright © 2001-2008 The Apache Software Foundation. All Rights Reserved.