Java --- Guava Collection API javadoc

Java --- Guava Collection javadoc翻译

com.google.common.collect包

接口

BiMap<K,V>	Bimap也叫双向map，保证值向键一样也是唯一的，键值可以互换。
ClassToInstanceMap<B>	Map的每一个入口的键是java类型，值是实例对象
Interner<E>	为其他不可变类型提供类似于String.intern()的功能。返回内在的对象。
ListMultimap<K,V>	可以持有重复的key-value对的MultiMap,并且key的所有value保持插入时的顺序。
MapConstraint<K,V>	Multimap元素的限制。
MapDifference<K,V>	表示两个map之间的不同。
MapDifference.ValueDifference<V>	两个map的同一个key的不同
Maps.EntryTransformer<K,V1,V2>	将map中的key和value（v1）转换为V2值
Multimap<K,V>	类似于Map，但每一个key可以对应多个内容
Multiset<E>	支持顺序无关相等性的集合，但是可以有相同的元素。
Multiset.Entry<E>	Multiset的一个不可变元素，为元素-数量对
PeekingIterator<E>	可以不改变Iterator状态的情况下获取下一个元素
RangeMap<K extends Comparable,V>	一个范围的Key对应一个value的map
RangeSet<C extends Comparable>	C的一个非空，不连续的范围的集合
RowSortedTable<R,C,V>	继承自Table，行是排序。
SetMultimap<K,V>	一个不能包含重复key-value对的MultiMap
SortedMapDifference<K,V>	表现两个排序map之间的区别的对象
SortedMultiset<E>	一个维护元素排序的MultiSet,可能是自身的排序，也可以是Comarator接口的排序。
SortedSetMultimap<K,V>	一种SetMultimai,它的key对应的values集合是排序的，就像一个SortedSet一样.
Table<R,C,V>	一双key对应一个value，两个key分别表示为行key和列key
Table.Cell<R,C,V>	Table的一个元素，包含行键，列键和值

 

类

