gnu.mapping

Class ThreadLocation<T>

java.lang.Object

gnu.mapping.Location<T>

gnu.mapping.IndirectableLocation<T>

gnu.mapping.NamedLocation<T>

gnu.mapping.ThreadLocation<T>

All Implemented Interfaces:

EnvironmentKey, Named, java.util.Map.Entry<EnvironmentKey,T>

public class ThreadLocation<T>
extends NamedLocation<T>
implements Named

A Location that forwards to a thread-specific Location.

Field Summary

Fields inherited from class gnu.mapping.IndirectableLocation

base, DIRECT_ON_SET, INDIRECT_FLUIDS, value

Fields inherited from class gnu.mapping.Location

UNBOUND

Fields inherited from interface gnu.mapping.EnvironmentKey

FUNCTION

Constructor Summary

Constructors

Constructor and Description
ThreadLocation() A new anonymous fluid location.
ThreadLocation(java.lang.String name) A new anonymous fluid location but used a given name for printing.
ThreadLocation(Symbol name)
ThreadLocation(Symbol name, java.lang.ThreadLocal<T> thLocal)

Method Summary

Modifier and Type	Method and Description
T	get() Get the current value of this location.
T	get(T defaultValue)
java.lang.String	getName()
java.lang.Object	getSymbol()
boolean	isBound()
static ThreadLocation	makeAnonymous(java.lang.String name) Create a fresh ThreadLocation, independent of other ThreadLocations.
static ThreadLocation	makeAnonymous(Symbol name) Create a fresh ThreadLocation, independent of other ThreadLocations.
void	set(T value)
void	setGlobal(T value) Set the default/global value.
void	setName(java.lang.String name)
void	setRestore(java.lang.Object oldValue) Restore an old value.
java.lang.Object	setWithSave(T newValue) Set a value, but return cookie so old value can be restored.
void	undefine()

Methods inherited from class gnu.mapping.NamedLocation

entered, equals, getEnvironment, getKey, getKeyProperty, getKeySymbol, hashCode, matches, matches

Methods inherited from class gnu.mapping.IndirectableLocation

getBase, getBaseForce, isConstant, setAlias, setBase

Methods inherited from class gnu.mapping.Location

define, getValue, make, make, make, print, setValue, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map.Entry

comparingByKey, comparingByKey, comparingByValue, comparingByValue, getValue, setValue

Constructor Detail

ThreadLocation

public ThreadLocation()

A new anonymous fluid location.

ThreadLocation

public ThreadLocation(java.lang.String name)

A new anonymous fluid location but used a given name for printing. However, the binding is not bound to the name as a visible binding.

ThreadLocation

public ThreadLocation(Symbol name)

ThreadLocation

public ThreadLocation(Symbol name,
                      java.lang.ThreadLocal<T> thLocal)

Method Detail

makeAnonymous

public static ThreadLocation makeAnonymous(java.lang.String name)

Create a fresh ThreadLocation, independent of other ThreadLocations.

Parameters:

name - used for printing, but not identification.

makeAnonymous

public static ThreadLocation makeAnonymous(Symbol name)

Create a fresh ThreadLocation, independent of other ThreadLocations.

Parameters:

name - used for printing, but not identification.

setGlobal

public void setGlobal(T value)

Set the default/global value.

get

public T get()

Description copied from class: Location

Get the current value of this location.

Specified by:

get in class Location<T>

get

public T get(T defaultValue)

Overrides:

get in class Location<T>

isBound

public boolean isBound()

Specified by:

isBound in class Location<T>

set

public void set(T value)

Specified by:

set in class Location<T>

setWithSave

public java.lang.Object setWithSave(T newValue)

Description copied from class: Location

Set a value, but return cookie so old value can be restored. This is intended for fluid-let where (in the case of multiple threads) a simple save-restore isn't always the right thing.

Overrides:

setWithSave in class NamedLocation<T>

setRestore

public void setRestore(java.lang.Object oldValue)

Description copied from class: Location

Restore an old value.

Overrides:

setRestore in class NamedLocation<T>

Parameters:

oldValue - the return value from a prior setWithSave.

undefine

public void undefine()

Overrides:

undefine in class IndirectableLocation<T>

getName

public java.lang.String getName()

Specified by:

getName in interface Named

getSymbol

public java.lang.Object getSymbol()

Specified by:

getSymbol in interface Named

setName

public void setName(java.lang.String name)

Specified by:

setName in interface Named