线程安全性的文档化

并非出现synchronized关键字就是线程安全性文档化了。实际上，一个类支持的线程安全性有很多级别。一个类为了可被多个线程安全的使用，必须在文档中清楚的说明它所支持的线程安全性级别。

下面就是线程安全性级别：

非可变（immutable）：这个类的实例对于客户代码而言是不变的。所以，不需要外部的同步。这样的例子包括：String,Integer和BigInteger。

线程安全的（thread-safe）:这个类的实例是可变的，但是所有的方法都包含了足够的同步手段，所以这些实例可以被并发使用，无需外部同步。这些并发的调用将表现为按照某种全局一致的顺序，被依次执行。其例子包括了Random和java.util.Timer


有条件的线程安全（conditionally thread-safe）：这个类（或者关联的类）包含有某些方法，它们必须被顺序调用，而不能受到其他线程的干扰。除此之外，这种线程安全级别与上一种情形一样。为了消除被其他线程干扰，客户代码在执行此方法序列期间，必须获得一把适当的锁。例子：Hashtable,Vector，他们的迭代器（iterator）要求外部同步。

线程兼容（thread-compatiable）：在每个方法调用的外部使用外部同步，此时这个类的实例可以被安全并发的使用。如ArrayList和HashMap。

线程对立（thread-hostile）：这个类不能安全的被多个线程并发使用，即使所有的方法调用都被外部同步包围。这样情况在于这个类的方法要修改静态数据，而这些静态数据可能会影响到其他线程。这样的类在JAVA库中很少，例如：System.runFinalizersOnExit方法是线程对立的，但是已经废弃了。