- Type Parameters:
B- the common supertype that all entries must share; often this is simply
@DoNotMock("Use ImmutableClassToInstanceMap or MutableClassToInstanceMap") @GwtCompatible public interface ClassToInstanceMap<B> extends Map<Class<? extends B>,B>A map, each entry of which maps a Java raw type to an instance of that type. In addition to implementing
Map, the additional type-safe operations
Like any other
Map<Class, Object>, this map may contain entries for primitive types, and a primitive type and its corresponding wrapper type may map to different values.
This class's support for
nullrequires some explanation: From release 31.0 onward, Guava specifies the nullness of its types through annotations. In the case of
ClassToInstanceMap, it specifies that both the key and value types are restricted to non-nullable types. This specification is reasonable for keys, which must be non-null classes. This is in contrast to the specification for values: Null values are supported by the implementation
MutableClassToInstanceMap, even though that implementation and this interface specify otherwise. Thus, if you use a nullness checker, you can safely suppress any warnings it produces when you write null values into a
MutableClassToInstanceMap. Just be sure to be prepared for null values when reading from it, since nullness checkers will assume that vaules are non-null then, too.
See the Guava User Guide article on
To map a generic type to an instance of that type, use
- Kevin Bourrillion
All Methods Instance Methods Abstract Methods Modifier and Type Method Description
<T extends B>
getInstance(Class<T> type)Returns the value the specified class is mapped to, or
nullif no entry for this class is present.
<T extends B>
putInstance(Class<T> type, T value)Maps the specified class to the specified value.
@CheckForNull <T extends B> T getInstance(Class<T> type)Returns the value the specified class is mapped to, or
nullif no entry for this class is present. This will only return a value that was bound to this specific class, not a value that may have been bound to a subtype.
@CanIgnoreReturnValue @CheckForNull <T extends B> T putInstance(Class<T> type, T value)Maps the specified class to the specified value. Does not associate this value with any of the class's supertypes.
- the value previously associated with this class (possibly
nullif there was no previous entry.