前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。点击跳转到教程。
ImmutableCollection代码定义
@GwtCompatible(emulated=true)
public abstract class ImmutableCollection<E> extends AbstractCollection<E> implements Serializable
ImmutableCollection表示内容不可更改的集合,并提供以下额外特性的担保。
注意:应当避免直接使用ImmutableCollection作为一个类型,就如同避免直接使用Collection本身一样。最好使用其子类(例如ImmutableSet或ImmutableList),因为子类拥有更好的Object.equals(java.lang.Object) 语义,可以从源头避免常见的bug和错误。
以下文档适用于com.google.common.collect包中所有公开的不可变类型,不论是否是ImmutableCollection的子类。
保证特性
- 浅不可变:
浅不可变是指值是不可写的,但是如果是对象的引用的值是可被改变的。不能对不可变集合的元素进行增加、移除或者替换。这是比Collections.unmodifiableCollection 更严格的保证,因为这个集合的内容会随其包装集合的改变而改变。
- 不可为Null:
本集合不能包含null元素。
- 确定性的迭代 :
元素迭代顺序是被定义的,取决于集合的创建(细节可以参考对应的工厂方法)。除非另外注明,集合视图(例如ImmutableMultiset.elementSet())的迭代顺序与父集合一样。
- 线程安全:
多线程并发访问集合是安全的。
- 完整性:
本类型不能在除com.google.common.collect包以外被继承。(因为这有可能违反以上担保特性。)
接口而非实现
每一个公开的类(例如ImmutableSet)都是一个提供具体功能行为保证的类型,而不仅仅是在某种特定的实现(例如ArrayList)。对类型名称的含义都应当理解为是接口而非实现。
属性类型和方法返回类型通常都应当使用不可变类型(例如ImmutableList)而不是一般的集合接口(例如List)。这样便于告知调用者以上对于类型的保证特性,这是非常有用的信息。
另一方面,直接将ImmutableList作为参数类型并不令人满意。解决方案是接受Iterable类型参数,通过方法或构造器将它传递给相应的copyOf方法。
创建
除了逻辑层面的抽象类(例如ImmutableCollection),每个不可变类型都提供了或者此类型实例的静态方法。最常用的有:
1、静态方法of,接受一个显示的元素或条目列表。
2、静态方法copyOf(或者copyOfSorted),接受一个内容可被复制的已存在的集合。
3、嵌套的静态类Builder,它可以用来填充一个新的不可变实例。
警告
如任何集合一样,改变集合中的元素(这种改变影响了Object.equals(java.lang.Object)的行为)是一种错误的做法。他会引起未定义的行为和bug。通常最佳实践是完全避免使用可变对象作为集合元素,虽然许多用户认为不可变对象是深不可变的(deeply immutable)。
性能说明
1、集合的实现通常优先考虑内存效率,然后是访问速度,最后是创建速度。
2、copyOf方法有时会认为没有必要进行实际复制操作:例如,copyOf(copyOf(anArrayList))只会复制一次。这减少了在API边界习惯性地创建防御副本的代价。但是,跳过拷贝操作的精确情况是未定义的。
3、警告:视图集合(例如ImmutableMap.keySet或ImmutableList.subList(int,int))会保留对整个数据集合的引用,以防止其被垃圾收集。如果其中一些数据通过其他方式不再可用,这可能会产生内存泄漏。可通过传递视图集合给适当的copyOf方法以获得正确大小的拷贝。
4、与创建可变集合并拷贝相比,使用相应关联的Builder类并不会降低性能,有可能会更好。
5、通常实现不会缓存hash code。如果元素或键类型的hashCode实现较慢,它应当自己实现缓存。
使用示例
class Foo {private static final ImmutableSet<String> RESERVED_CODES =ImmutableSet.of("AZ", "CQ", "ZX");private final ImmutableSet<String> codes;public Foo(Iterable<String> codes) {this.codes = ImmutableSet.copyOf(codes);checkArgument(Collections.disjoint(this.codes, RESERVED_CODES));}}