CopyOnWrite


1   package hudson;
2   
3   import java.lang.annotation.Documented  ;
4   import static java.lang.annotation.ElementType.FIELD  ;
5   import java.lang.annotation.Retention  ;
6   import static java.lang.annotation.RetentionPolicy.SOURCE  ;
7   import java.lang.annotation.Target  ;
8   
9   /**
10   * Represents fields that are protected for concurrency by the copy-on-write semantics.
11   *
12   * <p>
13   * Fields marked by this annotation always holds on to an immutable collection.
14   * A change to the collection must be done by first creating a new collection
15   * object, making changes, then replacing the reference atomically.
16   *
17   * <p>
18   * This allows code to access the field without synchronization, and
19   * greatly reduces the risk of dead-lock bugs.
20   *
21   * <p>
22   * The field marked with this annotation usually needs to be marked as
23   * <tt>volatile</tt>.
24   *
25   * @author Kohsuke Kawaguchi
26   */
27  @Retention  (SOURCE)
28  @Documented  
29  @Target  (FIELD)
30  public @interface CopyOnWrite {
31  }
32

A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame

Popular Tags