cvs commit: jakarta-turbine-jcs/auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate TestOnly.java ThreadSafety.java ThreadSafetyType.java TODO.java UnsupportedOperation.java

[hc...@apache.org]

hchar       2005/01/20 00:32:41

  Added:       auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate
                        TestOnly.java ThreadSafety.java
                        ThreadSafetyType.java TODO.java
                        UnsupportedOperation.java
  Log:
  no message
  
  Revision  Changes    Path
  1.1                  jakarta-turbine-jcs/auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate/TestOnly.java
  
  Index: TestOnly.java
  ===================================================================
  /*
   * $Revision: 1.1 $ $Date: 2005/01/20 08:32:41 $
   */
  
  package net.sf.yajcache.annotate;
  
  import java.lang.annotation.*;
  
  /**
   * Annotates the target is for testing purposes only.
   *
   * @author Hanson Char
   */
  @Documented
  @Inherited
  @Retention(RetentionPolicy.RUNTIME)
  public @interface TestOnly {
      String value() default "";
  }
  
  
  
  1.1                  jakarta-turbine-jcs/auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate/ThreadSafety.java
  
  Index: ThreadSafety.java
  ===================================================================
  /*
   * $Revision: 1.1 $ $Date: 2005/01/20 08:32:41 $
   */
  
  package net.sf.yajcache.annotate;
  
  import java.lang.annotation.*;
  
  /**
   * Characterizing thread safety.
   *
   * http://www-106.ibm.com/developerworks/java/library/j-jtp09263.html
   *
   * @author Hanson Char
   */
  @Documented
  @Retention(RetentionPolicy.RUNTIME)
  public @interface ThreadSafety {
      ThreadSafetyType value();
      String caveat() default "";
      String note() default "";
  }
  
  
  
  1.1                  jakarta-turbine-jcs/auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate/ThreadSafetyType.java
  
  Index: ThreadSafetyType.java
  ===================================================================
  /*
   * ThreadSafetyType.java
   *
   * $Revision: 1.1 $ $Date: 2005/01/20 08:32:41 $
   */
  
  package net.sf.yajcache.annotate;
  
  /**
   * Thread Safety Types.
   *
   * http://www-106.ibm.com/developerworks/java/library/j-jtp09263.html
   *
   * @author Hanson Char
   */
  public enum ThreadSafetyType {
      /**  Immutable objects are guaranteed to be thread-safe. */
      IMMUTABLE, 
      SAFE, 
      /**
       * Conditionally thread-safe classes are those for which each individual 
       * operation may be thread-safe, but certain sequences of operations may 
       * require external synchronization. The most common example of 
       * conditional thread safety is traversing an iterator returned from 
       * Hashtable or Vector -- the fail-fast iterators returned by these 
       * classes assume that the underlying collection will not be mutated 
       * while the iterator traversal is in progress. To ensure that other 
       * threads will not mutate the collection during traversal, the 
       * iterating thread should be sure that it has exclusive access to 
       * the collection for the entirety of the traversal. Typically, 
       * exclusive access is ensured by synchronizing on a lock -- and the 
       * class's documentation should specify which lock that is 
       * (typically the object's intrinsic monitor).
       */
      CONDITIONAL, 
      /**
       * Thread-compatible classes are not thread-safe, but can be used 
       * safely in concurrent environments by using synchronization 
       * appropriately.
       */
      COMPATIBLE, 
      /**
       * Thread-hostile classes are those that cannot be rendered safe to 
       * use concurrently, regardless of what external synchronization is 
       * invoked.
       */
      HOSTILE
  }
  
  
  
  1.1                  jakarta-turbine-jcs/auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate/TODO.java
  
  Index: TODO.java
  ===================================================================
  /*
   * TODO.java
   *
   * $Revision: 1.1 $ $Date: 2005/01/20 08:32:41 $
   */
  
  package net.sf.yajcache.annotate;
  
  import java.lang.annotation.*;
  
  /**
   * Annotates what needs to be done.
   *
   * @author Hanson Char
   */
  @Documented
  @Retention(RetentionPolicy.SOURCE)
  public @interface TODO {
      /** Summary of what needs to be done. */
      String value() default "";
      /** Details of what needs to be done. */
      String details() default "";
  }
  
  
  
  1.1                  jakarta-turbine-jcs/auxiliary-builds/jdk15/yajcache/cache/src/net/sf/yajcache/annotate/UnsupportedOperation.java
  
  Index: UnsupportedOperation.java
  ===================================================================
  /*
   * $Revision: 1.1 $ $Date: 2005/01/20 08:32:41 $
   */
  
  package net.sf.yajcache.annotate;
  
  import java.lang.annotation.*;
  
  /**
   * Unsupported Operation.
   *
   * @author Hanson Char
   */
  @Documented
  @Target(ElementType.METHOD)
  @Retention(RetentionPolicy.RUNTIME)
  public @interface UnsupportedOperation {
      String value() default "";
  }
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: turbine-jcs-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: turbine-jcs-dev-help@jakarta.apache.org