@GuardedBy annotazione con java.util.concurrent.locks.ReadWriteLock

Question

Qual è un modo corretto/preferito per annotare campi protetti con uno ReadWriteLock in modo che strumenti come FindBug possano sfruttare l'annotazione? Il nome dello ReadWriteLock deve essere semplicemente scritto nell'annotazione @GuardedBy. C'è mai un motivo per scrivere il nome di solo il blocco di lettura, o solo il blocco di scrittura, nell'annotazione @GuardedBy? FindBugs o altri strumenti supportano anche ReadWriteLock in @GuardedBy?

Answer 1

Al momento in cui scriviamo, @GuardedByisn't fully implemented by Findbugs, ed è per lo più solo per documentazione. (È parzialmente implementato.)

Io uso sempre @GuardedBy("readwritelock") o l'oggetto che uso per synchronize.

Ad esempio di quest'ultimo:

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

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

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

Answer 2

trovare bug supporta le seguenti annotazioni:

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

utilizzo di questi GuardedBy annotazioni dovrebbe essere la seguente:

@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); 
    } 

}