Class	Description
AbstractIterator<T>	该类提供了Iterator的一个骨架实现，以便实现具体类型的数据源的Iterator接口
AbstractSequentialIterator<T>	该类提供了一个序列的Iterator接口骨架实现，下一个元素总是由前一个元素驱动的
ArrayListMultimap<K,V>	使用ArrayList作为键的集合的存储方法的Multimap实现
ArrayTable<R,C,V>	由二维数组实现的固定大小的Table
BinaryTreeTraverser<T>	TreeTraverser binary 树的一个变种，提供了对特定二进制树额外的截断
Collections2	提供了集合实例操作的静态方法
ComparisonChain	执行串比较声明的工具
ConcurrentHashMultiset<E>	支持并发修改的multiset,提供了Multiset大部分操作的原子版本（其它的有注明）
ContiguousSet<C extends Comparable>	DiscreteDomain中的一段相邻值的排序集合。
DiscreteDomain<C extends Comparable>	一些可比较的元素离散的域，包括next,previous,distance三个方法
EnumBiMap<K extends Enum<K>,V extends Enum<V>>	基于两个EnumMap实例的BiMap
EnumHashBiMap<K extends Enum<K>,V>	基于一个EnumMap实例来处理keys-values,而HashMap来处理values-to-keys的BiMap
EnumMultiset<E extends Enum<E>>	基于EnumMap的Multiset实现
EvictingQueue<E>	一个非阻塞的queue,当queue满而要增加新的元素时会移除头部的元素。
FluentIterable<E>	FluentIterable提供了一个以串的模式操作Iterable的实例。
ForwardingBlockingDeque<E>	一个所有方法都调用另一个BlockingDeque的BlockingDeque
ForwardingCollection<E>	一个所有方法调用会转向另一个集合的方法的集合
ForwardingConcurrentMap<K,V>	一个线程安全的map，其方法调用会转向另一个线程安全的map
ForwardingDeque<E>	一个deque，所有方法调用会 转向另一个deque
ForwardingIterator<T>	一个Iterator，方法调用会转向另一个Iterator
ForwardingList<E>	一个列表，方法调用会转向另一个列表
ForwardingListIterator<E>	一个list iterator,方法调用会转向另一个list iterator
ForwardingListMultimap<K,V>	一个list multimap,方法调用会转向另一个list multimap
ForwardingMap<K,V>	一个map，方法调用会转向另一个map
ForwardingMapEntry<K,V>	一个map entyr，方法调用会转向另一个map entry
ForwardingMultimap<K,V>	一个multimap，方法调用会转向另一个multimap
ForwardingMultiset<E>	一个multiset，方法调用会转向另一个multiset
ForwardingNavigableMap<K,V>	一个navigble map，方法调用会转向另一个navigable map
ForwardingNavigableSet<E>	一个navigable set，方法调用会转向另一个navigable set
ForwardingObject	实现装饰模式的一个抽象基类
ForwardingQueue<E>	一个queue，方法调用会转向另一个queue
ForwardingSet<E>	一个set ，方法调用会转向另一个set
ForwardingSetMultimap<K,V>	一个set multimap，方法调用会转向另一个set multimap
ForwardingSortedMap<K,V>	一个sorted map，方法调用会转向另一个sorted map
ForwardingSortedMultiset<E>	一个sorted multiset，方法调用会转向另一个sorted multiset
ForwardingSortedSet<E>	一个sorted set，方法调用会转向另一个sorted set
ForwardingSortedSetMultimap<K,V>	一个sorted set multimap，方法调用会转向另一个sorted set multimap
ForwardingTable<R,C,V>	一个table，方法调用会转向另一个table
HashBasedTable<R,C,V>	使用哈希表实现的Table
HashBiMap<K,V>	使用两个哈希表实现的BiMap
HashMultimap<K,V>	使用哈希表实现的Multimap
HashMultiset<E>	基于哈希表实现的Multiset
ImmutableBiMap<K,V>	一个不可变的BiMap,提供可靠的用户特定的迭代顺序
ImmutableBiMap.Builder<K,V>	一个用来创建不可变bimap实例的建造者，特别是公开的静态的final bimaps(常量bimaps)
ImmutableClassToInstanceMap<B>	一个基于ImmutableMap实现的类-实例 map
ImmutableClassToInstanceMap.Builder<B>	一个用来创建不可变的类-实例maps的建造者
ImmutableCollection<E>	一个不可变的集合
ImmutableCollection.Builder<E>	ImmutableCollection类型建造者的抽象基类
ImmutableList<E>	一个高性能，不可变的，随机获取的列表实现
ImmutableList.Builder<E>	创建immutable list实例的建造者，特变是 public static  final lists(常量列表)
ImmutableListMultimap<K,V>	一个不可变的ListMultimap,提供可靠的用户指定的key-value迭代顺序
ImmutableListMultimap.Builder<K,V>	产生Immutable ListMultimap实例的构建者，特变是 public static  final multimaps(常量multimaps)
ImmutableMap<K,V>	一个不可变的，基于哈希的Map,提供可靠的，用户指定的迭代顺序
ImmutableMap.Builder<K,V>	产生Immutable map实例的构建者，特变是 public static  final maps(常量multimaps)
ImmutableMultimap<K,V>	不可变的Multimap
ImmutableMultimap.Builder<K,V>	产生Immutable Multimap实例的构建者，特变是 public static  final multimaps(常量multimaps)
ImmutableMultiset<E>	一个不可变的 基于哈希的multiset
ImmutableMultiset.Builder<E>	产生Immutable multiset实例的构建者，特变是 public static  final multiset(常量multiset)
ImmutableRangeMap<K extends Comparable<?>,V>	RangeMap的不可变实现，所有的查询操作都很高效
ImmutableRangeMap.Builder<K extends Comparable<?>,V>	不可变的range maps的建造者
ImmutableRangeSet<C extends Comparable>	RangeSet的不可变的，高效的实现
ImmutableRangeSet.Builder<C extends Comparable<?>>	Immutable range sets的建造者
ImmutableSet<E>	高性能的，不可变的set，提供了可靠的，用户特定的迭代顺序。
ImmutableSet.Builder<E>	Immutable set 实例的建造者，特别是publi static final sets（常量sets）
ImmutableSetMultimap<K,V>	一个不可变的SetMultimap,提供了可靠的，用户指定的key value迭代顺序
ImmutableSetMultimap.Builder<K,V>	Immutable SetMultimap 实例的建造者，特别是publi static final multimaps（常量multimaps）
ImmutableSortedMap<K,V>	不可变的SortedMap
ImmutableSortedMap.Builder<K,V>	Immutable sorted map 实例的建造者，特别是publi static final maps（常量maps）
ImmutableSortedMultiset<E>	以sorted array来保存元素的SortedMultiset
ImmutableSortedMultiset.Builder<E>	Immutable multiset 实例的建造者，特别是publi static final multiset（常量multiset）
ImmutableSortedSet<E>	以sorted array来保存元素的不可变的SortedSet
ImmutableSortedSet.Builder<E>	Immutable sorted set 实例的建造者，特别是publi static final set（常量set）
ImmutableTable<R,C,V>	供可靠的，用户指定的迭代顺序的不可变 table
ImmutableTable.Builder<R,C,V>	Immutable table 实例的建造者，特别是publi static final table（常量table）
Interners	和Interner实例相关的静态方法
Iterables	包含操作或返回Iterable实例的静态工具方法类
Iterators	包含操作或返回Iterator类型实例的静态工具方法类
LinkedHashMultimap<K,V>	不允许重复的键值对元素的Multimap实现，返回集合的迭代顺和元素添加的顺序一致
LinkedHashMultiset<E>	提供可预知的迭代顺序的Multiset实现。
LinkedListMultimap<K,V>	一个支持确定的key和值迭代顺序的ListMultimap
Lists	List实例相关的静态工具方法。
MapConstraints	MapConstraint接口相关的工厂和工具
MapMaker	A builder of ConcurrentMap instances having any combination of the following features: keys or values automatically wrapped in weak or soft references notification of evicted (or otherwise removed) entries on-demand computation of values for keys not already present ConcurrentMap的建造者，有以下的特点：键或值会自动包装在一个弱的或软的引用通知，当一个符合要求的计算值的key不存在时？
Maps	Map实例相关的静态工具方法（包括SortedMap,BiMap等）
MinMaxPriorityQueue<E>	两端的优先级队列，提供了常量时间来获取最小值和最大值，有queue特定的比较器来决定。
MinMaxPriorityQueue.Builder<B>	用来建造min-max优先级队列的建造者
MultimapBuilder<K0,V0>	Multimap实现的建造者，允许使用一个制定的multimap来定制后端的map和值集合实现
MultimapBuilder.ListMultimapBuilder<K0,V0>	一个专门的Multimap创建者，用来产生ListMultimap实例
MultimapBuilder.MultimapBuilderWithKeys<K0>	MultimapBuilder的中间状态，key-value集合实现已经制定了，但值集合实现还没有。
MultimapBuilder.SetMultimapBuilder<K0,V0>	一个专门的MultiBuilder，用来产生SetMultimap实例。
MultimapBuilder.SortedSetMultimapBuilder<K0,V0>	一个专门的MultiBuilder,用来产生SortedSetMultimap.
Multimaps	提供操作或生成MultiMapd的静态方法
Multisets	提供创建或操作MultiSet的静态工具方法
MutableClassToInstanceMap<B>	一个基于用户提供的map的不可变的类-实例Map
ObjectArrays	对象数组相关的静态工具方法
Ordering<T>	比较器，提供了额外的方法
Queues	Queue和Deque实例相关的静态工具方法
Range<C extends Comparable>	一个比较类型的连续值的区间，比如，1到100之间的整数（包含1,100）。注意，无法迭代这些包含的值。
Sets	Set实例相关的静态工具方法
Sets.SetView<E>	Set的一个不可变视图，可能依赖于其他的Set,该视图当后端set改变时也会改变
Tables	提供Table相关的静态方法
TreeBasedTable<R,C,V>	Table实现，行键和列键按照其本身或提供的比较器来进行排序
TreeMultimap<K,V>	MultiMap的实现，key和value按照其本身或提供的比较器来进行排序
TreeMultiset<E>	一个维持元素顺序的multiset，按照其本身或外部的比较器。
TreeRangeMap<K extends Comparable,V>	基于TreeMap的RangeMap实现，支持所有的可选方法
TreeRangeSet<C extends Comparable<?>>	基于TreeMap的RangeSet实现
TreeTraverser<T>	在Tree查看类型T的元素，使用这个截断器来截断TREE
UnmodifiableIterator<E>	不支持UnmodifiableIterator.remove()方法的Iterator
UnmodifiableListIterator<E>	一个不支持的 UnmodifiableIterator.remove(), UnmodifiableListIterator.add(E), or UnmodifiableListIterator.set(E).list iterator

 

 

 

 

 

 

