User: user57
Date: 01/07/12 17:36:07
Modified: src/main/org/jboss/ejb InstanceCache.java
Log:
o re-indent, cleaned up javadoc
Revision Changes Path
1.8 +56 -47 jboss/src/main/org/jboss/ejb/InstanceCache.java
Index: InstanceCache.java
===================================================================
RCS file: /cvsroot/jboss/jboss/src/main/org/jboss/ejb/InstanceCache.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- InstanceCache.java 2001/06/18 20:01:21 1.7
+++ InstanceCache.java 2001/07/13 00:36:07 1.8
@@ -10,67 +10,76 @@
import java.rmi.NoSuchObjectException;
/**
- * The plugin that gives a container a cache for bean instances.
+ * The plugin that gives a container a cache for bean instances.
*
- * @author <a href="mailto:[EMAIL PROTECTED]";>Rickard Öberg</a>
- * @author <a href="mailto:[EMAIL PROTECTED]";>Simone Bordet</a>
- * @version $Revision: 1.7 $
+ * @author <a href="mailto:[EMAIL PROTECTED]";>Rickard Öberg</a>
+ * @author <a href="mailto:[EMAIL PROTECTED]";>Simone Bordet</a>
+ * @version $Revision: 1.8 $
*/
public interface InstanceCache
extends ContainerPlugin
{
/**
- * Gets a bean instance from this cache given the identity.
- * This method may involve activation if the instance is not in the cache.
- * Implementation should have O(1) complexity.
- * This method is never called for stateless session beans.
- *
- * @param id the primary key of the bean
- * @return the EnterpriseContext related to the given id
- * @exception RemoteException in case of illegal calls (concurrent / reentrant),
- * NoSuchObjectException if the bean cannot be found.
- * @see #release
- */
- public EnterpriseContext get(Object id)
- throws RemoteException, NoSuchObjectException;
+ * Gets a bean instance from this cache given the identity. This method
+ * may involve activation if the instance is not in the cache.
+ *
+ * <p>Implementation should have O(1) complexity.
+ *
+ * <p>This method is never called for stateless session beans.
+ *
+ * @param id The primary key of the bean .
+ * @return The EnterpriseContext related to the given id.
+ *
+ * @throws RemoteException In case of illegal calls (concurrent /
+ * reentrant)
+ * @throws NoSuchObjectException if the bean cannot be found.
+ *
+ * @see #release
+ */
+ EnterpriseContext get(Object id)
+ throws RemoteException, NoSuchObjectException;
/**
- * Inserts an active bean instance after creation or activation.
- * Implementation should guarantee proper locking and O(1) complexity.
- *
- * @param ctx the EnterpriseContext to insert in the cache
- * @see #remove
- */
- public void insert(EnterpriseContext ctx);
+ * Inserts an active bean instance after creation or activation.
+ *
+ * <p>Implementation should guarantee proper locking and O(1) complexity.
+ *
+ * @param ctx The EnterpriseContext to insert in the cache
+ *
+ * @see #remove
+ */
+ void insert(EnterpriseContext ctx);
/**
- * Releases the given bean instance from this cache.
- * This method may passivate the bean to get it out of the cache.
- * Implementation should return almost immediately leaving the
- * passivation to be executed by another thread.
- *
- * @param ctx the EnterpriseContext to release
- * @see #get
- */
- public void release(EnterpriseContext ctx);
+ * Releases the given bean instance from this cache.
+ * This method may passivate the bean to get it out of the cache.
+ * Implementation should return almost immediately leaving the
+ * passivation to be executed by another thread.
+ *
+ * @param ctx The EnterpriseContext to release
+ *
+ * @see #get
+ */
+ void release(EnterpriseContext ctx);
/**
- * Removes a bean instance from this cache given the identity.
- * Implementation should have O(1) complexity and guarantee proper locking.
- *
- * @param id the pimary key of the bean
- * @see #insert
- */
- public void remove(Object id);
+ * Removes a bean instance from this cache given the identity.
+ * Implementation should have O(1) complexity and guarantee proper locking.
+ *
+ * @param id The pimary key of the bean.
+ *
+ * @see #insert
+ */
+ void remove(Object id);
/**
- * Checks whether an instance corresponding to a particular id is active
- *
- * @param id the pimary key of the bean
- * @see #insert
- */
- public boolean isActive(Object id);
-
+ * Checks whether an instance corresponding to a particular id is active.
+ *
+ * @param id The pimary key of the bean.
+ *
+ * @see #insert
+ */
+ boolean isActive(Object id);
}
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/jboss-development
