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