1. 介绍

看过《JAVA并发实战》应该对其中使用的注解有印象。使用注解来标注程序是否线程安全对维护代码很有好处。

2. 使用

引入maven依赖即可

<!-- https://mvnrepository.com/artifact/net.jcip/jcip-annotations -->
<dependency>
    <groupId>net.jcip</groupId>
    <artifactId>jcip-annotations</artifactId>
    <version>1.0</version>
</dependency>

3. 使用

3.1 类的标注

是非入侵式的标注,可以作为公开文档,对于使用者和维护者都有好处

@Immutable:不可变的类,包含了@ThreadSafe的含义
@ThreadSafe:类是线程安全的
@NotThreadSafe:类不是线程安全的

3.2 域和方法的标注

不作为公开文档,仅仅方便维护人员使用。主要说明哪些变量有哪些锁来保护

@GuardedBy(lock):表示只有持有了特定某个锁lock才能访问
@GuardedBy("this"): 表示被标注的方法和域是已经使用内置锁(比如方法用同步关键字)对象的成员
@Guardedby("fieldName"):表示与fieldName引用的对象相关联的锁,可以是显示锁业可以是隐式锁
@GuardedBy("Class Name.fieldName"):类似于@GuardedBy("fieldName"),但指向在另一个类的静态域中持有的锁对象
@GuardedBy("methodName()"):指通过调用命名方法返回的锁对象
@GuardedBy("ClassName.class"):指命名类的类字面量对象

3.3 示例代码

import javax.annotation.concurrent.*;  

@ThreadSafe  
public class Sequence {  

    @GuardedBy("this") private int value;  

    public synchronized int getNext() {  
        return value++;  
    }  

}