/*
* Copyright (C) 2010 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 com.google.common.annotations.
Beta;
import com.google.common.annotations.
GwtCompatible;
import com.google.common.annotations.
GwtIncompatible;
import com.google.common.base.
Equivalence;
import com.google.common.base.
Function;
import com.google.common.base.
Objects;
import com.google.common.collect.
MapMaker.
RemovalListener;
import com.google.common.collect.
MapMaker.
RemovalNotification;
import java.util.concurrent.
ConcurrentMap;
import java.util.concurrent.
TimeUnit;
/**
* A class exactly like {@link MapMaker}, except restricted in the types of maps it can build.
* For the most part, you should probably just ignore the existence of this class.
*
* @param <K0> the base type for all key types of maps built by this map maker
* @param <V0> the base type for all value types of maps built by this map maker
* @author Kevin Bourrillion
* @since 7.0
* @deprecated This class existed only to support the generic paramterization necessary for the
* caching functionality in {@code MapMaker}. That functionality has been moved to {@link
* com.google.common.cache.CacheBuilder}, which is a properly generified class and thus needs no
* "Generic" equivalent; simple use {@code CacheBuilder} naturally. For general migration
* instructions, see the <a
* href="http://code.google.com/p/guava-libraries/wiki/MapMakerMigration">MapMaker Migration
* Guide</a>.
*/
@
Beta
@
Deprecated
@
GwtCompatible(emulated = true)
abstract class
GenericMapMaker<K0, V0> {
@
GwtIncompatible("To be supported")
enum
NullListener implements
RemovalListener<
Object,
Object> {
INSTANCE;
@
Override
public void
onRemoval(
RemovalNotification<
Object,
Object>
notification) {}
}
// Set by MapMaker, but sits in this class to preserve the type relationship
@
GwtIncompatible("To be supported")
RemovalListener<K0, V0>
removalListener;
// No subclasses but our own
GenericMapMaker() {}
/**
* See {@link MapMaker#keyEquivalence}.
*/
@
GwtIncompatible("To be supported")
abstract
GenericMapMaker<K0, V0>
keyEquivalence(
Equivalence<
Object>
equivalence);
/**
* See {@link MapMaker#initialCapacity}.
*/
public abstract
GenericMapMaker<K0, V0>
initialCapacity(int
initialCapacity);
/**
* See {@link MapMaker#maximumSize}.
*/
abstract
GenericMapMaker<K0, V0>
maximumSize(int
maximumSize);
/**
* See {@link MapMaker#concurrencyLevel}.
*/
public abstract
GenericMapMaker<K0, V0>
concurrencyLevel(int
concurrencyLevel);
/**
* See {@link MapMaker#weakKeys}.
*/
@
GwtIncompatible("java.lang.ref.WeakReference")
public abstract
GenericMapMaker<K0, V0>
weakKeys();
/**
* See {@link MapMaker#weakValues}.
*/
@
GwtIncompatible("java.lang.ref.WeakReference")
public abstract
GenericMapMaker<K0, V0>
weakValues();
/**
* See {@link MapMaker#softValues}.
*
* @deprecated Caching functionality in {@code MapMaker} has been moved to {@link
* com.google.common.cache.CacheBuilder}, with {@link #softValues} being replaced by {@link
* com.google.common.cache.CacheBuilder#softValues}. Note that {@code CacheBuilder} is simply
* an enhanced API for an implementation which was branched from {@code MapMaker}. <b>This
* method is scheduled for deletion in August 2014.</b>
*/
@
Deprecated
@
GwtIncompatible("java.lang.ref.SoftReference")
public abstract
GenericMapMaker<K0, V0>
softValues();
/**
* See {@link MapMaker#expireAfterWrite}.
*/
abstract
GenericMapMaker<K0, V0>
expireAfterWrite(long
duration,
TimeUnit unit);
/**
* See {@link MapMaker#expireAfterAccess}.
*/
@
GwtIncompatible("To be supported")
abstract
GenericMapMaker<K0, V0>
expireAfterAccess(long
duration,
TimeUnit unit);
/*
* Note that MapMaker's removalListener() is not here, because once you're interacting with a
* GenericMapMaker you've already called that, and shouldn't be calling it again.
*/
@
SuppressWarnings("unchecked") // safe covariant cast
@
GwtIncompatible("To be supported")
<K extends K0, V extends V0>
RemovalListener<K, V>
getRemovalListener() {
return (
RemovalListener<K, V>)
Objects.
firstNonNull(
removalListener,
NullListener.
INSTANCE);
}
/**
* See {@link MapMaker#makeMap}.
*/
public abstract <K extends K0, V extends V0>
ConcurrentMap<K, V>
makeMap();
/**
* See {@link MapMaker#makeCustomMap}.
*/
@
GwtIncompatible("MapMakerInternalMap")
abstract <K, V>
MapMakerInternalMap<K, V>
makeCustomMap();
/**
* See {@link MapMaker#makeComputingMap}.
*/
@
Deprecated
abstract <K extends K0, V extends V0>
ConcurrentMap<K, V>
makeComputingMap(
Function<? super K, ? extends V>
computingFunction);
}