com.google.gwt.dev.util.collect.Maps Maven / Gradle / Ivy
/*
* Copyright 2009 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package com.google.gwt.dev.util.collect;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Map;
/**
* Utility methods for operating on memory-efficient maps. All maps of size 0 or
* 1 are assumed to be immutable. All maps of size greater than 1 are assumed to
* be mutable.
*/
public class Maps {
private static final Class MULTI_MAP_CLASS = HashMap.class;
private static final Class SINGLETON_MAP_CLASS = Collections.singletonMap(
null, null).getClass();
public static Map create() {
return Collections.emptyMap();
}
public static Map create(K key, V value) {
return Collections.singletonMap(key, value);
}
public static Map normalize(Map map) {
switch (map.size()) {
case 0:
return create();
case 1: {
if (map.getClass() == SINGLETON_MAP_CLASS) {
return map;
}
K key = map.keySet().iterator().next();
return create(key, map.get(key));
}
default:
if (map.getClass() == MULTI_MAP_CLASS) {
return map;
}
return new HashMap(map);
}
}
public static Map normalizeUnmodifiable(Map map) {
if (map.size() < 2) {
return normalize(map);
} else {
// TODO: implement an UnmodifiableHashMap?
return Collections.unmodifiableMap(normalize(map));
}
}
public static Map put(Map map, K key, V value) {
switch (map.size()) {
case 0:
// Empty -> Singleton
return Collections.singletonMap(key, value);
case 1: {
if (map.containsKey(key)) {
return create(key, value);
}
// Singleton -> HashMap
Map result = new HashMap();
result.put(map.keySet().iterator().next(),
map.values().iterator().next());
result.put(key, value);
return result;
}
default:
// HashMap
map.put(key, value);
return map;
}
}
public static Map putAll(Map map, Map toAdd) {
switch (toAdd.size()) {
case 0:
// No-op.
return map;
case 1: {
// Add one element.
K key = toAdd.keySet().iterator().next();
return put(map, key, toAdd.get(key));
}
default:
// True list merge, result >= 2.
switch (map.size()) {
case 0:
return new HashMap(toAdd);
case 1: {
HashMap result = new HashMap();
K key = map.keySet().iterator().next();
result.put(key, map.get(key));
result.putAll(toAdd);
return result;
}
default:
map.putAll(toAdd);
return map;
}
}
}
/**
* A variation of the put method which uses a LinkedHashMap.
*/
public static Map putOrdered(Map map, K key, V value) {
switch (map.size()) {
case 0:
// Empty -> Singleton
return Collections.singletonMap(key, value);
case 1: {
if (map.containsKey(key)) {
return create(key, value);
}
// Singleton -> LinkedHashMap
Map result = new LinkedHashMap();
result.put(map.keySet().iterator().next(),
map.values().iterator().next());
result.put(key, value);
return result;
}
default:
// LinkedHashMap
map.put(key, value);
return map;
}
}
public static Map remove(Map map, K key) {
switch (map.size()) {
case 0:
// Empty
return map;
case 1:
// Singleton -> Empty
if (map.containsKey(key)) {
return create();
}
return map;
case 2:
// HashMap -> Singleton
if (map.containsKey(key)) {
map.remove(key);
key = map.keySet().iterator().next();
return create(key, map.get(key));
}
return map;
default:
// IdentityHashMap
map.remove(key);
return map;
}
}
}