[jboss-cvs] JBossCache/src-50/org/jboss/cache/pojo ...

[Elias Ross]

  User: genman  
  Date: 06/11/06 18:32:16

  Modified:    src-50/org/jboss/cache/pojo  PojoCache.java
  Log:
  JBCACHE-485 - Set.contains() remove() and add() O(1) ops now
  
  Revision  Changes    Path
  1.7       +24 -18    JBossCache/src-50/org/jboss/cache/pojo/PojoCache.java
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: PojoCache.java
  ===================================================================
  RCS file: /cvsroot/jboss/JBossCache/src-50/org/jboss/cache/pojo/PojoCache.java,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -b -r1.6 -r1.7
  --- PojoCache.java	19 Sep 2006 02:32:02 -0000	1.6
  +++ PojoCache.java	6 Nov 2006 23:32:16 -0000	1.7
  @@ -25,24 +25,30 @@
   public interface PojoCache
   {
      /**
  -    * <p>Attach a POJO into PojoCache. It will also recursively put any sub-POJO into
  -    * the cache system. A POJO can be the following and have the consqeuences when attached:</p>
  -    * <p/>
  -    * <li>it is PojoCacheable, that is, it has been annotated with
  -    * {@see org.jboss.cache.aop.annotation.PojoCacheable} annotation (or via XML), and has
  -    * been "instrumented" either compile- or load-time. The POJO will be mapped recursively to
  -    * the system and fine-grained replication will be performed.</li>
  -    * <li>It is Serializable. The POJO will still be stored in the cache system. However, it is
  -    * treated as an "opaque" object per se. That is, the POJO will neither be intercepted
  -    * (for fine-grained operation) or object relantionship will be maintained.</li>
  -    * <li>Neither of above. In this case, a user can specify whether it wants this POJO to be
  -    * stored (e.g., replicated or persistent). If not, a PojoCacheException will be thrown.</li>
  -    *
  -    * @param id   An id String to identify the object in the cache. To promote concurrency, we
  -    *             recommend the use of hierarchical String separating by a designated separator. Default
  -    *             is "/" but it can be set differently via a System property, jbosscache.separator
  -    *             in the future release. E.g., "ben", or "student/joe", etc.
  -    * @param pojo object to be inerted into the cache. If null, it will nullify the fqn node.
  +	* <p>Attach a POJO into PojoCache. It will also recursively put any
  +	* sub-POJO into the cache system. A POJO can be the following and have the
  +	* consqeuences when attached:</p> <p/> <li>it is PojoCacheable, that is, it
  +	* has been annotated with {@see
  +	* org.jboss.cache.aop.annotation.PojoCacheable} annotation (or via XML),
  +	* and has
  +	* been "instrumented" either compile- or load-time. The POJO will be mapped
  +	* recursively to the system and fine-grained replication will be
  +	* performed.</li> <li>It is Serializable. The POJO will still be stored in
  +	* the cache system. However, it is treated as an "opaque" object per se.
  +	* That is, the POJO will neither be intercepted
  +	* (for fine-grained operation) or object relantionship will be
  +	* maintained.</li>
  +	* <li>Neither of above. In this case, a user can specify whether it wants
  +	* this POJO to be stored (e.g., replicated or persistent). If not, a
  +	* PojoCacheException will be thrown.</li>
  +    *
  +	* @param id   An id String to identify the object in the cache. To promote
  +	* concurrency, we recommend the use of hierarchical String separating by a
  +	* designated separator. Default is "/" but it can be set differently via a
  +	* System property, jbosscache.separator in the future release. E.g., "ben",
  +	* or "student/joe", etc.
  +	* @param pojo object to be inerted into the cache. If null, it will nullify
  +	* the fqn node.
       * @return Existing POJO or null if there is none.
       * @throws PojoCacheException Throws if there is an error related to the cache operation.
       */