/* * Copyright (C) 2008 The Guava Authors * * 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.common.collect; import static com.google.common.testing.SerializableTester.reserialize; import com.google.common.annotations.GwtCompatible; import com.google.common.annotations.GwtIncompatible; import com.google.common.base.Joiner; import com.google.common.collect.ImmutableMap.Builder; import com.google.common.collect.testing.CollectionTestSuiteBuilder; import com.google.common.collect.testing.ListTestSuiteBuilder; import com.google.common.collect.testing.MapInterfaceTest; import com.google.common.collect.testing.MinimalSet; import com.google.common.collect.testing.ReserializingTestCollectionGenerator; import com.google.common.collect.testing.ReserializingTestSetGenerator; import com.google.common.collect.testing.SampleElements.Colliders; import com.google.common.collect.testing.SampleElements.Unhashables; import com.google.common.collect.testing.SetTestSuiteBuilder; import com.google.common.collect.testing.UnhashableObject; import com.google.common.collect.testing.features.CollectionFeature; import com.google.common.collect.testing.features.CollectionSize; import com.google.common.collect.testing.google.MapGenerators.ImmutableMapEntrySetGenerator; import com.google.common.collect.testing.google.MapGenerators.ImmutableMapKeySetGenerator; import com.google.common.collect.testing.google.MapGenerators.ImmutableMapUnhashableValuesGenerator; import com.google.common.collect.testing.google.MapGenerators.ImmutableMapValueListGenerator; import com.google.common.collect.testing.google.MapGenerators.ImmutableMapValuesGenerator; import com.google.common.testing.NullPointerTester; import com.google.common.testing.SerializableTester; import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; import java.io.Serializable; import java.util.Collection; import java.util.Collections; import java.util.LinkedHashMap; import java.util.Map; import java.util.Map.Entry; /** * Tests for {@link ImmutableMap}. * * @author Kevin Bourrillion * @author Jesse Wilson */ @GwtCompatible(emulated = true) public class ImmutableMapTest extends TestCase { @GwtIncompatible("suite") public static Test suite() { TestSuite suite = new TestSuite(); suite.addTestSuite(ImmutableMapTest.class); suite.addTest(SetTestSuiteBuilder.using(new ImmutableMapKeySetGenerator()) .withFeatures( CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.REJECTS_DUPLICATES_AT_CREATION, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.keySet") .createTestSuite()); suite.addTest(SetTestSuiteBuilder.using(new ImmutableMapEntrySetGenerator()) .withFeatures( CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.REJECTS_DUPLICATES_AT_CREATION, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.entrySet") .createTestSuite()); suite.addTest(CollectionTestSuiteBuilder.using( new ImmutableMapValuesGenerator()) .withFeatures(CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.values") .createTestSuite()); suite.addTest(SetTestSuiteBuilder.using( ReserializingTestSetGenerator.newInstance( new ImmutableMapKeySetGenerator())) .withFeatures( CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.REJECTS_DUPLICATES_AT_CREATION, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.keySet, reserialized") .createTestSuite()); suite.addTest(SetTestSuiteBuilder.using( ReserializingTestSetGenerator.newInstance( new ImmutableMapKeySetGenerator())) .withFeatures( CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.REJECTS_DUPLICATES_AT_CREATION, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.entrySet, reserialized") .createTestSuite()); suite.addTest(CollectionTestSuiteBuilder.using( ReserializingTestCollectionGenerator.newInstance( new ImmutableMapValuesGenerator())) .withFeatures(CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.values, reserialized") .createTestSuite()); suite.addTest(CollectionTestSuiteBuilder.using( new ImmutableMapUnhashableValuesGenerator()) .withFeatures(CollectionSize.ANY, CollectionFeature.KNOWN_ORDER, CollectionFeature.ALLOWS_NULL_QUERIES) .named("ImmutableMap.values, unhashable") .createTestSuite()); suite.addTest(ListTestSuiteBuilder.using( new ImmutableMapValueListGenerator()) .named("ImmutableMap.values.asList") .withFeatures(CollectionSize.ANY, CollectionFeature.ALLOWS_NULL_QUERIES) .createTestSuite()); return suite; } public abstract static class AbstractMapTests<K, V> extends MapInterfaceTest<K, V> { public AbstractMapTests() { super(false, false, false, false, false); } @Override protected Map<K, V> makeEmptyMap() { throw new UnsupportedOperationException(); } private static final Joiner joiner = Joiner.on(", "); @Override protected void assertMoreInvariants(Map<K, V> map) { // TODO: can these be moved to MapInterfaceTest? for (Entry<K, V> entry : map.entrySet()) { assertEquals(entry.getKey() + "=" + entry.getValue(), entry.toString()); } assertEquals("{" + joiner.join(map.entrySet()) + "}", map.toString()); assertEquals("[" + joiner.join(map.entrySet()) + "]", map.entrySet().toString()); assertEquals("[" + joiner.join(map.keySet()) + "]", map.keySet().toString()); assertEquals("[" + joiner.join(map.values()) + "]", map.values().toString()); assertEquals(MinimalSet.from(map.entrySet()), map.entrySet()); assertEquals(Sets.newHashSet(map.keySet()), map.keySet()); } } public static class MapTests extends AbstractMapTests<String, Integer> { @Override protected Map<String, Integer> makeEmptyMap() { return ImmutableMap.of(); } @Override protected Map<String, Integer> makePopulatedMap() { return ImmutableMap.of("one", 1, "two", 2, "three", 3); } @Override protected String getKeyNotInPopulatedMap() { return "minus one"; } @Override protected Integer getValueNotInPopulatedMap() { return -1; } } public static class SingletonMapTests extends AbstractMapTests<String, Integer> { @Override protected Map<String, Integer> makePopulatedMap() { return ImmutableMap.of("one", 1); } @Override protected String getKeyNotInPopulatedMap() { return "minus one"; } @Override protected Integer getValueNotInPopulatedMap() { return -1; } } @GwtIncompatible("SerializableTester") public static class ReserializedMapTests extends AbstractMapTests<String, Integer> { @Override protected Map<String, Integer> makePopulatedMap() { return SerializableTester.reserialize( ImmutableMap.of("one", 1, "two", 2, "three", 3)); } @Override protected String getKeyNotInPopulatedMap() { return "minus one"; } @Override protected Integer getValueNotInPopulatedMap() { return -1; } } public static class MapTestsWithBadHashes extends AbstractMapTests<Object, Integer> { @Override protected Map<Object, Integer> makeEmptyMap() { throw new UnsupportedOperationException(); } @Override protected Map<Object, Integer> makePopulatedMap() { Colliders colliders = new Colliders(); return ImmutableMap.of( colliders.e0, 0, colliders.e1, 1, colliders.e2, 2, colliders.e3, 3); } @Override protected Object getKeyNotInPopulatedMap() { return new Colliders().e4; } @Override protected Integer getValueNotInPopulatedMap() { return 4; } } @GwtIncompatible("GWT's ImmutableMap emulation is backed by java.util.HashMap.") public static class MapTestsWithUnhashableValues extends AbstractMapTests<Integer, UnhashableObject> { @Override protected Map<Integer, UnhashableObject> makeEmptyMap() { return ImmutableMap.of(); } @Override protected Map<Integer, UnhashableObject> makePopulatedMap() { Unhashables unhashables = new Unhashables(); return ImmutableMap.of( 0, unhashables.e0, 1, unhashables.e1, 2, unhashables.e2); } @Override protected Integer getKeyNotInPopulatedMap() { return 3; } @Override protected UnhashableObject getValueNotInPopulatedMap() { return new Unhashables().e3; } } @GwtIncompatible("GWT's ImmutableMap emulation is backed by java.util.HashMap.") public static class MapTestsWithSingletonUnhashableValue extends MapTestsWithUnhashableValues { @Override protected Map<Integer, UnhashableObject> makePopulatedMap() { Unhashables unhashables = new Unhashables(); return ImmutableMap.of(0, unhashables.e0); } } public static class CreationTests extends TestCase { public void testEmptyBuilder() { ImmutableMap<String, Integer> map = new Builder<String, Integer>().build(); assertEquals(Collections.<String, Integer>emptyMap(), map); } public void testSingletonBuilder() { ImmutableMap<String, Integer> map = new Builder<String, Integer>() .put("one", 1) .build(); assertMapEquals(map, "one", 1); } public void testBuilder() { ImmutableMap<String, Integer> map = new Builder<String, Integer>() .put("one", 1) .put("two", 2) .put("three", 3) .put("four", 4) .put("five", 5) .build(); assertMapEquals(map, "one", 1, "two", 2, "three", 3, "four", 4, "five", 5); } public void testBuilder_withImmutableEntry() { ImmutableMap<String, Integer> map = new Builder<String, Integer>() .put(Maps.immutableEntry("one", 1)) .build(); assertMapEquals(map, "one", 1); } public void testBuilder_withImmutableEntryAndNullContents() { Builder<String, Integer> builder = new Builder<String, Integer>(); try { builder.put(Maps.immutableEntry("one", (Integer) null)); fail(); } catch (NullPointerException expected) { } try { builder.put(Maps.immutableEntry((String) null, 1)); fail(); } catch (NullPointerException expected) { } } private static class StringHolder { String string; } public void testBuilder_withMutableEntry() { ImmutableMap.Builder<String, Integer> builder = new Builder<String, Integer>(); final StringHolder holder = new StringHolder(); holder.string = "one"; Entry<String, Integer> entry = new AbstractMapEntry<String, Integer>() { @Override public String getKey() { return holder.string; } @Override public Integer getValue() { return 1; } }; builder.put(entry); holder.string = "two"; assertMapEquals(builder.build(), "one", 1); } public void testBuilderPutAllWithEmptyMap() { ImmutableMap<String, Integer> map = new Builder<String, Integer>() .putAll(Collections.<String, Integer>emptyMap()) .build(); assertEquals(Collections.<String, Integer>emptyMap(), map); } public void testBuilderPutAll() { Map<String, Integer> toPut = new LinkedHashMap<String, Integer>(); toPut.put("one", 1); toPut.put("two", 2); toPut.put("three", 3); Map<String, Integer> moreToPut = new LinkedHashMap<String, Integer>(); moreToPut.put("four", 4); moreToPut.put("five", 5); ImmutableMap<String, Integer> map = new Builder<String, Integer>() .putAll(toPut) .putAll(moreToPut) .build(); assertMapEquals(map, "one", 1, "two", 2, "three", 3, "four", 4, "five", 5); } public void testBuilderReuse() { Builder<String, Integer> builder = new Builder<String, Integer>(); ImmutableMap<String, Integer> mapOne = builder .put("one", 1) .put("two", 2) .build(); ImmutableMap<String, Integer> mapTwo = builder .put("three", 3) .put("four", 4) .build(); assertMapEquals(mapOne, "one", 1, "two", 2); assertMapEquals(mapTwo, "one", 1, "two", 2, "three", 3, "four", 4); } public void testBuilderPutNullKey() { Builder<String, Integer> builder = new Builder<String, Integer>(); try { builder.put(null, 1); fail(); } catch (NullPointerException expected) { } } public void testBuilderPutNullValue() { Builder<String, Integer> builder = new Builder<String, Integer>(); try { builder.put("one", null); fail(); } catch (NullPointerException expected) { } } public void testBuilderPutNullKeyViaPutAll() { Builder<String, Integer> builder = new Builder<String, Integer>(); try { builder.putAll(Collections.<String, Integer>singletonMap(null, 1)); fail(); } catch (NullPointerException expected) { } } public void testBuilderPutNullValueViaPutAll() { Builder<String, Integer> builder = new Builder<String, Integer>(); try { builder.putAll(Collections.<String, Integer>singletonMap("one", null)); fail(); } catch (NullPointerException expected) { } } public void testPuttingTheSameKeyTwiceThrowsOnBuild() { Builder<String, Integer> builder = new Builder<String, Integer>() .put("one", 1) .put("one", 1); // throwing on this line would be even better try { builder.build(); fail(); } catch (IllegalArgumentException expected) { assertEquals("duplicate key: one", expected.getMessage()); } } public void testOf() { assertMapEquals( ImmutableMap.of("one", 1), "one", 1); assertMapEquals( ImmutableMap.of("one", 1, "two", 2), "one", 1, "two", 2); assertMapEquals( ImmutableMap.of("one", 1, "two", 2, "three", 3), "one", 1, "two", 2, "three", 3); assertMapEquals( ImmutableMap.of("one", 1, "two", 2, "three", 3, "four", 4), "one", 1, "two", 2, "three", 3, "four", 4); assertMapEquals( ImmutableMap.of("one", 1, "two", 2, "three", 3, "four", 4, "five", 5), "one", 1, "two", 2, "three", 3, "four", 4, "five", 5); } public void testOfNullKey() { try { ImmutableMap.of(null, 1); fail(); } catch (NullPointerException expected) { } try { ImmutableMap.of("one", 1, null, 2); fail(); } catch (NullPointerException expected) { } } public void testOfNullValue() { try { ImmutableMap.of("one", null); fail(); } catch (NullPointerException expected) { } try { ImmutableMap.of("one", 1, "two", null); fail(); } catch (NullPointerException expected) { } } public void testOfWithDuplicateKey() { try { ImmutableMap.of("one", 1, "one", 1); fail(); } catch (IllegalArgumentException expected) { assertEquals("duplicate key: one", expected.getMessage()); } } public void testCopyOfEmptyMap() { ImmutableMap<String, Integer> copy = ImmutableMap.copyOf(Collections.<String, Integer>emptyMap()); assertEquals(Collections.<String, Integer>emptyMap(), copy); assertSame(copy, ImmutableMap.copyOf(copy)); } public void testCopyOfSingletonMap() { ImmutableMap<String, Integer> copy = ImmutableMap.copyOf(Collections.singletonMap("one", 1)); assertMapEquals(copy, "one", 1); assertSame(copy, ImmutableMap.copyOf(copy)); } public void testCopyOf() { Map<String, Integer> original = new LinkedHashMap<String, Integer>(); original.put("one", 1); original.put("two", 2); original.put("three", 3); ImmutableMap<String, Integer> copy = ImmutableMap.copyOf(original); assertMapEquals(copy, "one", 1, "two", 2, "three", 3); assertSame(copy, ImmutableMap.copyOf(copy)); } } public void testNullGet() { ImmutableMap<String, Integer> map = ImmutableMap.of("one", 1); assertNull(map.get(null)); } @GwtIncompatible("NullPointerTester") public void testNullPointers() throws Exception { NullPointerTester tester = new NullPointerTester(); tester.testAllPublicStaticMethods(ImmutableMap.class); tester.testAllPublicInstanceMethods( new ImmutableMap.Builder<Object, Object>()); tester.testAllPublicInstanceMethods(ImmutableMap.of()); tester.testAllPublicInstanceMethods(ImmutableMap.of("one", 1)); tester.testAllPublicInstanceMethods( ImmutableMap.of("one", 1, "two", 2, "three", 3)); } private static <K, V> void assertMapEquals(Map<K, V> map, Object... alternatingKeysAndValues) { assertEquals(map.size(), alternatingKeysAndValues.length / 2); int i = 0; for (Entry<K, V> entry : map.entrySet()) { assertEquals(alternatingKeysAndValues[i++], entry.getKey()); assertEquals(alternatingKeysAndValues[i++], entry.getValue()); } } private static class IntHolder implements Serializable { public int value; public IntHolder(int value) { this.value = value; } @Override public boolean equals(Object o) { return (o instanceof IntHolder) && ((IntHolder) o).value == value; } @Override public int hashCode() { return value; } private static final long serialVersionUID = 5; } public void testMutableValues() { IntHolder holderA = new IntHolder(1); IntHolder holderB = new IntHolder(2); Map<String, IntHolder> map = ImmutableMap.of("a", holderA, "b", holderB); holderA.value = 3; assertTrue(map.entrySet().contains( Maps.immutableEntry("a", new IntHolder(3)))); Map<String, Integer> intMap = ImmutableMap.of("a", 3, "b", 2); assertEquals(intMap.hashCode(), map.entrySet().hashCode()); assertEquals(intMap.hashCode(), map.hashCode()); } @GwtIncompatible("SerializableTester") public void testViewSerialization() { Map<String, Integer> map = ImmutableMap.of("one", 1, "two", 2, "three", 3); LenientSerializableTester.reserializeAndAssertLenient(map.entrySet()); LenientSerializableTester.reserializeAndAssertLenient(map.keySet()); Collection<Integer> reserializedValues = reserialize(map.values()); assertEquals(Lists.newArrayList(map.values()), Lists.newArrayList(reserializedValues)); assertTrue(reserializedValues instanceof ImmutableCollection); } }