Package com.google.common.collectDescription

该包包含一个通用的集合接口和实现，一些相关的工具，是Guava库的一部分

集合类型

BiMap

Map的一种扩展，值也和键一样是保证唯一性的。有时候也称呼为可翻转的Map,因为值的限制可以支持该map的翻转视图，该视图也是BiMap的一个实例。

Multiset

一种扩展的集合，可以向List那样包含重复的元素，但也像Set那样是顺序无关的。Multiset的一个典型应用是柱状图（直方图）

Multimap

类似于Map的一种新类型，但是同样的key可以包含多个入口（同一个key可以对应多个值），Multimap的一些行为没有进行规定，有子类型来定义。

ListMultimap

MultiMap的一个扩展，允许重复的入口，支持直接获取某个key的所有值，就像在ListMultimap.equals(Object)中定义的部分顺序无关性。ListMultimap的名字来源于某个key的所有值的集合符合List的约定。

SetMultimap

MultiMap的一个扩展，具有顺序无关性，不允许重复的元素。也就是说SetMultimap的key可以出现多次，但是每次对应的值必须是不同的。SetMultimap的名字来源于key对应的集合符合Set的约定。

SortedSetMultimap

SetMultimap的一个扩展，key对应的集合是一个SortedSet.

Table

A new type,which is similar to Map, but which indexes itsvalues by an ordered pair of keys, a row key and column key.

