Java并发程序设计-注解

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. }  

以上注解均为非标准的Annotation，自定义注解方式可以参考其他资料： 
http://www.cnblogs.com/phoebus0501/archive/2011/02/21/1960077.html  

定制的Annotation如下： 

Java代码  

1. @Documented  
2. @Target(ElementType.TYPE)  
3. @Retention(RetentionPolicy.CLASS)  
4. public @interface ThreadSafe {  
5. }  

Java代码  

1. @Documented  
2. @Target(ElementType.TYPE)  
3. @Retention(RetentionPolicy.CLASS)  
4. public @interface NotThreadSafe {  
5. }  

Java代码  

1. @Documented  
2. @Target(ElementType.TYPE)  
3. @Retention(RetentionPolicy.CLASS)  
4. public @interface Immutable {  
5. }  

Java代码  

1. @Target( { ElementType.FIELD, ElementType.METHOD })  
2. @Retention(RetentionPolicy.CLASS)  
3. public @interface GuardedBy {  
4.     String value();  
5. }