/* * Copyright (c) 2015 Cisco Systems, Inc. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.yangtools.util; import com.google.common.annotations.Beta; import com.google.common.base.Preconditions; import com.google.common.collect.ImmutableMap; import com.google.common.collect.UnmodifiableIterator; import java.io.IOException; import java.io.ObjectInputStream; import java.io.ObjectOutputStream; import java.io.Serializable; import java.lang.reflect.Field; import java.util.AbstractMap.SimpleImmutableEntry; import java.util.AbstractSet; import java.util.ArrayList; import java.util.Arrays; import java.util.Collection; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.Set; import javax.annotation.Nonnull; /** * Implementation of the {@link Map} interface which stores a set of immutable mappings using a key-to-offset map and * a backing array. This is useful for situations where the same key set is shared across a multitude of maps, as this * class uses a global cache to share the key-to-offset mapping. * * @param the type of keys maintained by this map * @param the type of mapped values */ @Beta public final class ImmutableOffsetMap implements UnmodifiableMapPhase, Serializable { private static final long serialVersionUID = 1L; private final Map offsets; private final V[] objects; private int hashCode; /** * Construct a new instance backed by specified key-to-offset map and array of objects. * * @param offsets Key-to-offset map, may not be null * @param objects Array of value object, may not be null. The array is stored as is, the caller * is responsible for ensuring its contents remain unmodified. */ ImmutableOffsetMap(@Nonnull final Map offsets, @Nonnull final V[] objects) { this.offsets = Preconditions.checkNotNull(offsets); this.objects = Preconditions.checkNotNull(objects); Preconditions.checkArgument(offsets.size() == objects.length); } /** * Construct a new instance based on some other instance. * * @param m Instance to share data with, may not be null. */ ImmutableOffsetMap(@Nonnull final ImmutableOffsetMap m) { this.offsets = m.offsets; this.objects = m.objects; } /** * Create an {@link ImmutableOffsetMap} as a copy of an existing map. This is actually not completely true, * as this method returns an {@link ImmutableMap} for empty and singleton inputs, as those are more memory-efficient. * This method also recognizes {@link ImmutableOffsetMap} on input, and returns it back without doing anything else. * It also recognizes {@link MutableOffsetMap} (as returned by {@link #toModifiableMap()}) and makes an efficient * copy of its contents. All other maps are converted to an {@link ImmutableOffsetMap} with the same iteration * order as input. * * @param m Input map, may not be null. * @return An isolated, immutable copy of the input map */ @Nonnull public static Map copyOf(@Nonnull final Map m) { // Prevent a copy. Note that ImmutableMap is not listed here because of its potentially larger keySet overhead. if (m instanceof ImmutableOffsetMap || m instanceof SharedSingletonMap) { return m; } // Familiar and efficient to copy if (m instanceof MutableOffsetMap) { return ((MutableOffsetMap) m).toUnmodifiableMap(); } final int size = m.size(); if (size == 0) { // Shares a single object return ImmutableMap.of(); } if (size == 1) { // Efficient single-entry implementation final Entry e = m.entrySet().iterator().next(); return SharedSingletonMap.of(e.getKey(), e.getValue()); } final Map offsets = OffsetMapCache.offsetsFor(m.keySet()); @SuppressWarnings("unchecked") final V[] array = (V[]) new Object[offsets.size()]; for (Entry e : m.entrySet()) { array[offsets.get(e.getKey())] = e.getValue(); } return new ImmutableOffsetMap<>(offsets, array); } @Override public int size() { return offsets.size(); } @Override public boolean isEmpty() { return offsets.isEmpty(); } @Override public int hashCode() { if (hashCode != 0) { return hashCode; } int result = 0; for (Entry e : offsets.entrySet()) { result += e.getKey().hashCode() ^ objects[e.getValue()].hashCode(); } hashCode = result; return result; } @Override public boolean equals(final Object o) { if (o == this) { return true; } if (!(o instanceof Map)) { return false; } if (o instanceof ImmutableOffsetMap) { final ImmutableOffsetMap om = (ImmutableOffsetMap) o; // If the offset match, the arrays have to match, too if (offsets.equals(om.offsets)) { return Arrays.deepEquals(objects, om.objects); } } else if (o instanceof MutableOffsetMap) { // Let MutableOffsetMap do the actual work. return o.equals(this); } final Map other = (Map)o; // Size and key sets have to match if (size() != other.size() || !keySet().equals(other.keySet())) { return false; } try { // Ensure all objects are present for (Entry e : offsets.entrySet()) { if (!objects[e.getValue()].equals(other.get(e.getKey()))) { return false; } } } catch (ClassCastException e) { // Can be thrown by other.get() indicating we have incompatible key types return false; } return true; } @Override public boolean containsKey(final Object key) { return offsets.containsKey(key); } @Override public boolean containsValue(final Object value) { for (Object o : objects) { if (value.equals(o)) { return true; } } return false; } @Override public V get(final Object key) { final Integer offset = offsets.get(key); return offset == null ? null : objects[offset]; } @Override public V remove(final Object key) { throw new UnsupportedOperationException(); } @Override public V put(final K key, final V value) { throw new UnsupportedOperationException(); } @Override public void putAll(final Map m) { throw new UnsupportedOperationException(); } @Override public void clear() { throw new UnsupportedOperationException(); } @Override public Set keySet() { return offsets.keySet(); } @Override public Collection values() { return new ConstantArrayCollection<>(objects); } @Override public Set> entrySet() { return new EntrySet(); } @Override public MutableOffsetMap toModifiableMap() { return new MutableOffsetMap<>(this); } @Override public String toString() { final StringBuilder sb = new StringBuilder("{"); final Iterator it = offsets.keySet().iterator(); int i = 0; while (it.hasNext()) { sb.append(it.next()); sb.append('='); sb.append(objects[i++]); if (it.hasNext()) { sb.append(", "); } } return sb.append('}').toString(); } Map offsets() { return offsets; } V[] objects() { return objects; } private final class EntrySet extends AbstractSet> { @Override public Iterator> iterator() { final Iterator> it = offsets.entrySet().iterator(); return new UnmodifiableIterator>() { @Override public boolean hasNext() { return it.hasNext(); } @Override public Entry next() { final Entry e = it.next(); return new SimpleImmutableEntry<>(e.getKey(), objects[e.getValue()]); } }; } @Override public int size() { return offsets.size(); } } private void writeObject(final ObjectOutputStream out) throws IOException { out.writeInt(offsets.size()); for (Entry e : entrySet()) { out.writeObject(e.getKey()); out.writeObject(e.getValue()); } } private static final Field OFFSETS_FIELD = fieldFor("offsets"); private static final Field ARRAY_FIELD = fieldFor("objects"); private static Field fieldFor(final String name) { final Field f; try { f = ImmutableOffsetMap.class.getDeclaredField(name); } catch (NoSuchFieldException | SecurityException e) { throw new IllegalStateException("Failed to lookup field " + name, e); } f.setAccessible(true); return f; } private void setField(final Field field, final Object value) throws IOException { try { field.set(this, value); } catch (IllegalArgumentException | IllegalAccessException e) { throw new IOException("Failed to set field " + field, e); } } @SuppressWarnings("unchecked") private void readObject(final ObjectInputStream in) throws IOException, ClassNotFoundException { final int s = in.readInt(); final List keys = new ArrayList<>(s); final V[] values = (V[]) new Object[s]; for (int i = 0; i < s; ++i) { keys.add((K)in.readObject()); values[i] = (V)in.readObject(); } setField(OFFSETS_FIELD, OffsetMapCache.offsetsFor(keys)); setField(ARRAY_FIELD, values); } }