org.bson.util

类 ClassMap<T>

java.lang.Object

org.bson.util.ClassMap<T>

类型参数:

T - the type of the value in this map

public class ClassMap<T>
extends java.lang.Object

Maps Class objects to values. A ClassMap is different from a regular Map in that get(clazz) does not only look to see if clazz is a key in the Map, but also walks the up superclass and interface graph of clazz to find matches. Derived matches of this sort are then cached in the registry so that matches are faster on future gets.

This is a very useful class for Class based registries.

Example:

 ClassMap<String> m = new ClassMap<String>();
 m.put(Animal.class, "Animal");
 m.put(Fox.class, "Fox");
 m.get(Fox.class) --> "Fox"
 m.get(Dog.class) --> "Animal"
  

(assuming Dog.class < Animal.class)

构造器概要

构造器

构造器和说明
ClassMap()

方法概要

限定符和类型	方法和说明
void	clear() As per java.util.Map, removes all of the mappings from this map (optional operation).
T	get(java.lang.Object key) Gets the value associated with either this Class or a superclass of this class.
static <T> java.util.List<java.lang.Class<?>>	getAncestry(java.lang.Class<T> clazz) Helper method that walks superclass and interface graph, superclasses first, then interfaces, to compute an ancestry list.
boolean	isEmpty() As per java.util.Map, returns true if this map contains no key-value mappings.
T	put(java.lang.Class<?> key, T value) As per java.util.Map, associates the specified value with the specified key in this map.
T	remove(java.lang.Object key) As per java.util.Map, removes the mapping for a key from this map if it is present
int	size() As per java.util.Map, returns the number of key-value mappings in this map.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ClassMap

public ClassMap()

方法详细资料

getAncestry

public static <T> java.util.List<java.lang.Class<?>> getAncestry(java.lang.Class<T> clazz)

Helper method that walks superclass and interface graph, superclasses first, then interfaces, to compute an ancestry list. Super types are visited left to right. Duplicates are removed such that no Class will appear in the list before one of its subtypes.

类型参数:

T - the type of the class modeled by this Class object.

参数:

clazz - the class to get the ancestors for

返回:

a list of all the super classes of clazz, starting with the class, and ending with java.lang.Object.

get

public T get(java.lang.Object key)

Gets the value associated with either this Class or a superclass of this class. If fetching for a super class, it fetches the value for the closest superclass. Returns null if the given class and none of its superclasses are in the map.

参数:

key - a Class to get the value for

返回:

the value for either this class or its nearest superclass

put

public T put(java.lang.Class<?> key,
             T value)

As per java.util.Map, associates the specified value with the specified key in this map. If the map previously contained a mapping for the key, the old value is replaced by the specified value.

参数:

key - a Class key

value - the value for this class

返回:

the previous value associated with key, or null if there was no mapping for key.

另请参阅:

Map.put(Object, Object)

remove

public T remove(java.lang.Object key)

As per java.util.Map, removes the mapping for a key from this map if it is present

参数:

key - a Class key

返回:

the previous value associated with key, or null if there was no mapping for key.

另请参阅:

Map.remove(Object)

clear

public void clear()

As per java.util.Map, removes all of the mappings from this map (optional operation).

另请参阅:

Map.clear()

size

public int size()

As per java.util.Map, returns the number of key-value mappings in this map. This will only return the number of keys explicitly added to the map, not any cached hierarchy keys.

返回:

the size of this map

另请参阅:

Map.size()

isEmpty

public boolean isEmpty()

As per java.util.Map, returns true if this map contains no key-value mappings.

返回:

true if there are no values in the map

另请参阅:

Map.isEmpty()