一种类似于Map的新类型，但是有一对有序的key来映射一个值，这一对key为一个行key和一个列key

ClassToInstanceMap

Map的一个扩展，映射一个原始类型到对应的实例。

集合实现

List

• ImmutableList

of Set

• ImmutableSet
• ImmutableSortedSet
• ContiguousSet (see Range)

of Map

• ImmutableMap
• ImmutableSortedMap
• MapMaker

of BiMap

• ImmutableBiMap
• HashBiMap
• EnumBiMap
• EnumHashBiMap

of Multiset

• ImmutableMultiset
• HashMultiset
• LinkedHashMultiset
• TreeMultiset
• EnumMultiset
• ConcurrentHashMultiset

of Multimap

• ImmutableMultimap
• ImmutableListMultimap
• ImmutableSetMultimap
• ArrayListMultimap
• HashMultimap
• TreeMultimap
• LinkedHashMultimap
• LinkedListMultimap

of Table

• ImmutableTable
• ArrayTable
• HashBasedTable
• TreeBasedTable

of ClassToInstanceMap

• ImmutableClassToInstanceMap
• MutableClassToInstanceMap

静态工具方法类

• Collections2
• Iterators
• Iterables
• Lists
• Maps
• Queues
• Sets
• Multisets
• Multimaps
• Tables
• ObjectArrays

比较

• Ordering
• ComparisonChain

抽象实现

• AbstractIterator
• AbstractSequentialIterator
• ImmutableCollection
• UnmodifiableIterator
• UnmodifiableListIterator

Ranges

• Range
• RangeMap
• DiscreteDomain
• ContiguousSet

其它

• Interner, Interners
• Constraint, Constraints
• MapConstraint, MapConstraints
• MapDifference, SortedMapDifference
• MinMaxPriorityQueue
• PeekingIterator

Forwarding collections（指向集合，装饰模式）

• ForwardingCollection
• ForwardingConcurrentMap
• ForwardingIterator
• ForwardingList
• ForwardingListIterator
• ForwardingListMultimap
• ForwardingMap
• ForwardingMapEntry
• ForwardingMultimap
• ForwardingMultiset
• ForwardingNavigableMap
• ForwardingNavigableSet
• ForwardingObject
• ForwardingQueue
• ForwardingSet
• ForwardingSetMultimap
• ForwardingSortedMap
• ForwardingSortedMultiset
• ForwardingSortedSet
• ForwardingSortedSetMultimap
• ForwardingTable