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 [EMAIL PROTECTED] 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 [EMAIL PROTECTED] Queue} of [EMAIL PROTECTED] 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
- * [EMAIL PROTECTED] 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 [EMAIL PROTECTED] Comparator}.
*/
Queue<WriteRequest> getWriteRequestQueue(IoSession session) throws
Exception;
}
