@GuardedBy anotación con java.util.concurrent.locks.ReadWriteLock

Question

¿Cuál es la forma correcta/preferida de anotar los campos que están protegidos con un ReadWriteLock para que las herramientas como FindBugs puedan aprovechar la anotación? Debe el nombre del ReadWriteLock simplemente escribirse en la anotación @GuardedBy. ¿Alguna vez hay una razón para escribir el nombre del solo bloqueo de lectura, o simplemente el bloqueo de escritura, en la anotación @GuardedBy? ¿FindBugs u otras herramientas, incluso admiten ReadWriteLock en @GuardedBy?

Answer 1

En el momento de escribir estas líneas, @GuardedByisn't fully implemented by Findbugs, y es más que nada para documentación. (Es parcialmente implementarse.)

siempre uso @GuardedBy("readwritelock") o el objeto que utilizo para synchronize.

Por ejemplo de este último:

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

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

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

Answer 2

encontrar errores es compatible con las siguientes anotaciones:

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

uso de estos anotación GuardedBy debe ser el siguiente:

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

}