java并发（二十七） 并发性标注

一介绍

Xml代码

 

1. <dependency>  
2.     <groupId>net.jcip</groupId>  
3.     <artifactId>jcip-annotations</artifactId>  
4.     <version>1.0</version>  
5. </dependency>  

注解包括下面的一些内容

@ThreadSafe线程安全的标记在jcip.net中定义的。jcip是Java Concurrency In Practice的缩写。如果你不想在你的项目中使用jcip标记，可以移除@ThreadSafe和相关的引用，但还是希望能够尽量使用它。它们可以提供很严格的注释信息，却不会修改编译和运行环境，但是却非常有用在你想知道一个类的作者提供什么样的线程安全的时候。这在修改别人的代码的时候是很需要的。



二用法

1. 类Annotation

3个Annotation描述类的可预期的线程安全保证：

@ThreadSafe：类是线程安全的；

@Immutable：类是不可变的（属性为final），不可变对象是线程安全的；

@NotThreadSafe：类不是线程安全的，如果类未加任何注解，则不能确定是否线程安全，认为是非线程安全的。



2. 域Annotation和方法Annotation

描述哪个状态变量被哪个锁保护着，以及哪个锁保护这些变量的信息：

@GuardedBy(lock)：线程只有在持有了一个特定的锁（lock）后，才能访问某个域或方法；

@GuardedBy("this")：包换在对象中的内部锁（方法或域是这个对象的一个成员）；

@GuardedBy("fieldName")：值与filedName引用的对象相关联的锁，或者是一个隐式锁（filedName没有引用一个Lock），或者是一个显示锁（filedName引用了一个Lock）；

@GuardedBy("ClassName.fieldName")：类似于@GuardedBy("fieldName")，不过所引用的锁对象是存储在另一个类（或本类）中的静态域；

@GuardedBy("methodName()")：锁对象是methodName()方法的返回值；

@GuardedBy("ClassName.class")：ClassName类的直接量对象。

Java代码

 

1. import javax.annotation.concurrent.*;  
2.   
3. @ThreadSafe  
4. public class Sequence {  
5.       
6.     @GuardedBy("this") private int value;  
7.       
8.     public synchronized int getNext() {  
9.         return value++;  
10.     }  
11.   
12. }