org.jboss.netty.channel

类 ChannelLocal<T>

java.lang.Object

org.jboss.netty.channel.ChannelLocal<T>

所有已实现的接口:

java.lang.Iterable<java.util.Map.Entry<Channel,T>>

public class ChannelLocal<T>
extends java.lang.Object
implements java.lang.Iterable<java.util.Map.Entry<Channel,T>>

A global variable that is local to a Channel. Think of this as a variation of ThreadLocal whose key is a Channel rather than a Thread.currentThread(). One difference is that you always have to specify the Channel to access the variable.

Alternatively, you might want to use the ChannelHandlerContext.attachment property, which performs better.

构造器概要

构造器

构造器和说明
ChannelLocal() Creates a Channel local variable by calling ChannelLocal(boolean) with false as parameter
ChannelLocal(boolean removeOnClose) Creates a Channel local variable.

方法概要

方法

限定符和类型	方法和说明
T	get(Channel channel) Returns the value of this variable.
protected T	initialValue(Channel channel) Returns the initial value of the variable.
java.util.Iterator<java.util.Map.Entry<Channel,T>>	iterator() Returns a read-only Iterator that holds all Map.Entry's of this ChannelLocal
T	remove(Channel channel) Removes the variable and returns the removed value.
T	set(Channel channel, T value) Sets the value of this variable.
T	setIfAbsent(Channel channel, T value) Sets the value of this variable only when no value was set.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ChannelLocal

public ChannelLocal()

Creates a Channel local variable by calling ChannelLocal(boolean) with false as parameter

ChannelLocal

public ChannelLocal(boolean removeOnClose)

Creates a Channel local variable.

参数:

removeOnClose - if true the ChannelLocal will remove a Channel from it own once the Channel was closed.

方法详细资料

initialValue

protected T initialValue(Channel channel)

Returns the initial value of the variable. By default, it returns null. Override it to change the initial value.

参数:

channel - the channel where this local variable is accessed with

get

public T get(Channel channel)

Returns the value of this variable.

set

public T set(Channel channel,
    T value)

Sets the value of this variable.

返回:

the old value. null if there was no old value.

setIfAbsent

public T setIfAbsent(Channel channel,
            T value)

Sets the value of this variable only when no value was set.

返回:

null if the specified value was set. An existing value if failed to set.

remove

public T remove(Channel channel)

Removes the variable and returns the removed value. If no value was set, this method returns the return value of initialValue(Channel), which is null by default.

返回:

the removed value. an initial value (by default null) if no value was set.

iterator

public java.util.Iterator<java.util.Map.Entry<Channel,T>> iterator()

Returns a read-only Iterator that holds all Map.Entry's of this ChannelLocal

指定者:

iterator 在接口中 java.lang.Iterable<java.util.Map.Entry<Channel,T>>