code: @Override
      final public void putAll(Map map) {
          ValidateUtility.objectNotNull(map, "map");
          Iterator it = map.entrySet().iterator();
          while (it.hasNext()) {
              Map.Entry e = (Map.Entry) it.next();
              put(e.getKey(), e.getValue());
          }
      }
docs: Copies all of the mappings from the specified map to this map
  (optional operation). These mappings will replace any mappings that
  this map had for any of the keys currently in the specified map.
  
  @param map Mappings to be stored in this map.
  
  @throws UnsupportedOperationException if the <tt>putAll</tt> method is
  not supported by this map.
  
  @throws ClassCastException if the class of a key or value in the
  specified map prevents it from being stored in this map.
  
  @throws IllegalArgumentException some aspect of a key or value in the
  specified map prevents it from being stored in this map.
  
  @throws NullPointerException this map does not permit <tt>null</tt>
  keys or values, and the specified key or value is
  <tt>null</tt>.