/* * Copyright (C) 2012 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 java.util.AbstractMap; import java.util.Iterator; import java.util.Map; import java.util.NavigableMap; import java.util.NavigableSet; import java.util.NoSuchElementException; import java.util.Set; import java.util.SortedMap; import javax.annotation.Nullable; /** * Skeletal implementation of {@link NavigableMap}. * * @author Louis Wasserman */ abstract class AbstractNavigableMap extends AbstractMap implements NavigableMap { @Override @Nullable public abstract V get(@Nullable Object key); @Override @Nullable public Entry firstEntry() { return Iterators.getNext(entryIterator(), null); } @Override @Nullable public Entry lastEntry() { return Iterators.getNext(descendingEntryIterator(), null); } @Override @Nullable public Entry pollFirstEntry() { return Iterators.pollNext(entryIterator()); } @Override @Nullable public Entry pollLastEntry() { return Iterators.pollNext(descendingEntryIterator()); } @Override public K firstKey() { Entry entry = firstEntry(); if (entry == null) { throw new NoSuchElementException(); } else { return entry.getKey(); } } @Override public K lastKey() { Entry entry = lastEntry(); if (entry == null) { throw new NoSuchElementException(); } else { return entry.getKey(); } } @Override @Nullable public Entry lowerEntry(K key) { return headMap(key, false).lastEntry(); } @Override @Nullable public Entry floorEntry(K key) { return headMap(key, true).lastEntry(); } @Override @Nullable public Entry ceilingEntry(K key) { return tailMap(key, true).firstEntry(); } @Override @Nullable public Entry higherEntry(K key) { return tailMap(key, false).firstEntry(); } @Override public K lowerKey(K key) { return Maps.keyOrNull(lowerEntry(key)); } @Override public K floorKey(K key) { return Maps.keyOrNull(floorEntry(key)); } @Override public K ceilingKey(K key) { return Maps.keyOrNull(ceilingEntry(key)); } @Override public K higherKey(K key) { return Maps.keyOrNull(higherEntry(key)); } abstract Iterator> entryIterator(); abstract Iterator> descendingEntryIterator(); @Override public SortedMap subMap(K fromKey, K toKey) { return subMap(fromKey, true, toKey, false); } @Override public SortedMap headMap(K toKey) { return headMap(toKey, false); } @Override public SortedMap tailMap(K fromKey) { return tailMap(fromKey, true); } @Override public NavigableSet navigableKeySet() { return new Maps.NavigableKeySet(this); } @Override public Set keySet() { return navigableKeySet(); } @Override public abstract int size(); @Override public Set> entrySet() { return new Maps.EntrySet() { @Override Map map() { return AbstractNavigableMap.this; } @Override public Iterator> iterator() { return entryIterator(); } }; } @Override public NavigableSet descendingKeySet() { return descendingMap().navigableKeySet(); } @Override public NavigableMap descendingMap() { return new DescendingMap(); } private final class DescendingMap extends Maps.DescendingMap { @Override NavigableMap forward() { return AbstractNavigableMap.this; } @Override Iterator> entryIterator() { return descendingEntryIterator(); } } }