@GuardedBy chú thích với java.util.concurrent.locks.ReadWriteLock

Question

Cách thích hợp/ưa thích để chú thích các trường được bảo vệ bằng ReadWriteLock để các công cụ như FindBugs có thể tận dụng chú thích đó là gì? Tên của ReadWriteLock chỉ cần được viết trong chú thích @GuardedBy. Có bao giờ một lý do để viết tên của khóa chỉ đọc, hoặc chỉ là khóa viết, trong chú thích @GuardedBy? FindBugs hoặc các công cụ khác, thậm chí có hỗ trợ ReadWriteLock trong @GuardedBy không?

Answer 1

Tại thời điểm viết bài này, @GuardedByisn't fully implemented by Findbugs, và chủ yếu là chỉ cho tài liệu. (Đó là một phần được triển khai.)

Tôi luôn sử dụng @GuardedBy("readwritelock") hoặc đối tượng mà tôi sử dụng để synchronize.

Đối với ví dụ về sau:

class Example { 
    private Object lock = new Object(); 

    @GuardedBy("lock") 
    private Stuff innards = ...; 

    public void work() { 
     synchronized(lock) { 
      workWith(innards.goop()); 
     } 
    }   
} 

Answer 2

Tìm lỗi hỗ trợ các chú thích như sau:

net.jcip.annotations.GuardedBy 
net.jcip.annotations.Immutable 
net.jcip.annotations.NotThreadSafe 
net.jcip.annotations.ThreadSafe 

Sử dụng những GuardedBy chú thích nên thực hiện như sau:

@ThreadSafe 
public class Queue<E> implements java.util.Queue<E> 
{ 
    private ConcurrentLinkedQueue readWriteLock; 

    @GuardedBy(value="readWriteLock") 
    public boolean offer(E o) 
    { 
     return queue.offer(o); 
    } 

}