Netty 4.1.107.Final · io.netty.util.concurrent.FastThreadLocal

A special variant of ThreadLocal that yields higher access performance when accessed from a FastThreadLocalThread.

Internally, a FastThreadLocal uses a constant index in an array, instead of using hash code and hash table, to look for a variable. Although seemingly very subtle, it yields slight performance advantage over using a hash table, and it is useful when accessed frequently.

To take advantage of this thread-local variable, your thread must be a FastThreadLocalThread or its subtype. By default, all threads created by DefaultThreadFactory are FastThreadLocalThread due to this reason.

Note that the fast path is only possible on threads that extend FastThreadLocalThread, because it requires a special field to store the necessary state. An access by any other kind of thread falls back to a regular ThreadLocal.

Field Summary

Modifier and Type	Field and Description
private final int	index

Constructor Summary

Access	Constructor and Description
public	FastThreadLocal()

Method Summary

Modifier and Type	Method and Description
private static void	addToVariablesToRemove(InternalThreadLocalMap threadLocalMap, FastThreadLocal<?> variable) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated.
public static void	destroy() Destroys the data structure that keeps all `FastThreadLocal` variables accessed from non-`FastThreadLocalThread`s.
public final V	get() Returns the current value for the current thread
public final V	get(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. Returns the current value for the specified thread local map.
public final V	getIfExists() Returns the current value for the current thread if it exists, `null` otherwise.
private V	initialize(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated.
protected V	initialValue() Returns the initial value for this thread-local variable.
public final boolean	isSet() Returns `true` if and only if this thread-local variable is set.
public final boolean	isSet(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. Returns `true` if and only if this thread-local variable is set.
protected void	onRemoval(V value) Invoked when this thread local variable is removed by `remove()`.
public final void	remove() Sets the value to uninitialized for the specified thread local map.
public final void	remove(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. Sets the value to uninitialized for the specified thread local map.
public static void	removeAll() Removes all `FastThreadLocal` variables bound to the current thread.
private static void	removeFromVariablesToRemove(InternalThreadLocalMap threadLocalMap, FastThreadLocal<?> variable) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated.
public final void	set(V value) Set the value for the current thread.
public final void	set(InternalThreadLocalMap threadLocalMap, V value) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. Set the value for the specified thread local map.
private void	setKnownNotUnset(InternalThreadLocalMap threadLocalMap, V value) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated.
public static int	size() Returns the number of thread local variables bound to the current thread.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

index	back to summary
private final int index

Constructor Detail

FastThreadLocal	back to summary
public FastThreadLocal()

Method Detail

addToVariablesToRemove	back to summary
private static void addToVariablesToRemove(InternalThreadLocalMap threadLocalMap, FastThreadLocal<?> variable) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information. Annotations @SuppressWarnings:unchecked

destroy	back to summary
public static void destroy() Destroys the data structure that keeps all `FastThreadLocal` variables accessed from non-`FastThreadLocalThread`s. This operation is useful when you are in a container environment, and you do not want to leave the thread local variables in the threads you do not manage. Call this method when your application is being unloaded from the container.

get	back to summary
public final V get() Returns the current value for the current thread Annotations @SuppressWarnings:unchecked

get

back to summary

public final V get()

Returns the current value for the current thread

Annotations

@SuppressWarnings:unchecked

get back to summary

get	back to summary
public final V get(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information. Returns the current value for the specified thread local map. The specified thread local map must be for the current thread. Annotations @SuppressWarnings:unchecked

public final V get(InternalThreadLocalMap threadLocalMap)

Deprecated

as a consequence of InternalThreadLocalMap being deprecated. See corresponding docs for further information.

Returns the current value for the specified thread local map. The specified thread local map must be for the current thread.

Annotations

@SuppressWarnings:unchecked

getIfExists back to summary

getIfExists	back to summary
public final V getIfExists() Returns the current value for the current thread if it exists, `null` otherwise. Annotations @SuppressWarnings:unchecked

public final V getIfExists()

Returns the current value for the current thread if it exists, null otherwise.

Annotations

@SuppressWarnings:unchecked

initialize	back to summary
private V initialize(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information.

initialValue	back to summary
protected V initialValue() throws Exception Returns the initial value for this thread-local variable.

isSet	back to summary
public final boolean isSet() Returns `true` if and only if this thread-local variable is set.

isSet	back to summary
public final boolean isSet(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information. Returns `true` if and only if this thread-local variable is set. The specified thread local map must be for the current thread.

onRemoval	back to summary
protected void onRemoval(V value) throws Exception Invoked when this thread local variable is removed by `remove()`. Be aware that `remove()` is not guaranteed to be called when the `Thread` completes which means you can not depend on this for cleanup of the resources in the case of `Thread` completion.

remove	back to summary
public final void remove() Sets the value to uninitialized for the specified thread local map. After this, any subsequent call to get() will trigger a new call to initialValue().

remove back to summary

remove	back to summary
public final void remove(InternalThreadLocalMap threadLocalMap) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information. Sets the value to uninitialized for the specified thread local map. After this, any subsequent call to get() will trigger a new call to initialValue(). The specified thread local map must be for the current thread. Annotations @SuppressWarnings:unchecked

public final void remove(InternalThreadLocalMap threadLocalMap)

Deprecated

as a consequence of InternalThreadLocalMap being deprecated. See corresponding docs for further information.

Sets the value to uninitialized for the specified thread local map. After this, any subsequent call to get() will trigger a new call to initialValue(). The specified thread local map must be for the current thread.

Annotations

@SuppressWarnings:unchecked

removeAll	back to summary
public static void removeAll() Removes all `FastThreadLocal` variables bound to the current thread. This operation is useful when you are in a container environment, and you don't want to leave the thread local variables in the threads you do not manage.

removeFromVariablesToRemove	back to summary
private static void removeFromVariablesToRemove(InternalThreadLocalMap threadLocalMap, FastThreadLocal<?> variable) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information.

set	back to summary
public final void set(V value) Set the value for the current thread.

set	back to summary
public final void set(InternalThreadLocalMap threadLocalMap, V value) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information. Set the value for the specified thread local map. The specified thread local map must be for the current thread.

setKnownNotUnset	back to summary
private void setKnownNotUnset(InternalThreadLocalMap threadLocalMap, V value) Deprecated as a consequence of `InternalThreadLocalMap` being deprecated. See corresponding docs for further information. See Also `InternalThreadLocalMap#setIndexedVariable(int, Object).`

size	back to summary
public static int size() Returns the number of thread local variables bound to the current thread.

public Class FastThreadLocal<V>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail