You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mina.apache.org by tr...@apache.org on 2007/11/06 07:28:01 UTC
svn commit: r592303 -
/mina/trunk/core/src/main/java/org/apache/mina/common/IoSessionDataStructureFactory.java
Author: trustin
Date: Mon Nov 5 22:28:01 2007
New Revision: 592303
URL: http://svn.apache.org/viewvc?rev=592303&view=rev
Log:
More JavaDoc for clarification.
Modified:
mina/trunk/core/src/main/java/org/apache/mina/common/IoSessionDataStructureFactory.java
Modified: mina/trunk/core/src/main/java/org/apache/mina/common/IoSessionDataStructureFactory.java
URL: http://svn.apache.org/viewvc/mina/trunk/core/src/main/java/org/apache/mina/common/IoSessionDataStructureFactory.java?rev=592303&r1=592302&r2=592303&view=diff
==============================================================================
--- mina/trunk/core/src/main/java/org/apache/mina/common/IoSessionDataStructureFactory.java (original)
+++ mina/trunk/core/src/main/java/org/apache/mina/common/IoSessionDataStructureFactory.java Mon Nov 5 22:28:01 2007
@@ -31,16 +31,18 @@
public interface IoSessionDataStructureFactory {
/**
* Returns an {@link IoSessionAttributeMap} which is going to be associated
- * with the specified <tt>session</tt>.
+ * with the specified <tt>session</tt>. Please note that the returned
+ * implementation must be thread-safe.
*/
IoSessionAttributeMap getAttributeMap(IoSession session) throws Exception;
/**
* Returns an {@link Queue} of {@link WriteRequest}s which is going to be
* associated with the specified <tt>session</tt>. Please note that the
- * returned implementation must robust enough to deal with various types,
- * especially when you are going to implement a priority queue which involves
- * {@link Comparator}.
+ * returned implementation must be thread-safe and robust enough to deal
+ * with various messages types (even what you didn't expect at all),
+ * especially when you are going to implement a priority queue which
+ * involves {@link Comparator}.
*/
Queue<WriteRequest> getWriteRequestQueue(IoSession session) throws Exception;
}