org.apache.mina.core.session

接口 IoSessionAttributeMap

public interface IoSessionAttributeMap

Stores the user-defined attributes which is provided per IoSession. All user-defined attribute accesses in IoSession are forwarded to the instance of IoSessionAttributeMap.

作者:

Apache MINA Project

方法概要

方法

限定符和类型	方法和说明
boolean	containsAttribute(IoSession session, java.lang.Object key)
void	dispose(IoSession session) Disposes any releases associated with the specified session.
java.lang.Object	getAttribute(IoSession session, java.lang.Object key, java.lang.Object defaultValue)
java.util.Set<java.lang.Object>	getAttributeKeys(IoSession session)
java.lang.Object	removeAttribute(IoSession session, java.lang.Object key) Removes a user-defined attribute with the specified key.
boolean	removeAttribute(IoSession session, java.lang.Object key, java.lang.Object value) Removes a user defined attribute with the specified key if the current attribute value is equal to the specified value.
boolean	replaceAttribute(IoSession session, java.lang.Object key, java.lang.Object oldValue, java.lang.Object newValue) Replaces a user defined attribute with the specified key if the value of the attribute is equals to the specified old value.
java.lang.Object	setAttribute(IoSession session, java.lang.Object key, java.lang.Object value) Sets a user-defined attribute.
java.lang.Object	setAttributeIfAbsent(IoSession session, java.lang.Object key, java.lang.Object value) Sets a user defined attribute if the attribute with the specified key is not set yet.

方法详细资料

getAttribute

java.lang.Object getAttribute(IoSession session,
                            java.lang.Object key,
                            java.lang.Object defaultValue)

参数:

session - the session for which we want to get an attribute

key - The key we are looking for

defaultValue - The default returned value if the attribute is not found

返回:

the value of user defined attribute associated with the specified key. If there's no such attribute, the specified default value is associated with the specified key, and the default value is returned. This method is same with the following code except that the operation is performed atomically.

 if (containsAttribute(key)) {
     return getAttribute(key);
 } else {
     setAttribute(key, defaultValue);
     return defaultValue;
 }
 

setAttribute

java.lang.Object setAttribute(IoSession session,
                            java.lang.Object key,
                            java.lang.Object value)

Sets a user-defined attribute.

参数:

session - the session for which we want to set an attribute

key - the key of the attribute

value - the value of the attribute

返回:

The old value of the attribute. null if it is new.

setAttributeIfAbsent

java.lang.Object setAttributeIfAbsent(IoSession session,
                                    java.lang.Object key,
                                    java.lang.Object value)

Sets a user defined attribute if the attribute with the specified key is not set yet. This method is same with the following code except that the operation is performed atomically.

 if (containsAttribute(key)) {
     return getAttribute(key);
 } else {
     return setAttribute(key, value);
 }
 

参数:

session - the session for which we want to set an attribute

key - The key we are looking for

value - The value to inject

返回:

The previous attribute

removeAttribute

java.lang.Object removeAttribute(IoSession session,
                               java.lang.Object key)

Removes a user-defined attribute with the specified key.

参数:

session - the session for which we want to remove an attribute

key - The key we are looking for

返回:

The old value of the attribute. null if not found.

removeAttribute

boolean removeAttribute(IoSession session,
                      java.lang.Object key,
                      java.lang.Object value)

Removes a user defined attribute with the specified key if the current attribute value is equal to the specified value. This method is same with the following code except that the operation is performed atomically.

 if (containsAttribute(key) && getAttribute(key).equals(value)) {
     removeAttribute(key);
     return true;
 } else {
     return false;
 }
 

参数:

session - the session for which we want to remove a value

key - The key we are looking for

value - The value to remove

返回:

true if the value has been removed, false if the key was not found of the value not removed

replaceAttribute

boolean replaceAttribute(IoSession session,
                       java.lang.Object key,
                       java.lang.Object oldValue,
                       java.lang.Object newValue)

Replaces a user defined attribute with the specified key if the value of the attribute is equals to the specified old value. This method is same with the following code except that the operation is performed atomically.

 if (containsAttribute(key) && getAttribute(key).equals(oldValue)) {
     setAttribute(key, newValue);
     return true;
 } else {
     return false;
 }
 

参数:

session - the session for which we want to replace an attribute

key - The key we are looking for

oldValue - The old value to replace

newValue - The new value to set

返回:

true if the value has been replaced, false if the key was not found of the value not replaced

containsAttribute

boolean containsAttribute(IoSession session,
                        java.lang.Object key)

参数:

session - the session for which wa want to check if an attribute is present

key - The key we are looking for

返回:

true if this session contains the attribute with the specified key.

getAttributeKeys

java.util.Set<java.lang.Object> getAttributeKeys(IoSession session)

参数:

session - the session for which we want the set of attributes

返回:

the set of keys of all user-defined attributes.

dispose

void dispose(IoSession session)
             throws java.lang.Exception

Disposes any releases associated with the specified session. This method is invoked on disconnection.

参数:

session - the session to be disposed

抛出:

java.lang.Exception - If the session can't be disposed